Create Dedicated Virtual IBANs

post

https://ws.lemonway.fr/mb/ENVNAME/prod/directkitrest/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.

Body Params

wallet

string

required

length between 0 and 256

Payment Account ID.

country

string

required

length between 0 and 2

ISO2 code of the country from which the IBAN must be generated We currently serve 4 countries:

BE: Belgium (BNP Fortis)
ES: BNP Paribas Sucursal en España
FR: France (BNP Paribas)
IT: Italy (BNL)

generatePDFAndQrCode

boolean

If activated, this function will return a PDF document describing the virtual IBAN, along with a standard EPC QR-Code 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

length between 0 and 2

ISO 639-1 language code for the PDF document. The supported languages are:

en: English
es: Spanish
fr: French
it: Italian

This field is ignored if generatePDFAndQrCode is false.

Headers

Authorization

string

required

Authorization bearer (OAuth 2)

PSU-Accept-Language

string

Response language accepted by final client (PSU). English by default

PSU-IP-Address

string

required

IP address of the final client (PSU).

PSU-User-Agent

string

User-agent of the final client (PSU).

Responses

401

Unauthorized

500

InternalServerError

Language

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK