File validation errors

DocsCurrentLast updated: October 6th 2021, @ 7:03:26 pm


These errors may occur when Payouts validates your input file. Once you've fixed the errors, retry the payout:

Error Description
DUPLICATE_REF_ID Reference IDs must be unique within an input file.
EMAIL_MESSAGE_EXCEEDED_MAX_SIZE The email message exceeded the maximum character limit. The limit is 1000.
EMAIL_SUBJECT_EXCEEDED_MAX_SIZE The email subject exceeded the maximum character limit. The limit is 255.
ENCODING_ERROR The payout input file is not in UTF-8 format.
FILE_EMPTY_OR_CORRUPT The payout input file is empty or corrupt and cannot be processed.
FILE_NOT_FOUND The file has been removed from the source folder. Contact our customer support.
FILE_SIZE_ERROR The payout input file is empty.
GZ_FILE_CORRUPT_ERROR The payout input file is corrupt or has a checksum issue.
INVALID_CURRENCY The currency code is invalid.
INVALID_FILE_FORMAT The input file contains characters, columns, or details that are not required for processing payouts. Remove these characters, columns, or details and upload the file.
INVALID_FILE_NAME The format of the file name is invalid.
INVALID_FIRST_COLUMN The first column entry in the summary must be PAYOUT_SUMMARY. For an item record, this must be PAYOUT.
INVALID_REF_ID_FORMAT The reference ID must be alphanumeric. The maximum character limit is 63.
INVALID_SUMMARY_LINE_POSITION The payout summary record is missing from the first line in the payout input file.
MANDATORY_COLUMN_MISSING The file is missing mandatory columns. Please enter the required information and retry the Payout.
MULTI_CURRENCY_NOT_SUPPORTED The payout input file has more than one currency.
MULTIPLE_SUMMARY_RECORDS The payout input file should contain only one summary record.
PAYOUT_AMOUNT_INVALID_FORMAT The payout amount must use a decimal. Other special characters aren't allowed.
PAYOUT_AMOUNT_NON_POSITIVE The payout amount must be greater than zero.
SANDBOX_LIMIT_ERROR The number of items in the file exceeds the sandbox file limit (sandbox only).
SCHEDULED_TIME_ERROR The payout can be scheduled a maximum of seven days in advance.
SUMMARY_AMOUNT_INVALID_FORMAT The summary amount must be a decimal. Other special characters aren't allowed.
SUMMARY_AMOUNT_NON_POSITIVE The total payout amount in the summary line must be greater than zero.
SUMMARY_AND_PAYOUT_MATCH_CONFLICT The payout amount in the summary line doesn’t match the total item value.
SUMMARY_LINES_NON_INTEGER The total number of payments field in the summary line must be an integer.
SUMMARY_LINES_NON_POSITIVE The total number of payments field in summary line must be greater than zero.
SUMMARY_MISSING The summary line is missing from the payout input file.
TOTAL_PAYMENTS_MISMATCH The TOTAL_NO_OF_PAYMENTS in the PAYOUTS_SUMMARY row must match the total records in the payout input file.

See also