v1

latestOpenAPI 3.0.02026-07-2691259477.2 KB

MoneyOuts

Add Bank Account to a Payment Account for Money-Outs

You are required to register your client's bank account details in order to send Money-Out from a Lemonway payment account.
With this method, our system links other bank formats to a payment account.

Important: If your client bank account details are in IBAN format this call.

Client bank account details are only required for money-outs.
When you link a new bank account (IBAN format or other ones), the previous ones are still active.
Please use IbanUnregisterPut method to deactivate a bank account from a payment account.
If you wish to use only one bank account per payment account, please contact support.

Depending on bank country code selected or when a USD environment is concerned, 3 fields may be required:

bankBranchRoutingCode
bankName
bankBranchAddress

post/v2/moneyouts/iban/extended

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

walletstring

Payment Account ID

accountType0 | 1 | 2

Account Type, by default Other 0 = Other. 1 = IBAN. 2 = BBAN/RIB.

holderNamestring

The registered bank account owner: First and Last name, or Company Name

accountNumberstring

Account Number. The format depends on the account type.

holderCountrystring

Country of the beneficiary. Two-letter country code (ISO alpha-2) for example, France=FR

bicCodestring

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

bankNamestring

Bank Name. This field is mandatory in the following circumstances:

<ul><li>If the currency is USD</li><li>If the selected bank country code requires this field</li></ul>

bankCountrystring

Country of the Bank. Two-letter country code (ISO alpha-2) for example, France=FR

bankBranchCodestring

Bank Branch Code (Sort Code in the United Kingdom). It is mandatory for the examples below:

<ul><li>If the selected bank country code requires this field.</li></ul>

intermediaryBicCodestring

BIC/SWIFT Code of the Intermediary Bank.

intermediaryBankNamestring

Intermediary Bank Name

intermediaryBankCountrystring

Bank Country Code of the Intermediary Bank. Two-letter country code (ISO alpha-2) for example, France=FR

commentstring

Reason for new Bank Account details if another one is already linked to the Payment Account.

Example request

{
  "wallet": "33612345678",
  "accountType": 1,
  "holderName": "Jean Dupont",
  "accountNumber": "FR1420041010050500013M02606",
  "holderCountry": "US",
  "bicCode": "0002029205",
  "bankName": "CHBFSFCU",
  "bankCountry": "US",
  "intermediaryBicCode": "IRVTDEFX",
  "intermediaryBankName": "Bank OF NEW YORK MELLON",
  "intermediaryBankCountry": "DE",
  "comment": "Previous bank account closed"
}

Response

ibanIdinteger

IBAN ID

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

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