MoneyIns | Pay by Bank
Initiate Pay by Bank
<b>How does it work?</b> <br />
<p></p> 1. Call POST v2/moneyins/paybybank/transfer/init, to receive a redirect URL and the transaction Id. <br /><p></p> 2. Redirect the end-user to your bank selection page, were they can select their bank from the displayed list. <br /><p></p><b>Note:</b> If you specify the bankId in the request body, the end-user will be directed to their bank. <br /> 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. <p></p><b>Note:</b> If you have previously specified the bankId the end-user only needs to enter their bank credentials at this stage. <br /><p></p> 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.<br /><p></p> 5. Once successfully authenticated the end-user only needs to verify and validate the amount, comments and so forth on the bank website. <p></p> 6. After submitting the payment, the end-user will be redirected to: <ul><li>returnUrl in case of success</li><li>cancelUrl in case of cancellation</li><li>errorUrl in case of error.</li></ul> 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.post/v2/moneyins/paybybank/transfer/init
Request
- Base URLhttps://ws.lemonway.fr/mb/env-name/prod/directkitrest
- URLhttps://ws.lemonway.fr/mb/env-name/prod/directkitrest/v2/moneyins/paybybank/transfer/init
- Authnone declared. Required headers: Authorization, PSU-IP-Address
Headers
Authorizationstring required
Authorization bearer (OAuth 2)
PSU-Accept-Languagestring
Response language accepted by final client (PSU). English by default
PSU-IP-Addressstring required
IP address of the final client (PSU).
PSU-User-Agentstring
User-agent of the final client (PSU).
Request body
Example request
{
"returnUrl": "https://fr.wikipedia.org/wiki/OK",
"cancelUrl": "https://fr.wikipedia.org/wiki/Cancel",
"errorUrl": "https://fr.wikipedia.org/wiki/Error",
"countryCode": "FR",
"bankId": "the-bank-id",
"transferType": 2,
"reference": "Dze8778",
"accountId": "1234",
"totalAmount": 10000,
"commissionAmount": 100,
"comment": "Comment the transaction request",
"autoCommission": false
}Response
OK
Changes
No recorded changes to this operation across all 1 revision of this API.