Counterparty data

The payment message should include the beneficiary data in the counterparty block. The counterparty data can be presented in one of the following formats:

• with IBAN,

• with BBAN,

• with account alias,

• With address, identification details and bank ID.

With IBAN

The example presenting beneficiary data in the Counterparty section with IBAN is here.

{
   "paymentParties": [
       {OUR_PARTY},
       
       {
           "typeCode": "COUNTERPARTY",
           "name": "Ben Eficiary",
           "accountNumber": {
               "value": "EE871275295834652820",
               "type": "IBAN"
           }
       }
   ],
   
   "money": {...}
}

With BBAN

The example presenting beneficiary data in the Counterparty section with BBAN is here.

{
   "paymentParties": [
       {OUR_PARTY},
       
       {
           "typeCode": "COUNTERPARTY",
           "name": "Ben Eficiary",
           "accountNumber": {
               "value": "4536891112",
               "type": "BBAN"
           },
           "financialInstitutionId": "1234",
           "accountNumberCountryCode": "DK"
       }
   ],
   
   "money": {...}
}

With account alias

The example below shows how to present beneficiary data in the Counterparty section with an account alias, such as a phone number, email address, or other reference data associated with the beneficiary.

{
   "paymentParties": [
       {OUR_PARTY},
       
       {
           "typeCode": "COUNTERPARTY",
           "name": "Ben Eficiary",
           "accountNumber": {
               "value": "0987-6543",
               "type": "ALIAS"
           },
           "accountNumberSubtype": "BANKGIRO"
       }
   ],
   
   "money": {...}
}

With address, identification details and bank ID

If you initiate a cross-border payment, you can amend beneficiary data with its financial institution ID, address and identification details, as visible in the example below.

{
   "paymentParties": [
       {OUR_PARTY},
       
       {
           "typeCode": "COUNTERPARTY",
           "name": "Ben Eficiary",
           "accountNumber": {
               "value": "EE871275295834652820",
               "type": "IBAN"
           },
           "financialInstitutionId": "PARXEE22XXX",
           "address": {
               "street1": "First street 123",
               "street2": "Second street 321",
               "cityCounty": "Some city",
               "zip": "06777",
               "countryCode": "EE"
           },
           "partyIdentification": {
               "identificationTypeCode": "NATIONAL_ID_NUMBER",
               "identificationValue": "914-447-7805"
           }
       }
   ],
   
   "money": {...}
}

Sample API calls

To view some sample API call demonstration payment creation, refer to the following examples:

• Counterparty with IBAN,

• Counterparty with BBAN.