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
