Documentation
Beneficiaries
Argentina Beneficiary

Argentina Beneficiary

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

Below is a sample request for creating an Argentina beneficiary:

cURL
curl --location '{{baseURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
    "reference": "<samplereference>",
    "country": "AR",
    "currency": "ARS",
    "destination": {
        "type": "BANK",
        "bankCode": 2292,
        "accountName": "Laura Gómez",
        "accountType": "SAVINGS",
        "accountNumber": "0720098745632109876543",
        "remittancePurpose": "SALARY_PAYMENT",
        "sender": {
            "city": "Buenos Aires",
            "type": "BUSINESS",
            "taxId": "30-76543210-2",
            "address": "Calle Florida 890, Buenos Aires",
            "country": "AR",
            "postCode": "S2000GHI",
            "accountName": "GlobalSoft SRL",
            "phoneNumber": "+5491198765432",
            "businessRegistrationNumber": "AR-BIZ-908070"
        },
        "beneficiary": {
            "type": "INDIVIDUAL",
            "idType": "NATIONAL_ID",
            "address": "Av. San Martín 234, Rosario",
            "idNumber": "27456123",
            "phoneNumber": "+5491156782345"
    }
}
}'

The parameters for adding Argentina bank account beneficiaries are:

ParameterDescriptionRequired
typeThe type of destination. Must be "BANK".✅
accountNameName of the beneficiary's account.
A space separated first and last name must be provided for individual beneficiaries e.g Marie Dubois
✅
accountTypeThe beneficiary's Account type. It must be one of CHECKING, SAVINGS, DEPOSIT, OTHERS✅
accountNumberThe beneficiary's Account number.✅
remittancePurposePurpose of the remittance.
See accepted remittance purposes here (opens in a new tab)
✅
bankCodeCode of the receiving bank
See accepted bankCodes here (opens in a new tab)
✅
senderSender information varies depending on type. Sender type can either be BUSINESS or INDIVIDUAL.✅
beneficiaryBeneficiary information.✅
💡

The remittance purpose 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)

ParameterDescriptionRequired
sender[type]Type of sender. Must be BUSINESS.✅
sender[accountName]Sender's accountName✅
sender[country]Sender's country✅
sender[postCode]Sender's address post code✅
sender[businessRegistrationNumber]Sender's business registration number✅
sender[address, city]Sender's address.✅
sender[phoneNumber]Sender's phone address✅
sender[taxId]Sender's tax ID✅

Sender Parameters (Individual)

ParameterDescriptionRequired
sender[type]Type of sender. Must be INDIVIDUAL✅
sender[accountName]Sender's accountName✅
sender[postCode]Sender's address post code✅
sender[dateOfBirth]Sender's date of birth✅
sender[country]Sender's country✅
sender[countryOfBirth]Sender's country of birth.✅
sender[address]Sender's address.✅
sender[phoneNumber]Sender's phone address✅
sender[idType, idNumber]Sender's identification details (type, number).
See accepted id types here (opens in a new tab)
✅

Beneficiary Parameters

🚧

For Business beneficiaries, ID Type must be TAX_ID

ParameterDescriptionRequired
beneficiary[type]Type of beneficiary, either BUSINESS or INDIVIDUAL✅
beneficiary[phoneNumber]Beneficiary's phone address✅
beneficiary[idType, idNumber]Beneficiary's identification details (type, number).
See accepted id types here (opens in a new tab)
✅
beneficiary[address]Beneficiary's address.✅

USD payouts via SWIFT

Below is a sample request for creating a SWIFT beneficiary in Argentina:

cURL
curl --location '{{baseURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
    "reference": "<samplereference>",
    "customerEmail": "ray.jon@mail.com",
    "callbackUrl": "https://webhook.site/38a9e6b0-3388-4399-89d4-3ceafa000001",
    "country": "AR",
    "currency": "USD",
    "destination": {
        "type": "SWIFT",
        "accountName": "Laura Gomez",
        "accountNumber": "0720098745632109876543",
        "swiftCode": "NACNARBA",
        "bankName": "Banco de la Nacion Argentina",
        "bankAddress": "Bartolome Mitre 326",
        "bankCity": "Buenos Aires",
        "bankPostCode": "C1036AAF",
        "bankCountry": "AR",
        "remittancePurpose": "FAMILY_SUPPORT",
        "beneficiary": {
            "type": "INDIVIDUAL",
            "country": "AR",
            "city": "Rosario",
            "state": "Santa Fe",
            "postCode": "S2000GHI",
            "address": "Av. San Martin 234",
            "phoneNumber": "+15551234567",
            "nationality": "AR",
            "idType": "TAX_ID",
            "idNumber": "TAX-123456789",
            "idExpiration": "2030-01-15",
            "gender": "MALE",
            "dateOfBirth": "1990-05-20",
            "taxIdNumber": "TAX-123456789"
        },
        "sender": {
            "type": "INDIVIDUAL",
            "accountName": "Jane Doe",
            "country": "US",
            "city": "New York",
            "state": "NY",
            "address": "123 Main St",
            "postCode": "10001",
            "phoneNumber": "+12125550123",
            "email": "jane.doe@example.com",
            "gender": "FEMALE",
            "idType": "PASSPORT",
            "idNumber": "US1234567",
            "idIssueDate": "2020-06-01",
            "dateOfBirth": "1990-01-15",
            "countryOfBirth": "US",
            "complianceDocument": {
                "proofOfIdentity": "<document-reference>"
            }
        }
    }
}'

The parameters for adding Argentina SWIFT beneficiaries are:

ParameterDescriptionRequired
typeThis is the payment type. It must be SWIFT✅
accountNameName on the receiving bank account✅
accountNumberAccount number or IBAN of the receiving account✅
swiftCodeSWIFT/BIC of the receiving bank (8 or 11 characters)✅
bankNameName of the receiving bank✅
bankAddressStreet address of the receiving bank✅
bankCityCity of the receiving bank✅
bankPostCodePost code of the receiving bank✅
bankCountryCountry of the receiving bank. Must be AR✅
remittancePurposePurpose of the transfer. See the SWIFT guide for accepted values✅
beneficiaryAccount holder details. See the SWIFT guide✅
senderSender details including complianceDocument. See the SWIFT guide✅
📘

The beneficiary and sender objects, the sender complianceDocument, the optional bankState and intermediaryBank fields and every accepted enumeration value are documented in the SWIFT Beneficiary guide.

⚠️

Argentina is a tax-ID country: beneficiary.taxIdNumber is required and an individual beneficiary's idType must be TAX_ID.