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" 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 active. 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>
  <ignoreIbanFormat>string</ignoreIbanFormat>
</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"
    "ignoreIbanFormat":"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
BB : 2 char for country code
CC : 2 char for location code
DDD : 3 char for branch 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"
    }
}