CCV terminal codes and error messages (en)

A CCV payment terminal may return a result code when processing a payment. This code indicates whether the transaction was approved, cancelled or declined, or whether a technical problem occurred. The tables below explain the meaning of each code.

Success code

Code	Meaning
0000	Transaction approved. This is a success code.

Timeouts and connection problems

Code	Meaning
1000	Timeout. Processing or waiting for a response exceeded the allowed time.
1802	Unexpected message. The terminal receives a message from the host that does not match the expected response.
1803	No response within the allowed time. A request was sent to the PIN pad or host, but no response was received.
1811	Technical problem. General code for other technical errors. The code alone does not identify a specific cause.
1822	Connection failed. A connection to the host could not be established.
1823	Invalid response. The response received from the host is incorrect.
2625	Corrupted response. The response received from the host contains an integrity error, referred to as a CRC error.

Card errors and declined transactions

Code	Meaning
1804	Authorisation declined by the host. Additional host information, referred to as THIC, is required to determine the specific reason for the decline.
2620	Transaction declined by the card. The technical name of this code is Card-required advice.
2623	Card or transaction declined. The card declines the transaction, or the terminal rejects the card.
2624	Transaction not permitted by the acquirer's settings. The settings block the transaction or transaction type. This code applies to MCR only.
2626	Card data authentication failed. The card reports an error during card data verification.
2627	Transaction declined by the host. Additional host information, referred to as THIC, is required to determine the specific reason for the decline.
2628	Magnetic stripe fallback not allowed. The chip cannot be read, and payment using the magnetic stripe is not permitted.
2630	Transaction declined after referral. The technical description is Denial after referral.
2707	Maximum number of incorrect PIN attempts reached. An incorrect PIN has been entered three times. These attempts may be spread across multiple transactions and payment terminals.

Cancelled payments and PIN entry

Code	Meaning
2621	Cancelled during PIN entry. The payment was stopped while the PIN was being entered.
2622	Timeout during PIN entry. The PIN was not entered within the allowed time.
2629	Transaction cancelled. Possible causes include cancellation by the merchant or customer, a timeout while waiting for customer input, or removal of the card. The code alone does not identify which cause applies.

Settings and other technical codes

Code	Meaning
3313	MAC verification failed. An error occurred during message authentication verification, referred to as a key error.
7000	Problem with a connected dispensing device. Delivery of a product or service failed, or confirmation of successful or failed delivery was not received in time. This is also referred to as a Delivery Box error.
9998	Acquirer session limit reached. No sessions are available with the party processing the card payments.
9999	Terminal settings need updating. The terminal parameters are not up to date.
-1	No processing result recorded yet. The Transaction treatment result field has not yet been populated. This is not a final transaction outcome.