Sign in
latestOpenAPI 3.0.12026-08-0660121245.3 KB

099ef636a5a1

Virtual IBANs

Create virtual IBAN

Creates a new virtual IBAN and attaches it to the account specified in the request.

post/v1/accounts/{account_id}/virtual_ibans

Path parameters

account_idstring required

Request body

customer_idstring

Customer data related to the issued Virtual IBAN. Optional if partner configuration allows issuing vIBANs without customer.

referencestring uuid required

Partners must generate a reference for the vIBAN and supply it in this property. This property acts as an idempotency key and must be unique.

descriptionstring

A description of the vIBAN. Visible to the customer.

Example request

{
  "customer_id": "12312312cus",
  "reference": "f3757e7e-57ec-4e07-a3f1-7a5d1e412be7",
  "description": "Example description"
}

Response

The virtual IBAN was already created.