---
title: "Create Dedicated Virtual IBANs"
method: POST
path: "/v2/moneyins/bankwire/iban/create"
tags: ["MoneyIns | Virtual IBAN"]
---

# Create Dedicated Virtual IBANs

`POST /v2/moneyins/bankwire/iban/create`

This feature enables you to create dedicated (virtual) IBANs. These IBANs are linked to a dedicated payment account and give the possibility to you to receive wire transfers directly to these accounts. The payment schema must be validated prior with Lemonway. This method should be called once you are certain a payment will be received. We advise against associating an IBAN to a payment account preventively. Please contact your account manager to have this function activated.

## Headers

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

## Request body

- CreateIBANInput
  - `wallet` string — Payment Account ID.
  - `country` string — ISO2 code of the country from which the IBAN must be generated We currently serve 4 countries: <ul><li>BE: Belgium (BNP Fortis)</li><li>ES: BNP Paribas Sucursal en España</li><li>FR: France (BNP Paribas)</li><li>IT: Italy (BNL)</li></ul>
  - `generatePDFAndQrCode` boolean — If activated, this function will return a PDF document describing the virtual IBAN, along with a <a href="https://www.europeanpaymentscouncil.eu/document-library/guidance-documents/quick-response-code-guidelines-enable-data-capture-initiation" target="_blank">standard EPC QR-Code</a> image. Please store these documents in your datawarehouse, as they are not accessible through Lemonway's API after the virtual IBAN has been generated.
  - `pdfLanguage` string — ISO 639-1 language code for the PDF document. The supported languages are: <ul><li>en: English</li><li>es: Spanish</li><li>fr: French</li><li>it: Italian</li></ul> This field is ignored if generatePDFAndQrCode is false.

## Response `200`

OK

- CreateIBANOutput
  - `id` integer — IBAN ID
  - `iban` string — IBAN
  - `bic` string — BIC/SWIFT Code
  - `holder` string — IBAN Owner: First Name, Last Name, or Enterprise Name
  - `domiciliation` string — Domiciliation
  - `status` integer — IBAN Status
  - `maxAvailableIbanPerWallet` integer — IBAN left that can be generated for this wallet
  - `maxAvailableIban` integer — IBAN left that can be generated in total
  - `pdf` string — PDF in base64
  - `qrCode` string — QR Code PNG in base64
  - `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)