Lemonway changelog
Lemonway changelog

Payments using a Registered Card


API Method Update



As reminder, Strong Customer Authentication is now mandatory for all Client initiated Payments.

To let your clients pay using a Registered Card, you need to follow 3 steps:

  1. Request to register the card during a first payment initiation. The end-user has to authenticate himself strongly through 3DS v2 process. Lemonway returns a Card Id

  2. Make sure the Card has been well registered for future Client Payments by calling a new GET API call using the returned Card Id. Please note that the end-user needs to give his consent to register his card details and the first transaction has to be successful.

  3. Initiate a new Payment with the Registered Card using the Card Id. The final user authenticates on 3DSv2 page, except if the Issuing Bank accepts to deactivate SCA (this payment will then be frictionless).

API documentation : SOAP v1 - REST v2

MoneyInWebInit - POST/v2/moneyins/card/webinit

MoneyIn3DInit - POST/v2/moneyins/card/direct/3dinit

MoneyInGetCard - GET/v2/moneyins/card/{cardId}

client payment on a registered card.jpg

Error Messages Explained





PSP Error messages were only displayed on the Operations > IN/OUT page and explained in the Operations detail page.

NOW available in Operations > All and Account Details > Operations.

You can now mouse over the message and get more information without going to the Operation's detail. All the SEPA errors are now mapped.

error message.png

Blocking Reasons Column Displayed on Accounts Page





The Accounts Blocking Reasons are now displayed on the Accounts page.

Blocking reasons can be filtered (see image)

blocking reasons column.png

Total Number of Items for all Tables





You can now view the total number of accounts, transactions, or any item you want.

image (136).png

When you add a filter, you can view the total filtered items and the total without filter at the same time.

image (137).png

Date Selection Improvement





The date selection experience has been improved!

For all transaction tables, there is a new filter for Dates. It is displayed at the top of the table, the filter default is set to the last 7 days.

Shortcut ranges have been added to help do a quick search, for example Yesterday, Last 4 weeks, This month.

image (135).png

Improve your number of Frictionless Payments


API Method Update



Since April, we have been sharing with you the 3DS v2 Result :

  • Challenge : 3DS v2 authentication page was activated and the cardholder was requested to be strongly authenticated
  • Frictionless : 3DS v2 was deactivated

You NOW have the possibility to give us more information about the payers (as examples: name, email, delivery address & billing address) to get a better risk score on the transactions and expect more frictionless payments.

Functional documentation in the API doc : Click here

API call documentations : SOAP v1 - REST v2

MoneyInWebInit - POST/v2/moneyins/card/webinit

MoneyIn3DInit - POST/v2/moneyins/card/direct/3dinit

3DS v2 : Frictionless Payments


API Method Update



With PSD2, in order to reduce frauds and chargebacks, SCA (Strong Customer Authentication) becomes mandatory for all new card transactions. Cardholders will have to go through 3DS authentication to confirm payments.

The good news is that after risk assessment, banks can decide to skip the 3DS process to allow frictionless payment, improving the customer experience and the success rate of transactions.

NEW: We now share the status of 3DS v2 Authentication, when available, on the dashboard and through the API.

3DS MODE REQUESTED: "NO PREFERENCE" by default, means the Issuing Bank can decide to activate or not activate 3DS v2

3DS RESULT: "CHALLENGE" means 3DS v2 was activated and the cardholder was asked to be strongly authenticated or "FRICTIONLESS" means 3DS v2 was not activated.

Dashboard 3DSResult.png

API documentation

Api REST: GET/v2/moneyins

Api SOAP: GetMoneyInTransDetails

Guidelines on Card Payments to avoid soft declines are available in the:



Account Balance in Account Details > Operations





The balance of an account after each transaction is visible in a new column.

This column is available in the Operations page for each account, including the SC account.

image (130).png

Cancel pending Direct Debit and Cheque transaction





Cancelling a pending incoming Direct Debit or Cheque Operation is now available in the new Dashboard.

How? Select a pending Direct debit or Cheque transaction, go to the operation details and click Cancel operation.

You need to have these permissions:

  • Cancel Direct Debit incoming operation in order to cancel a pending SDD operation

  • Cancel incoming operation by check in order to cancel a pending Cheque operation

These permissions are already given by default to MB-ADMIN roles.


PSD2 and Card Payments





We have recently updated our APIv1 and API v2 documentation with a section that concerns PSD2 and Card Payments.

Lemonway wants to ensure that card payments are processed smoothly with no declines, we've outlined some recommendations and best practices to help you during the 3D Secure transition period.

API v1 - PSD2 and Card Payments

API v2 - PSD2 and Card Payments