Sign in

v1

latestOpenAPI 3.0.02026-07-2691259477.2 KB
MoneyOuts

Add an IBAN to a Payment Account for Money-Outs

To send Money-Out from the Lemonway payment account to the bank account of your Clients, you need to register their bank account details. This method lets our system to link an IBAN to a payment account.

  • Bank account details are only needed for Money-Outs, not for Money-Ins or P2P.
  • When you link a new bank account (IBAN format or other ones), the previous details are still active.
  • Use IbanUnregisterPut call to deactivate a bank account from a payment account.
  • If you wish to use only one bank account per payment account, please contact support.
  • An integrated algorithm will validate your IBAN.
post/v2/moneyouts/iban

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

accountIdstring required

Payment Account ID

holderstring

Registered Bank Account Owner: First and Last name, or Company Name

bicstring

BIC/SWIFT Codes are arranged like this : AAAABBCCDDD AAAA : 4 char for bank code BB : 2 char for country code CC : 2 char for location code DDD : 3 char for branch code

ibanstring

IBAN

domiciliation1string

Bank Address Line 1

domiciliation2string

Bank Address Line 2

commentstring

Reason for new IBAN if another IBAN is already linked to the Payment Account

Example request

{
  "accountId": "33612345678",
  "holder": "Jean Dupont",
  "bic": "ABCDEFGHIJK",
  "iban": "FR1420041010050500013M02606",
  "domiciliation1": "SOMEBANK MONTREUIL",
  "domiciliation2": "56 rue de Lays",
  "comment": "Previous bank account closed"
}

Response

OK

ibanIdinteger

IBAN ID

status1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9

IBAN Status<br/>1 = None.<br/>2 = Internal.<br/>3 = Not used.<br/>4 = Waiting to be verified by Lemon Way.<br/>5 = Activated.<br/>6 = Rejected by the bank.<br/>7 = Rejected, no owner.<br/>8 = Deactivated.<br/>9 = Rejected.<br/>