RegisterIBAN: Add a Bank Account (IBAN format) to a Payment Account for Money-outs
Version | Description |
|---|---|
1.1 | The IBAN ID is returned in the answer. It is possible to add many IBANs per Payment Account |
1.0 | Two fields become optional |
How it works
To send money-outs from the Lemonway payment account to the bank account of your clients, you need to register their bank account details. With RegisterIBAN the method, our system links an IBAN to a Payment Account.
Bank details are only needed for money-outs, not for money-ins or P2P
Depending on your business, the IBAN may be automatically activated. If it is not, our control team needs to validate it with the uploaded bank document.
By default, you can register multiple Bank Accounts per payment account. When you link a new Bank Account (IBAN format or other ones), the previous ones are still active. Please use UnregisterIBAN method to deactivate a bank account from a payment account. If you wish to enforce only one bank account per payment account, please contact Support
An integrated algorithm will validate your IBAN
This API call can be used to add all IBANs of all countries. Only three mandatory fields :
Wallet
Holder
IBAN
Request
XML
<RegisterIBAN xmlns="Service_mb">
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<wallet>string</wallet>
<holder>string</holder>
<bic>string</bic>
<iban>string</iban>
<dom1>string</dom1>
<dom2>string</dom2>
<comment>string</comment>
<ignoreFormat>string</ignoreFormat>
</RegisterIBAN>
JSON
{
"wlLogin":"string",
"wlPass":"string",
"language":"string",
"version":"string",
"walletIp":"string",
"walletUa":"string",
"wallet":"string",
"holder":"string",
"bic":"string",
"iban":"string",
"dom1":"string",
"dom2":"string",
"comment":"string"
"ignoreFormat":"string"
}
Item | Description | Mandatory | Format | Example |
|---|---|---|---|---|
wallet | Payment account ID | Yes | [0 : 256] char | 33612345678 ou taxi67 |
holder | The owner of the registered bank account: first name and last name, or company name | Yes | [0 : 256] char | Jean Dupont |
bic | BIC/SWIFT codes are arranged like this : AAAABBCCDDD AAAA: 4 char for bank code | No | [8;11] char | ABCDEFGHIJK |
iban | IBAN. | Yes | [15 : 34] char | FR1420041010050500013M02606 |
dom1 | Bank address Line 1 | No | [1 :256] char | SOMEBANK MONTREUIL |
dom2 | Bank address Line 2 | No | [1 :256] char | 56 rue de Lays |
comment | Reason for new IBAN if another IBAN is already linked to the wallet | No | [1 :512] char | Previous bank account closed |
Answer
Here is an example of the answer you will get after registering an IBAN. In that case, the status of the IBAN is active and the IBAN id 11.
XML
<IBAN>
<S>5</S>
<ID>11</ID><!--since version 1.1-->
</IBAN>
JSON
{
"IBAN_REGISTER":{
"S":"5",
"ID":"11"
}
}