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:
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
Payee fields
Individual
payee.first_namepayee.last_name
Business
Bank account fields
Currency
- 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
Keep column order stable across files so operations teams and templates stay aligned.
Next steps
Last modified on March 29, 2026
