Your upload must follow a defined structure with specific columns and formatting rules. Acclaim supports CSV and Excel (.xlsx); both follow the same logical schema.
Supported file types
File structure
Each row is one payout. A typical row includes:
- Payee information
- Bank or payout-method details
- Amount and currency
- Optional metadata your template allows
The first row must be headers that map to Acclaim fields (directly or via your template). Example:
payee.type,payee.first_name,payee.last_name,bank_account.account_number,bank_account.swift_code,amount,currency
Column naming
Column names should match Acclaim field identifiers. Use dot notation for nested fields:
payee.first_namebank_account.account_numberbeneficiary.address.country
Required vs optional fields
What is required depends on:
- Payout method
- Destination country
- Payee type (individual or business)
Use the supported payout countries index and each country’s page for method-specific fields and limits.
Common fields
| Field | Description |
|---|
amount | Payout amount (numeric; no currency symbols in the cell) |
currency | ISO 4217 currency code |
payee.type | individual or business |
bank_account.account_holder_name | Name on the account |
Payee fields
Individual
payee.first_namepayee.last_name
Business
Bank account fields
| Field | Description |
|---|
bank_account.account_number | Local account number |
bank_account.swift_code | SWIFT/BIC |
bank_account.iban | IBAN where supported |
bank_account.clabe | CLABE (Mexico) |
- Valid ISO 4217 code (for example
USD, EUR, MXN).
Amount
- Numeric only; no currency symbols (for example
1000.50).
Strings
- Trim leading and trailing whitespace.
- Avoid extra special characters unless the field requires them.
Dates
Example file
payee.type,payee.first_name,payee.last_name,bank_account.account_holder_name,bank_account.account_number,bank_account.swift_code,amount,currency
individual,Ana,García,Ana García,1234567890,BNMXMXMM,1500,USD
Keep column order stable across files so operations teams and templates stay aligned.
Next steps
