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

# Add an IBAN to a Payment Account for Money-Outs

`POST /v2/moneyouts/iban`

To send Money-Out from the Lemonway payment account to the bank account of your Clients, you need to register their bank account details. This method lets our system to link an IBAN to a payment account.  
- Bank account details are only needed for Money-Outs, not for Money-Ins or P2P.  
- When you link a new bank account (IBAN format or other ones), the previous details are still active.  
- Use [IbanUnregisterPut](https://documentation.lemonway.com/reference/moneyouts_ibanunregisterput) call to deactivate a bank account from a payment account.  
- If you wish to use only one bank account per payment account, please contact support.  
- An integrated algorithm will validate your IBAN.

## Headers

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

## Request body

- RegisterIBANInput
  - `accountId` string, required — Payment Account ID
  - `holder` string — Registered Bank Account Owner: First and Last name, or Company Name
  - `bic` string — 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
  - `iban` string — IBAN
  - `domiciliation1` string — Bank Address Line 1
  - `domiciliation2` string — Bank Address Line 2
  - `comment` string — Reason for new IBAN if another IBAN is already linked to the Payment Account

## Response `200`

OK

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