Spain Beneficiary

Before making a payment to a Spanish bank account, you must add the account as a beneficiary. Note that payments to Spanish beneficiaries are via SEPA.

Here is a sample request to add a Spanish beneficiary:

cURL

curl --location '{{sandboxURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
    "reference": "<samplereference>",
    "callbackUrl": "https://webhook.site/38a9e65e-3388-4399-89d4-3ceafa8173dd",
    "customerEmail": "carlos@email.com",
    "country": "ES",
    "currency": "EUR",
    "destination": {
        "type": "BANK",
        "accountName": "Miguel Garcia",
        "accountNumber": "ES9121000418450200051332",
        "remittancePurpose": "FAMILY_SUPPORT",
        "beneficiary": {
            "type": "INDIVIDUAL",
            "country": "ES",
            "city": "Madrid",
            "address": "123 Calle Example",
            "postCode": "28001"
        },
        "sender": {
            "type": "BUSINESS",
            "accountName": "Tech Solutions SL",
            "country": "ES",
            "city": "Barcelona",
            "address": "456 Avenida Business",
            "postCode": "08001",
            "businessRegistrationNumber": "B12345678"
        }
    }
}'

The parameters for adding Spanish bank account beneficiaries are:

Parameter	Description	Required
type	The type of destination. Must be "BANK".	✅
accountName	Name of the beneficiary's account. `A space separated first and last name must be provided for individual beneficiaries e.g Marie Dubois`	✅
accountNumber	The beneficiary's IBAN number. `IBAN length varies per country, see` `here` (opens in a new tab) `for more details.`	✅
remittancePurpose	Purpose of the remittance. `See accepted remittance purposes` `here` (opens in a new tab)	✅
sender	Sender information. Can be either BUSINESS or INDIVIDUAL type.	✅
beneficiary	Beneficiary information.	✅

Sender Parameters (Business)

Parameter	Description	Required
sender[type]	Type of sender. Must be "BUSINESS".	✅
sender[accountName]	Name of the business	✅
sender[country, city, address]	Sender's address details	✅
sender[postCode]	Sender's postcode	✅
sender[businessRegistrationNumber]	Business registration number	✅

Sender Parameters (Individual)

Parameter	Description	Required
sender[type]	Type of sender. Must be "INDIVIDUAL"	✅
sender[accountName]	Name of the sender. `A space separated first and last name must be provided for individual senders e.g John Doe`	✅
sender[country, city, address]	Sender's address details	✅
sender[postCode]	Sender's postcode	✅
sender[dateOfBirth]	Sender's date of birth `It must be in the format YYYY-MM-DD e.g 2025-03-21`	✅
sender[countryOfBirth]	Sender's country of birth	✅

Beneficiary Parameters

Parameter	Description	Required
beneficiary[type]	Type of beneficiary, either "BUSINESS" or "INDIVIDUAL"	✅
beneficiary[country, city, address, postCode]	Beneficiary's address details	✅

Senegal Beneficiary Tanzania Beneficiary