Create Dedicated Virtual IBANs

Use this endpoint to provision dedicated (virtual) IBANs for your payment accounts, allowing you to receive wire transfers directly into those accounts.

Key points:

  • Linked to a specific account: Each IBAN is tied to one payment account.
  • Pre‑approval required: Your wire‑transfer schema must be validated by Lemonway before use.
  • On‑demand creation: Call this method only when you know a payment is incoming—avoid assigning IBANs “just in case.”
  • Activation: Contact your Lemonway account manager to enable this feature.

Important: Whenever you see accountId in a path or body parameter, enter your wallet’s ID.

Body Params
string
required
length between 0 and 256
string
required
length between 0 and 2
boolean
string
length between 0 and 2
Headers
string
required
string
string
required
string
string
enum
Defaults to application/json
Allowed:
Responses

401

Unauthorized

500

InternalServerError

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json