Add a Bank Account (all formats) to a Payment Account for Money-Outs

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

ItemDescriptionMandatoryFormatExample
walletPayment account IDYes[0: 256] char33612345678 ou taxi67
accountTypeAccount type, by default Other.No1 char0
IBAN = 1,
BBAN/RIB = 2,
Other = 0
holderNameThe owner of the registered bank account: first name and last name, or company name.Yes[0:256] charJean Dupont
accountNumberAccount number. Its format depends on the account type.Yes[0: 34] char14200410100
We encourage you to use the API method RegisterIBAN to add an IBAN. The BBAN corresponds to the second part of the IBAN - after the country code and two digits.
holderCountryCountry of the beneficiary. 2 chars ISO country code.No2 charUS
bicCodeIf the accountType = 0 or null, the BIC is mandatory.Yes[8 : 11] charABCDEFGHIJK
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 (optional)
bankNameName of the bank. It is mandatory for the examples below :Depends[0 :140] charBANK OF AMERICA
If the currency of the partner’s environment is USD.
If the selected bank country code requires this field (please check “CountriesBankAccountDetailsRules” table)
bankCountryCountry of the bank. 2 chars ISO country code.Yes2 charUS
bankBranchCodeBranch code of the bank (sort code for the United Kingdom). It is mandatory for the examples below :Depends[0: 255] char24356758
If the selected bank country code requires this field (please check “CountriesBankAccountDetailsRules” table)
bankBranchAddressStreetAddress of the bank - Number and street. It is mandatory for the examples below:Depends[0: 128] char222 BROADWAY
If the currency of the partner’s environment is USD
If the selected bank country code requires this field (please check “CountriesBankAccountDetailsRules” table)
bankBranchAddressZipCodeAddress of the bank - Zip code. It is mandatory for the examples below :Depends[0: 16] char10038
If the currency of the partner’s environment is USD
If the selected bank country code requires this field (please check “CountriesBankAccountDetailsRules” table)
bankBranchAddressCityAddress of the bank - City. It is mandatory for the examples below :Depends[0 : 128] charNEW YORK CITY
If the currency of the partner’s environment is USD
If the selected bank country code requires this field (please check “CountriesBankAccountDetailsRules” table)
intermediaryBicCodeBIC/SWIFT code of the intermediary bank.No[0: 11] charIRVTDEFX
intermediaryBankNameName of the intermediary bank.No[0:140] charBank OF NEW YORK MELLON
intermediaryBankCountryBank country code of the intermediary bank. 2 chars ISO country code.No2 charsDE
commentReason for new bank account details if another one is already linked to the payment account.No[1: 512] charPrevious bank account closed

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.