Handling Transactions exceptions
Diagnose and fix transaction errors
Overview
All transactions in the platform are executed asynchronously, that is, once you request a new Transaction it is registered as pending
and sent to the execution pipeline. Whenever the transaction state changes a new Postback is sent and the transaction.status
field gets updated.
You may check the state.additionalData
field from the last transaction.states[]
entry to get specific details about the transaction failure.
Cards Transactions
All cards transactions are internationally standardized using ISO 8583. Whenever a Card transaction is processed, a Result Code is emitted both on the POS machine and the Web Gateways. This code is used to identify possible scenarios where the physical or virtual cards may not be working.
VISA Response Codes
Code | Description |
---|---|
00 | Transaction completed |
01 | Card problem |
03 | Establishment not registered |
05 | Transaction refused |
06 | Try again |
07 | Special Condition ( cancelled / stolen card) |
10 | Invalid unblock code |
12 | Transaction no permitted to this establishment |
13 | Invalid value |
14 | Invalid card |
30 | Format error |
31 | Establishment not in environment |
41 | Reverse Validity Date / Embedded data differ from the registration |
43 | Stolen card |
51 | Insufficient funds |
52 | Invalid coupon |
54 | Card out-of-date (invalid) |
55 | Invalid or unregistered password |
56 | Card does not exist |
57 | Transaction cancelled (or already cancelled) |
58 | Invalid terminal |
59 | Account has pending debits (cardholder) |
61 | Overlimit exceeded |
62 | Invalid session key |
65 | Overlimit permitted quantity exceeeded |
76 | Blocked card |
80 | Total exceeded |
81 | Duplicated payment |
83 | Due date |
84 | Invalid dealer / merchant |
85 | Query not authorized |
94 | Transaction already registered |
96 | System error |
99 | Original transaction not found / Parameter error |
Tip
Attempts of card transactions may get flagged as a suspicious activity or attempted fraud. In this case, you may get errors other than the 55 even with the correct PIN Code. Contact the consumer to ensure that the card has not been stolen and open a ticket with the Help Desk.
For more information, refer to the official Visa Request and Response Codes developer guidelines.
Updated almost 4 years ago