Error Codes for Vortex Transactions

This section provides an exhaustive list of error codes you might encounter while using the Vortex API for payment transactions. Understanding these error codes is crucial for identifying specific issues and implementing the necessary corrections to ensure seamless transaction processing. Each error message is paired with a description to aid in quick resolution.

For a more detailed explanation of authorization codes, please refer to API Authorization Code Messages.

Enhanced Error Codes Table

Error Message	Description
`batch must be defined`	A card-batch payment value is required for processing.
`model validations failure`	The schema provided for a card-batch payment is invalid.
`batch not found`	A card-batch cannot be fetched without the externalId.
`externalId must be defined`	No card-batch found with the given externalId.
`payment must be defined`	A card payment value is necessary for processing.
`account number hash is null or is different to the previous one`	The account hash is null or differs from the payment hash value.
`original payment is required`	The externalId for the original payment is missing.
`original payment merchant number does not match the original payment`	The merchant number does not match the original payment's externalId.
`the provided account number does not match the original payment`	Discrepancy between the provided and original payment's account number.
`original payment status is null`	The status of the original payment should not be null.
`the provided amount does not match the original payment`	The totalAmount differs from the original payment's totalAmount.
`ACS error`	An error returned by the ACS service during payment authorization.
`ACS response is empty`	An error or empty response from the ACS service.
`RCP plugin must be installed before APM`	RCP plugin installation is required for APM transactions.
`Virtual Environment is required, please supply via EOS-Virtual-Environment header`	Missing or incorrect eos-virtual-environment header.
`Authorization header invalid or missing`	The authorization header is missing or invalid.
`Authorization type is not supported`	The authorization should be a bearer token.
`API Key is not recognized`	The bearer token does not match any virtual environment.
`Invalid KSN`	Key Serial Number for DUKPT encryption not found.
`Invalid account number`	The accountNumber must be a string.
`no matching ranges`	The BIN number does not match any credit card brand.
`Invalid VortexId`	The VortexId is inactive or does not exist in MXC.