Initiate Pay by Bank

How does it work?

1. Call POST v2/moneyins/paybybank/transfer/init, to receive a redirect URL and the transaction Id.

2. 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 3. Once the end-user selects their bank they are redirected to the bank webpage to enter their credentials.

Note: If you have previously specified the bankId the end-user only needs to enter their bank credentials at this stage.

4. 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.

5. Once successfully authenticated the end-user only needs to verify and validate the amount, comments and so forth on the bank website.

6. 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.
Body Params
string
required

returnUrl in case of success

string
required

cancelUrl in case of cancellation

string
required

errorUrl in case of error

string
required

The country code associated with the payment bank. ISO Alpha-2 codes accepted: (FR) France, (ES) Spain, (IT) Italy, (DE) Germany, and (PT) Portugal

string

If you use the bankId in the call, the end-user will be redirected to their bank. They will not have to select a bank from a list provided. To get a comprehensive list of bankIds call the GET v2/moneyins/paybybank/transfer/banks specifying the ISO Alpha-2 Country Code for example FR for France.

int32
enum

The type of bank transfer, this field is optional. If not provided, the default value is 'Classic'. The 'TransferType' can be set to two different values:

  • 'Classic': Represents a classic bank transfer with a processing time.
    0 = Undefined.
    1 = Instant.
    2 = Classic.
Allowed:
string
length between 0 and 50

Unique ID of the call, generated by your server. This ID can be used as a search field when looking for operation details

string
required
length between 0 and 256

Payment Account ID to Credit

int32

Amount to Debit Amounts are given as integer numbers in cents

int32

Your Fee Amounts are given as integer numbers in cents

string
length between 0 and 140

Comment Regarding the Transaction

boolean

If true:

  1. [amountCom] will be ignored and will be replaced with Lemonway's fee
  2. You will not receive any fee
Headers
string
required

Authorization bearer (OAuth 2)

string

Response language accepted by final client (PSU). English by default

string
required

IP address of the final client (PSU).

string

User-agent of the final client (PSU).

Responses

401

Unauthorized

500

InternalServerError

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json