Spain Beneficiary

Before making a payment to a Spain bank account, you must add the account as a beneficiary. Spain supports two transfer types: BANK (EUR via SEPA) and SWIFT (USD).

BANK Transfer (EUR)

Below is a sample request for creating a Spain BANK beneficiary:

cURL

curl --location '{{sandboxURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
  "reference": "<sample-reference>",
  "country": "ES",
  "currency": "EUR",
  "destination": {
    "type": "BANK",
    "accountName": "Carlos García",
    "accountNumber": "ES9121000418450200051332",
    "remittancePurpose": "FAMILY_SUPPORT",
    "beneficiary": {
      "type": "INDIVIDUAL",
      "country": "ES",
      "city": "Madrid",
      "postCode": "28013",
      "address": "Gran Vía 10"
    },
    "sender": {
      "type": "INDIVIDUAL",
      "accountName": "John Smith",
      "country": "US",
      "city": "New York",
      "address": "123 Main St",
      "postCode": "10001",
      "dateOfBirth": "1985-03-15",
      "countryOfBirth": "US"
    }
  }
}'

The parameters for adding Spain BANK beneficiaries are:

Parameter	Description	Required
country	Country of beneficiary payload. Must be `ES`.	✅
currency	Currency of transfer. Must be `EUR`.	✅
destination.type	Destination type. Must be `BANK`.	✅
accountName	Beneficiary account name.	✅
accountNumber	Beneficiary IBAN (24 chars, no spaces).	✅
remittancePurpose	Remittance purpose. Must be one of the supported enumerations below.	✅

💡

The remittance purpose for BANK transfers can be any one of the following values: COMPUTER_SERVICES, FAMILY_SUPPORT, EDUCATION, GIFT_AND_DONATION, MAINTENANCE_EXPENSES, TRAVEL, CONSTRUCTION_EXPENSES, ADVISORY_FEES, BUSINESS_INSURANCE, INSURANCE_CLAIMS, EXPORTED_GOODS, SERVICE_CHARGES, LOAN_PAYMENT, PROPERTY_PURCHASE, PROPERTY_RENTAL, TAX_PAYMENT, UTILITY_BILLS, PERSONAL_TRANSFER, SALARY_PAYMENT.

Sender Parameters (Business)

Parameter	Description	Required
sender[type]	Must be `BUSINESS`.	✅
sender[accountName]	Sender account name.	✅
sender[country]	Sender country.	✅
sender[city]	Sender city.	✅
sender[address]	Sender address.	✅
sender[postCode]	Sender postal code.	✅
sender[businessRegistrationNumber]	Business registration number.	✅

Sender Parameters (Individual)

Parameter	Description	Required
sender[type]	Must be `INDIVIDUAL`.	✅
sender[accountName]	Sender account name.	✅
sender[country]	Sender country.	✅
sender[city]	Sender city.	✅
sender[address]	Sender address.	✅
sender[postCode]	Sender postal code.	✅
sender[dateOfBirth]	Sender date of birth (YYYY-MM-DD).	✅
sender[countryOfBirth]	Sender country of birth.	✅

Beneficiary Parameters

Parameter	Description	Required
beneficiary[type]	Must be `INDIVIDUAL` or `BUSINESS`.	✅
beneficiary[country]	Beneficiary country.	✅
beneficiary[city]	Beneficiary city.	✅
beneficiary[postCode]	Beneficiary postal code.	✅
beneficiary[address]	Beneficiary address.	✅

SWIFT Transfer (USD)

Below is a sample request for creating a Spain SWIFT beneficiary:

cURL

curl --location '{{sandboxURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
  "reference": "<sample-reference>",
  "country": "ES",
  "currency": "USD",
  "destination": {
    "type": "SWIFT",
    "accountName": "Carlos García",
    "accountNumber": "ES9121000418450200051332",
    "swiftCode": "BSCHESMMXXX",
    "bankName": "Banco Santander",
    "bankAddress": "Gran Vía 10",
    "bankCity": "Madrid",
    "bankPostCode": "28013",
    "bankCountry": "ES",
    "remittancePurpose": "FAMILY_SUPPORT",
    "beneficiary": {
      "type": "BUSINESS",
      "country": "ES",
      "city": "Madrid",
      "postCode": "28013",
      "address": "Gran Vía 10"
    },
    "sender": {
      "type": "INDIVIDUAL",
      "accountName": "John Smith",
      "country": "US",
      "city": "New York",
      "address": "123 Main St",
      "postCode": "10001",
      "dateOfBirth": "1985-03-15",
      "countryOfBirth": "US"
    }
  }
}'

The parameters for adding Spain SWIFT beneficiaries are:

Parameter	Description	Required
country	Country of beneficiary payload. Must be `ES`.	✅
currency	Currency of transfer. Must be `USD`.	✅
destination.type	Destination type. Must be `SWIFT`.	✅
accountName	Beneficiary account name.	✅
accountNumber	Beneficiary IBAN (24 chars, no spaces).	✅
swiftCode	SWIFT/BIC code (8 or 11 chars, uppercase letters/numbers).	✅
bankName	Receiving bank name.	✅
bankAddress	Receiving bank address.	✅
bankCity	Receiving bank city.	✅
bankPostCode	Receiving bank postal code.	✅
bankCountry	Receiving bank country.	✅
remittancePurpose	Remittance purpose. Must be one of the supported enumerations below.	✅

💡

The remittance purpose for SWIFT transfers can be any one of the following values: FAMILY_SUPPORT, EDUCATION, GIFT_AND_DONATION, MEDICAL_TREATMENT, MAINTENANCE_EXPENSES, TRAVEL, SMALL_VALUE_REMITTANCE, LIBERALIZED_REMITTANCE, OTHER, CONSTRUCTION_EXPENSES, HOTEL_ACCOMMODATION, ADVERTISING_EXPENSES, ADVISORY_FEES, BUSINESS_INSURANCE, INSURANCE_CLAIMS, DELIVERY_FEES, EXPORTED_GOODS, SERVICE_CHARGES, LOAN_PAYMENT, OFFICE_EXPENSES, PROPERTY_PURCHASE, PROPERTY_RENTAL, ROYALTY_FEES, SHARES_INVESTMENT, FUND_INVESTMENT, TAX_PAYMENT, TRANSPORTATION_FEES, UTILITY_BILLS, PERSONAL_TRANSFER, SALARY_PAYMENT, OTHER_FEES, COMPUTER_SERVICES, REWARD_PAYMENT, INFLUENCER_PAYMENT.

Sender Parameters (Business)

Parameter	Description	Required
sender[type]	Must be `BUSINESS`.	✅
sender[accountName]	Sender account name.	✅
sender[country]	Sender country.	✅
sender[city]	Sender city.	✅
sender[address]	Sender address.	✅
sender[postCode]	Sender postal code.	✅
sender[businessRegistrationNumber]	Business registration number.	✅

Sender Parameters (Individual)

Parameter	Description	Required
sender[type]	Must be `INDIVIDUAL`.	✅
sender[accountName]	Sender account name.	✅
sender[country]	Sender country.	✅
sender[city]	Sender city.	✅
sender[address]	Sender address.	✅
sender[postCode]	Sender postal code.	✅
sender[dateOfBirth]	Sender date of birth (YYYY-MM-DD).	✅
sender[countryOfBirth]	Sender country of birth.	✅

Beneficiary Parameters

Parameter	Description	Required
beneficiary[type]	Must be `BUSINESS` in this schema.	✅
beneficiary[country]	Beneficiary country.	✅
beneficiary[city]	Beneficiary city.	✅
beneficiary[postCode]	Beneficiary postal code.	✅
beneficiary[address]	Beneficiary address.	✅

South Korea Beneficiary Sweden Beneficiary