Request incoming cross-border payment instructions

In order for BaaS Client to receive cross-border payment, BaaS Client need to get cross-border payment instructions, which must be shared to the sender and sender must use them as beneficiary bank details.

To get cross-border payment instructions, call Cross-border payment instructions API.
If the currency in which your BaaS Client wants to receive cross-border payment has "isBookingRequired": false in the Cross-border payment currencies API response body, then your BaaS Client must pass only creditor IBAN and currency to Cross-border payment instructions API . Else "isBookingRequired": true, then your BaaS Client must pass not only creditor IBAN and currency but also amount.

Tip! Creditor IBAN (creditorAccount.iban) must be your BaaS Client ConnectPay account to which he/she wants to receive cross-border payment

Tip! Access token must include ob-baas-ps scope

Request example:

{
    "creditorAccount": {
        "iban":"LT553740020000006103"
    }, 
    "instructedAmount": {
        "amount": "100.00",
        "currency": "EUR"    
    }
}

Response body of Cross-border payment instructions API gives your BaaS Client bank details, which must be copied and shared to the sender. Sender must use them for payment creation.

Tip! All parameters and their values in the response body must be copied and shared to the sender. Sender must not use your BaaS Client ConnectPay account IBAN!

Please note that each currency may generate different cross-border payment instructions, therefore Cross-border payment instructions API call must be executed for different currencies.

Response example:

{
    "bankAccount": {
        "accountNumber": "T0014536",
        "iban": "IE86IRCE99990100014536T",
        "sortCode": "999901",
        "bankAccountHolder": "Interpay",
        "bic": "IRCEIE2D",
        "bankName": "J.P. MORGAN BANK (IRELAND) PLC",
        "bankAddress": {
            "addressLine1": "JPMORGAN HOUSE INTERNATIONAL FINANCIAL SERVICES CENTRE,Dublin 1,Ireland"
        }
    }
}
Scroll to Top