Skip to main content
File uploads let you create and process payouts in bulk by uploading structured files such as CSV or Excel. For many teams, this is the fastest way to send large volumes of payouts without building a full API-based integration.

​
When to use file uploads

Use file uploads when:
  • You need to send payouts in bulk.
  • Your payout data comes from spreadsheets or internal exports.
  • You want to go live quickly without a full API integration.
  • Operations or finance owns payout execution.
Use the API when:
  • Payouts are triggered programmatically in real time.
  • You need dynamic or event-driven workflows.
  • You want tight system-to-system integration.

​
How it works

1
You upload a file (CSV or Excel) in the Acclaim Console.
2
Acclaim validates the file structure and data against your template.
3
Each row is parsed into payout and payee data.
4
Valid rows are processed into payouts.
5
Invalid rows are rejected with row-level errors you can fix and re-upload.
This process is asynchronous. Large files may take time to finish.
Do not assume payouts are final until you confirm processing and payout status in the Console or your usual monitoring workflow.

​
Supported file types

  • CSV (.csv)
  • Excel (.xlsx)
Files must follow a defined structure and include the fields required for each payout method. Country and method requirements are listed on the supported payout countries pages.

​
Key concepts

​
Templates

Templates define how your file is interpreted:
  • Required columns and how they map to Acclaim fields.
  • Payout method configuration.
Each upload is validated against a template. See Template configuration.

​
Validation

Before processing, Acclaim checks that:
  • Required fields are present.
  • Formats are correct.
  • Payout method and country rules are satisfied.
Errors are reported at the row level when possible. See Validation rules.

​
Processing

After validation, valid rows become payouts and move through execution. You can track status in the Console. See Processing flow.
Last modified on March 30, 2026