v1

latestOpenAPI 3.0.02026-07-2691259477.2 KB

MoneyIns | Virtual IBAN

Create Dedicated Virtual IBANs

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.

post/v2/moneyins/bankwire/iban/create

Headers

Authorizationstring required

Authorization bearer (OAuth 2)

PSU-Accept-Languagestring

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

PSU-IP-Addressstring required

IP address of the final client (PSU).

PSU-User-Agentstring

User-agent of the final client (PSU).

Request body

walletstring

Payment Account ID.

countrystring

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>

generatePDFAndQrCodeboolean

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.

pdfLanguagestring

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.

Example request

{
  "wallet": "33612345678",
  "country": "FR",
  "generatePDFAndQrCode": true,
  "pdfLanguage": "en"
}

Response

idinteger

IBAN ID

ibanstring

IBAN

bicstring

BIC/SWIFT Code

holderstring

IBAN Owner: First Name, Last Name, or Enterprise Name

domiciliationstring

Domiciliation

statusinteger

IBAN Status

maxAvailableIbanPerWalletinteger

IBAN left that can be generated for this wallet

maxAvailableIbaninteger

IBAN left that can be generated in total

pdfstring

PDF in base64

qrCodestring

QR Code PNG in base64