Italy Beneficiary

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

Here is a sample request to add an Italian 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": "marco@email.com",
    "country": "IT",
    "currency": "EUR",
    "destination": {
        "type": "BANK",
        "accountName": "Giuseppe Rossi",
        "accountNumber": "IT60X0542811101000000123456",
        "remittancePurpose": "FAMILY_SUPPORT",
        "beneficiary": {
            "type": "INDIVIDUAL",
            "country": "IT",
            "city": "Roma",
            "address": "123 Via Example",
            "postCode": "00100"
        },
        "sender": {
            "type": "BUSINESS",
            "accountName": "Tech Solutions SRL",
            "country": "IT",
            "city": "Milano",
            "address": "456 Corso Business",
            "postCode": "20121",
            "businessRegistrationNumber": "12345678901"
        }
    }
}'

The parameters for adding Italian 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	✅

Guinea Beneficiary Malawi Beneficiary