Your upload must follow a defined structure with specific columns and formatting rules. Acclaim supports CSV and Excel (Documentation Index
Fetch the complete documentation index at: https://docs.withacclaim.com/llms.txt
Use this file to discover all available pages before exploring further.
.xlsx); both follow the same logical schema.
Supported file types
- CSV (
.csv) - Excel (
.xlsx)
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
Header row
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)
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
Individualpayee.first_namepayee.last_name
payee.business_name
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) |
Data formatting rules
Currency- Valid ISO 4217 code (for example
USD,EUR,MXN).
- Numeric only; no currency symbols (for example
1000.50).
- Trim leading and trailing whitespace.
- Avoid extra special characters unless the field requires them.
- ISO format:
YYYY-MM-DD.