Finalize Pay by Bank 🆕

Depending on the payment status, Lemonway will redirect your clients to the URLs (return, error or cancel) you specify in the Initiate Pay by Bank call.

Example:

{
      "returnUrl": "https://www.yoursite.com/success.php",
      "errorUrl": "https://www.yoursite.com/oops.php",
      "cancelUrl": "https://www.yoursite.com/seeYouNextTime.php",
      "totalAmount": 1500,
      "accountId": "33612345678",
      "commissionAmount": 100,
      "countryCode": "FR",
      "comment": "Order number 2457765AX2",
      "autoCommission": false,
      "bankId": "fr-bnpparibas-ob"
    }

You will get the following information:

  • a redirect URL on your callback URLs (either return, error or cancel depending on the payment status), with the response_wkToken (which is the reference you indicated in the POST Pay By Bank request)

  • a POST notification on your callback URLs (which are the same than the redirect URLs, return, error or cancel depending on the payment status).

📘

Payment Information

If you require further information about a payment (including bank decline reasons), call:

GET/v2/moneyins or GetMoneyIn.

🚧

Redirect URLs

Ensure your redirect URLs are publically available so we can correctly send you all notifications.

The following table displays parameters, descriptions and possible values you will receive with the POST notification:

Parameters

Descriptions

Possible Values

response_code

Payment status

0000: Success
3000: Error

response_wkToken

The reference field you complete when initializing the Money-in

response_msg

Error Message

response_transactionId

Lemonway transaction ID

response_transactionAmount

Payment transaction amount

response_transactionMessage

Comment you made in the Money-in request

📘

Note

If your client's Pay By Bank transfer is authorized, they will be redirected on your return URL. Lemonway usually receives the funds a few days after the initial transaction. When the funds are received, the beneficiary's wallet is credited. The transaction is then switch to success.

To be notified about a wallet credit, configure a Webhook in the Dashboard MoneyIn: by wire received (id: 10)

📘

Transfer Comment

Your client will receive a transfer comment in the following format, creditingreference.EnvironmentName.PartnerComment . The comment is truncated to 40 characters due to bank restrictions. The crediting reference, replaces the previously used matching code for example s125t1 > solutionid = 125 and transactionid = 1, so we can credit the right wallet.


Did this page help you?