Request incoming cross-border payment instructions

To receive cross-border payment you’ll 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 you want to receive cross-border payment has "isBookingRequired": false in the Cross-border payment currencies API response body, then you must pass only creditor IBAN and currency to Cross-border payment instructions API . Else "isBookingRequired": true, then you must pass not only creditor IBAN and currency but also amount.

Tip! Creditor IBAN (creditorAccount.iban) must be your ConnectPay account to which you want to receive cross-border payment

Tip! Access token must include ob-ps scope

Request example:

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

Response body of Cross-border payment instructions API gives you 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 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"
        }
    }
}