---
title: "Add Bank Account to a Payment Account for Money-Outs"
method: POST
path: "/v2/moneyouts/iban/extended"
tags: ["MoneyOuts"]
---

# Add Bank Account to a Payment Account for Money-Outs

`POST /v2/moneyouts/iban/extended`

## Request

- Base URL: `https://ws.lemonway.fr/mb/env-name/prod/directkitrest`
- URL: `https://ws.lemonway.fr/mb/env-name/prod/directkitrest/v2/moneyouts/iban/extended`
- Auth: none declared. Required headers: `Authorization`, `PSU-IP-Address`

You are required to register your client's bank account details in order to send Money-Out from a Lemonway payment account.  
With this method, our system links other bank formats to a payment account.  

**Important:** If your client bank account details are in IBAN format this call.  

- Client bank account details are **only** required for money-outs.  
- When you link a new bank account (IBAN format or other ones), the previous ones are still active.  
- Please use [IbanUnregisterPut](https://documentation.lemonway.com/reference/moneyouts_ibanunregisterput) method to deactivate a bank account from a payment account. 
- If you wish to use only one bank account per payment account, please contact support.  
            
Depending on bank country code selected or when a USD environment is concerned, 3 fields may be required:  
- bankBranchRoutingCode  
- bankName  
- bankBranchAddress

## Headers

- `Authorization` string, required
- `PSU-Accept-Language` string
- `PSU-IP-Address` string, required
- `PSU-User-Agent` string

## Request body

- RegisterIBANExtendedInput
  - `wallet` string, required: Payment Account ID
  - `accountType` 0 | 1 | 2: Account Type, by default Other<br/>0 = Other.<br/>1 = IBAN.<br/>2 = BBAN/RIB.<br/>
  - `holderName` string, required: The registered bank account owner: First and Last name, or Company Name
  - `accountNumber` string, required: Account Number. The format depends on the account type.
  - `holderCountry` string: Country of the beneficiary. Two-letter country code (ISO alpha-2) for example, France=<b>FR</b>
  - `bicCode` string: BIC/SWIFT codes are arranged like this: AAAABBCCDDD AAAA: 4 character for bank code BB: 2 char for country code CC: 2 char for location code DDD: 3 char for branch code
  - `bankName` string: Bank Name. This field is mandatory in the following circumstances: <ul><li>If the currency is USD</li><li>If the selected bank country code requires this field</li></ul>
  - `bankCountry` string, required: Country of the Bank. Two-letter country code (ISO alpha-2) for example, France=<b>FR</b>
  - `bankBranchCode` string: Bank Branch Code (Sort Code in the United Kingdom). It is mandatory for the examples below: <ul><li>If the selected bank country code requires this field.</li></ul>
  - `bankBranchAddress` BankBranchAddress
    - `Street` string, required: Number and Street
    - `ZipCode` string, required: Postal or Zip Code
    - `City` string, required: City
  - `intermediaryBicCode` string: BIC/SWIFT Code of the Intermediary Bank.
  - `intermediaryBankName` string: Intermediary Bank Name
  - `intermediaryBankCountry` string: Bank Country Code of the Intermediary Bank. Two-letter country code (ISO alpha-2) for example, France=<b>FR</b>
  - `comment` string: Reason for new Bank Account details if another one is already linked to the Payment Account.

## Response `200`

OK

- RegisterIBANExtendedOutput
  - `ibanId` integer: IBAN ID
  - `status` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9: IBAN Status<br/>1 = None.<br/>2 = Internal.<br/>3 = Not used.<br/>4 = Waiting to be verified by Lemon Way.<br/>5 = Activated.<br/>6 = Rejected by the bank.<br/>7 = Rejected, no owner.<br/>8 = Deactivated.<br/>9 = Rejected.<br/>
  - `error` Error
    - `code` integer
    - `message` string
    - `psp` PSP
      - `message` string: Get the Error Message from PSP

## Other responses

- `401`: Unauthorized
- `500`: InternalServerError

---

[API](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0.md) - [All operations](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0/revisions/82551a0a77b8?raw)