RegisterIbanExtended

How it works

To send money-outs from the Lemonway payment account to the bank of your clients, you need to register their bank details. With the RegisterIbanExtended method, our system links other bank formats to a Payment Account.

• Bank details are only needed for Money-Outs, not for Money-Ins or P2P.

• If the format of the bank details is an IBAN, we suggest you use the other API method Add a Bank Account (IBAN format) to a Payment Account for Money-Outs which requires much fewer mandatory fields.

• Depending on your business, the account information 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 Disable a Bank Account (IBAN or another format) from a Payment Account
  method to deactivate a bank account from a payment. If you wish to enforce only one bank account per payment account at the time, please contact Support.

📘

Nice to know!

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

• bankBranchCode (or sort code for the UK)
• bankName
• bankBranchAddressStreet
• bankBranchAddressZipCode
• bankCity

Download our zipped .xlsx file that list of country codes and associated mandatory fields

XML

<RegisterIBANExtended xmlns="Service_mb_xml">
      <wallet>string</wallet>
      <accountType>string</accountType>
      <holderName>string</holderName>
      <accountNumber>string</accountNumber>
      <holderCountry>string</holderCountry>
      <bicCode>string</bicCode>
      <bankName>string</bankName>
      <bankCountry>string</bankCountry>
      <bankBranchCode>string</bankBranchCode>
      <bankBranchAddressStreet>string</bankBranchAddressStreet>
      <bankBranchAddressZipCode>string</bankBranchAddressZipCode>
      <bankBranchAddressCity>string</bankBranchAddressCity>
      <intermediaryBicCode>string</intermediaryBicCode>
      <intermediaryBankName>string</intermediaryBankName>
      <intermediaryBankCountry>string</intermediaryBankCountry>
      <comment>string</comment>
      <wlLogin>string</wlLogin>
      <wlPass>string</wlPass>
      <language>string</language>
      <version>string</version>
      <walletIp>string</walletIp>
      <walletUa>string</walletUa>
   </RegisterIBANExtended>

<IBAN>
    <S>5</S>
    <ID>11</ID><!-- since version 1.1--> 
</IBAN>

JSON

{
    "wallet": "string",
    "accountType": "string",
    "holderName": "string",
    "accountNumber": "string",
    "holderCountry": "string",
    "bicCode": "string",
    "bankName": "string",
    "bankCountry": "string",
    "bankBranchCode": "string",
    "bankBranchAddressStreet": "string",
    "bankBranchAddressZipCode": "string",
    "bankBranchAddressCity": "string",
    "intermediaryBicCode": "string",
    "intermediaryBankName": "string",
    "intermediaryBankCountry": "string",
    "comment": "string",
    "wlLogin": "string",
    "wlPass": "string",
    "language": "string",
    "version": "string",
    "walletIp": "string",
    "walletUa": "string"
  }

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

Request Input Description

Please find below the list of the error messages. If the mandatory fields are not completed, you will get an error message with the fields missing.

• Invalid country code: ERR_FORMAT_COUNTRY
• The selected bank country code requires an IBAN: ERR_MISSING_MANDATORY_IBAN
• Missing BIC: ERR_BIC_MISSING
• Missing bank name: ERR_EMPTY_MANDATORY_BANK_NAME
• Missing bank address information (street, zipcode, or city): ERR_EMPTY_MANDATORY_BANK_BRANCH_ADDRESS
  Missing bank branch code: RR_EMPTY_MANDATORY_BANK_BRANCH_ROUTING_CODE

Examples:

• USD environments - Select “RegisterIBANExtended” and complete all bank info (name, address, bank branch code)

• Morocco - Morocco is part of the “transition IBAN countries”. That means some users have an IBAN format for bank details and an account number. For IBANs, please use “RegisterIBAN” and for other bank details please use “RegisterIBANExtended”.

• Domestic GBP payments (GBP environments and bank country GB)
  For IBANs, please use “RegisterIBAN” and for other bank details please use “RegisterIBANExtended” and complete the account number and bank branch code/sort code.