How does it work?
- Call POST v2/moneyins/paybybank/transfer/init, to receive a redirect URL and the transaction Id.
- Redirect the end-user to your bank selection page, were they can select their bank from the displayed list.
Note: If you specify the bankId in the request body, the end-user will be directed to their bank.
For further information on how to obtain bankIds, see: /v2/moneyins/ paybybank/transfer/banks - Once the end-user selects their bank they are redirected to the bank webpage to enter their credentials.
- After successfully entering their credentials, the end-user will go through Strong Customer Authentication (SCA) to confirm their identity (SCA examples include: face recognition or mobile Bank App software). Some bank ask to SCA before entering credentials.
- Once successfully authenticated the end-user only needs to verify and validate the amount, comments and so forth on the bank website.
- After submitting the payment, the end-user will be redirected to:
- returnUrl in case of success
- cancelUrl in case of cancellation
- errorUrl in case of error.
These 3 URLs must be publicly accessible for the end-user. It must also be accessible to our WebKit server to send requests to the end-user.
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.
Unauthorized
InternalServerError