Error types
File-level errors
These stop the upload from being processed at all. Examples:- Unsupported file type
- Missing or invalid header row
- Template does not match the file
- Required columns missing after mapping
- Unreadable or malformed file
Row-level errors
These affect one row while other rows can still succeed. Examples:- Missing required field
- Invalid amount format
- Unsupported currency for the method
- Invalid bank details
- Payout method mismatch
- Country-specific validation failure
Error reporting
You should receive enough detail to correct data quickly, typically including:- Upload or file identifier
- Row number
- Field name (when applicable)
- Error code or type
- Human-readable message
Common file-level errors
Common row-level errors
Example row-level errors
Partial success
Uploads often finish with partial success: many rows succeed, a few fail. In that case:- Valid rows continue to payout creation.
- Failed rows are listed with errors.
- You fix only the failed rows (or the file structure) and re-upload as needed.
Correcting errors
1
Open the error report for the upload and note row and field for each failure.
2
Fix the spreadsheet or export (or adjust the template if mapping was wrong).
3
Upload a new file containing only corrected rows, or a full file if that is your standard control.