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.


      "returnUrl": "",
      "errorUrl": "",
      "cancelUrl": "",
      "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:



Possible Values


Payment status

0000: Success
3000: Error


The reference field you complete when initializing the Money-in


Error Message


Lemonway transaction ID


Payment transaction amount


Comment you made in the Money-in request



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.