How does it work?
-
Call
POST /v2/moneyins/paybybank/transfer/initto receive:- A redirect URL
- The transaction ID
-
Redirect the end user to the bank-selection page, where they can select their bank from the displayed list.
Note: If you include the
bankIdin the request body, the end user is redirected directly to their bank.To retrieve the available bank IDs, call:
GET /v2/moneyins/paybybank/transfer/banks -
After selecting their bank, the end user is redirected to the bank's website or application to enter their credentials.
Note: If the
bankIdwas included in the initial request, the end user does not need to select their bank and can proceed directly to authentication. -
The end user completes Strong Customer Authentication (SCA) to confirm their identity.
Authentication methods may include:
- Facial recognition
- Fingerprint recognition
- Confirmation through the bank's mobile application
- A one-time password
Depending on the bank, SCA may be requested before or after the end user enters their credentials.
-
Once authenticated, the end user reviews and confirms the payment details, including the amount and payment reference, on the bank's website or application.
-
After the payment is submitted, the end user is redirected to one of the following URLs:
returnUrlif the payment is successfully submittedcancelUrlif the end user cancels the paymenterrorUrlif an error occurs
Important: The
returnUrl,cancelUrl, anderrorUrlmust be publicly accessible to both the end user's browser and Lemonway's WebKit servers.
401Unauthorized
500InternalServerError

