RegisterIBANExtended : Link a non-SEPA IBAN to a payment account

Version

Description

1.1

The IBAN ID is returned in the response. It is possible to add many IBANs per payment account.

How it works

With "RegisterIBANExtended" method, our system links an IBAN outside of the geographical SEPA area to a Payment Account. A Wallet can live without an IBAN. An IBAN is needed to do a MONEY-OUT. No IBAN is needed to perform a wallet to wallet payment. No IBAN is needed to make a MONEY-IN on a Payment Account.

  • Please only use this for IBANs outside of the geographical SEPA area.
  • Depending on your business, the IBAN will be automatically active or not, after you have called this functionality. If it is not automatically active, our control team will have to validate it before you can use it for a money-out.
  • By default, you can only register one IBAN per payment account, when you link a new IBAN all previous IBANs linked to the same wallet will be automatically deactivated. If you wish to link several IBANs to one payment account please contact us for approval.

Request

<RegisterIBANExtended xmlns="Service_mb">
    <wlLogin>string</wlLogin>
    <wlPass>string</wlPass>
    <language>string</language>
    <version>string</version>
    <walletIp>string</walletIp>
    <walletUa>string</walletUa>
    <wallet>string</wallet>
    <accountType>int</accountType>
    <holderName>string</holderName>
    <accountNumber>string</accountNumber>
    <holderCountry>string</holderCountry>
    <bicCode>string</bicCode>
    <bankName>string</bankName>
    <bankCountry>string</bankCountry>
    <intermediaryBicCode>string</intermediaryBicCode>
    <intermediaryBankName>string</intermediaryBankName>
    <intermediaryBankCountry>string</intermediaryBankCountry>
</RegisterIBANExtended>

  
    "wlLogin":"string",
    "wlPass":"string",
    "language":"string",
    "version":"string",
    "walletIp":"string",
    "walletUa":"string",
    "wallet":"string",
    "accountType":"string",
    "holderName":"string",
    "accountNumber":"string",
    "holderCountry":"string",
    "bicCode":"string",
    "bankName":"string",
    "bankCountry":"string",
    "intermediaryBicCode":"string",
    "intermediaryBankName":"string",
    "intermediaryBankCountry":"string"

}

Item

Description

Mandatory

Format

Example

wallet

Wallet ID

 

[0 : 256] char

33612345678 ou taxi67

accountTypeIBAN = 1, BBAN/RIB = 2, Other = 0Yes1 char1

holderName

IBAN holder

Yes

[0 :35] char

Jean Dupont

accountNumber

Account number. Its format depends onthe accountType

Yes

[0 : 34] char

FR1420041010050500013M02606

holderCountry2 chars ISO country code

Yes

2 chars

US

bicCode

BIC/SWIFT code.

If not empty, it will be used to identify the beneficiary bank. This is the best way to identify the bank.

No

[0 : 11] char

0002029205
 

bankName

Name of the Bank (and the address). Only use this if you don't have the BIC/SWIFT code.

If both this and BIC/SWIFT code are filled, the BIC/SWIFT code will be used unless something is wrong with it.

If you don't know the BIC/SWIFT code of the bank, you can try to give the bank ID. The bank ID format will be as follow :

  • AU + 6c num (Australia)
  • CC + 9c num (Canada)
  • CH + 6c num (CHIPS USA)
  • CP + 4c num (CHIPS USA)
  • FW + 9c num (code ABA Fedwire USA)
  • HK + 3c num (Hong Kong)
  • IN +11c alpha-num (India)
  • NZ + 6c num (New Zeland)

Depends

[0 :140] char

CHBFSFCU

bankCountry

2 chars ISO country code

Yes

2 chars

US

intermediaryBicCode

BIC/SWIFT code of the intermediary bank, if there is an intermediary bank.

No

[0 : 11] char

IRVTDEFX

intermediaryBankName

Name of intermediary bank. Only fill this if BIC/SWIFT code of the intermediary bank is empty.

No[0 :140] charBank OF NEW YORK MELLON
intermediaryBankCountry2 chars ISO country codeNo2 charsDE

Response

<IBAN>
	<S>5</S>
	<ID>11</ID><!-- since version 1.1--> 
</IBAN> 
{  
    "IBAN":{  
        "S":"5",
        "ID":"11"<!-- since version 1.1-->
    }
}

Version

Item

Description

Example

>= 1.1

ID

IBAN ID

253

>= 1.0

S

IBAN status

5