Level 3 error code

Resolve Visa Commercial Enhanced Data Program Level 3 validation errors.

Use this reference to resolve Visa Commercial Enhanced Data Program (CEDP) Level 3 validation errors. It covers supported enhanced-data capabilities only.

These error codes are Visa Confidential and are not part of the Visa Rules. If this reference conflicts with Visa rules or specifications, use the Visa-controlled source and contact your Visa representative.

Identify the record family

Use this table to identify where to begin investigating an error code.

Code prefix	Start your investigation with
CS-xxxx	The TC05 clearing record and supporting enhanced-data fields.
TC50-0xxx	Invoice structure and the PURCHA header or summary.
TC50-1xxx or TC50-2xxx	PURCHL line details, calculations, sequence, and description quality.

Error code

What Visa is flagging describes the validation failure. First thing to check gives a practical starting point. It does not replace Visa-controlled specifications.

CS codes: TC05 summary checks

Use this table to resolve errors in the TC05 clearing record and related summary fields.

Code	Type	What Visa is flagging	First thing to check
CS-0001	Allowed value	Number of payment forms contains a value Visa does not allow.	Send blank, 1–9, or +, as applicable.
CS-0002	Allowed value	Purchase ID format contains an unsupported value.	Use blank, 0, 1, or 5.
CS-0003	Missing dependency	Purchase ID format indicates an ID should exist, but Purchase ID is empty.	Provide the Purchase ID. Use blank or 0 when no ID is supplied.
CS-0004	Allowed value	Local Tax Included is not coded as included or not included.	Use 1 or 2.
CS-0005	Field dependency	A local tax amount was sent, but Local Tax Included does not indicate tax is included.	When Local Tax Amount is provided, set Local Tax Included to 1.
CS-0006	Field dependency	No local tax amount was sent, but Local Tax Included does not indicate tax is not included.	When Local Tax Amount is absent, set Local Tax Included to 2.
CS-0007	Must be zero	National Tax Amount is nonzero.	Set National Tax Amount to 0.
CS-0008	Must be zero	National Tax Included is nonzero.	Set National Tax Included to 0.
CS-0009	Missing field	Message ID is empty.	Populate Message ID.
CS-0010	Format	Purchase time is not a valid 24-hour HHMM value.	Send a valid hour and minute in HHMM format.
CS-0011	Amount reconciliation	Source Amount does not reconcile to line totals, taxes, invoice shipping, and invoice discount.	Recalculate all components. Confirm signs, rounding, and included lines.
CS-0012	Amount reconciliation	Local Tax Amount does not equal the total submitted tax amounts.	Align the header tax amount with all tax details.
CS-0089	Data quality pattern	Repeated single-item transactions prevent Visa from creating a unique digital receipt or invoice.	Send complete, transaction-specific line-item detail instead of repeated generic single items.

TC50-0000 series: invoice structure and header checks

Use this table to resolve invoice structure and PURCHA header errors.

Code	Type	What Visa is flagging	First thing to check
TC50-0001	Missing record	The invoice header or summary record (PURCHA) is missing.	Include TC50 PURCHA.
TC50-0002	Missing record	The invoice line-detail record (PURCHL) is missing.	Include TC50 PURCHL line items.
TC50-0003	Record structure	More than one TC50 type was found where the structure does not allow it.	Review record construction. Remove the unintended TC50 type.
TC50-0004	Duplicate record	A duplicate PURCHA header was found.	Send one intended PURCHA header.
TC50-0005	Duplicate record	Duplicate PURCHL detail was found.	Remove unintended duplicate line-detail records.
TC50-0006	Format	Destination postal or ZIP code does not match the destination country format.	Validate the postal code against the country code.
TC50-0007	Code mapping	Destination Country Code is not a valid ISO country code.	Use a valid ISO country code.
TC50-0009	Format	PURCHA Order Date is not a valid YYMMDD date.	Send a real calendar date in YYMMDD format.
TC50-0010	Field dependency	Freight tax amount is nonzero although freight amount is 0.	Set freight tax amount to 0 when freight amount is 0.
TC50-0011	Amount calculation	Freight tax amount does not equal freight amount multiplied by freight tax rate.	Recalculate freight tax. Review signs and rounding.
TC50-0012	Field dependency	Freight tax rate is nonzero although freight amount is 0.	Set freight tax rate to 0 when freight amount is 0.
TC50-0013	Cross-record mismatch	PURCHA Authorization Code is populated but differs from the TC05 Authorization Code.	Make the authorization codes match. Leave PURCHA blank when appropriate.
TC50-0014	Allowed value	Invoice-level Discount Treatment Code is invalid.	Use 0, 1, or 2.
TC50-0015	Allowed value	Tax Treatment contains an unsupported value.	Use 0, 1, 2, 3, or 4.
TC50-0016	Allowed value	Discount Amount signage contains an unsupported value.	Use blank, C, or D.
TC50-0017	Allowed value	Freight or Shipping Amount signage contains an unsupported value.	Use blank, C, or D.
TC50-0018	Allowed value	Duty Amount signage contains an unsupported value.	Use blank, C, or D.
TC50-0019	Allowed value	VAT or Tax Amount signage contains an unsupported value.	Use blank, C, or D.

TC50-1000 series: line-item structure and calculations

Use this table to resolve PURCHL line-item structure, calculation, and sequence errors.

Code	Type	What Visa is flagging	First thing to check
TC50-1001	Missing field	Item Description is blank, null, or all zeros.	Provide a meaningful item description.
TC50-1002	Missing field	Product Code is blank, null, or all zeros.	Provide a valid product code.
TC50-1003	Missing field	Unit of Measure is blank, null, or all zeros.	Provide the applicable unit of measure.
TC50-1004	Amount calculation	Line total does not equal unit cost × quantity minus line discount.	Recalculate each line total. Review signs and rounding.
TC50-1005	Allowed value	Line-item Detail Indicator is invalid.	Use 0, 1, 2, 3, 4, or 5.
TC50-1006	Record ending	Detail indicators do not follow Visa’s even or odd rule.	Use an even indicator for each nonfinal line. Use an odd indicator for the final line.
TC50-1007	Allowed value	Line-item Discount Treatment Code is invalid.	Use 0, 1, or 2.
TC50-1011	Sequence	The line-item sequence does not progress correctly from the first line.	Renumber line items sequentially from the starting value.

TC50-2000 series: description quality

Use this table to improve PURCHL descriptions that do not identify purchased goods or services.

Code	Type	What Visa is flagging	First thing to check
TC50-2001	Description quality	Line-item description is blank or effectively blank.	Provide a meaningful description of the purchase.
TC50-2002	Description quality	Line-item description is the same as, or nearly the same as, the merchant name.	Describe the actual product or service.
TC50-2003	Description quality	Line-item product code repeats the cardholder product ID.	Provide the item's product code.
TC50-2004	Description quality	Line-item description is too generic to identify the purchase.	Use a specific product or service description.
TC50-2005	Description quality	Line-item description contains only one character.	Provide a meaningful, multicharacter description.
TC50-2006	Description quality	The entire line-item description is contained within the merchant name.	Describe the item or service independently.
TC50-2007	Description quality	Descriptions are mostly generic, numeric, merchant-specific, or otherwise not descriptive.	Use clear, transaction-specific descriptions.