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

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 — 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 — The registered bank account owner: First and Last name, or Company Name
  - `accountNumber` string — 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 — 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 — Number and Street
    - `ZipCode` string — Postal or Zip Code
    - `City` string — 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.net/lemonway/apis/account-onboarding-management-api.md) · [All operations](https://skmtc.net/lemonway/apis/account-onboarding-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemonway/account-onboarding-management-api/revisions/73309fe68e2d/schema)