RegisterIBAN: Link an IBAN (SEPA area) to a payment account

Version

Description

1.1

The IBAN ID is returned in the answer. It is possible to add many IBANs per Payment Account.

How it works

With "RegisterIBAN" method, our system links an IBAN to a Payment Account. A Payment Account can live without an IBAN. An IBAN is needed to do a MONEY-OUT. No IBAN is needed to perform an ON-US payment. No IBAN is needed to make a MONEY-IN on a Payment Account.

  • Please use this for IBANs on the geographical SEPA zone only.
  • 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 payment account will be automatically deactivated. If you wish to link several IBANs to one wallet please contact us for approval.

Request

<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>

  
    "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

Wallet ID

Yes

[0 : 256] char

33612345678 ou taxi67

holder

IBAN owner: first name and last name, or enterprize name

Yes

[1 :100] char

Jean Dupont

bic

BIC/SWIFT code. Not mandatory.
The correct format is : [6 letters] + [2 numbers or letters] + [0 or 3 numbers or letters]

No

[8;11] char

ABCDEFGHIJK

iban

IBAN.
You can check the IBAN's format by using this algorithm. Our system will use it too.

Yes

[15 : 34] char

FR1420041010050500013M02606

dom1

First line of domiciliation.
Generally, the name of the bank branch.
Can be left empty if the IBAN is from France or Monaco (starts with FR or MC)

Depends

[1 :26] char

SOMEBANK MONTREUIL

dom2

Second line of domiciliation.
Generally, the street of the bank branch.
Can be left empty if the IBAN is from France or Monaco (starts with FR or MC)

Depends

[1 :26] 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

ignoreIbanFormat

Do not use this field (let it always be 0) otherwise the service will refuse IBAN Sepa

No[0 :1] char0

Answer

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

Version

Item

Description

Example

>= 1.1

ID

IBAN ID

253

>= 1.0

S

IBAN Status

5