Response Codes

Response codes are defined in their respective services.

e.g.

• CaptureResponseCode

ISO 8583 Mappings

Below is a set of common ISO 8583 response codes and recommended mappings to Google response codes. Some ISO codes map to an error response. In these cases, the table specifies which HTTP code to use and what details to include in the error message.

This is not an exhaustive list. Please contact Google if a particular ISO code is unmapped.

ISO 8583 Code to Google Code Mappings
0 Successful approval/completion or that VIP PIN verification is valid	SUCCESS
1 Refer to card issuer	ISSUER_DECLINED
2 Refer to card issuer, special condition	ISSUER_DECLINED
3 Invalid merchant or service provider	HTTP 400 Payment integrator must return an error response indicating which configuration was invalid.
4 Pickup	CARD_LOST_OR_STOLEN
5 Do not honor	DO_NOT_HONOR
6 General error	HTTP 500 Payment integrator must return an error response with error details.
7 Pickup card, special condition (other than lost/stolen card)	CARD_LOST_OR_STOLEN
8 Honor with identification	SUCCESS
9 Request in progress	HTTP 503 Payment integrator must return Service Unavailable since Google requires a synchronous response.
10 Partial approval	ISSUER_DECLINED
11 VIP approval	SUCCESS
12 Invalid transaction	TRANSACTION_INVALID
13 Invalid amount (currency conversion field overflow) or amount exceeds maximum for card program.	TRANSACTION_EXCEEDS_AMOUNT_LIMIT
14 Invalid account number (no such number)	CARD_NUMBER_INVALID
15 No such issuer	TRANSACTION_COULD_NOT_BE_ROUTED
16 Insufficient funds	INSUFFICIENT_FUNDS
19 Re-enter transaction	HTTP 503 Payment integrator must return Service Unavailable since Google requires a synchronous response.
20 Invalid response	HTTP 500 Payment integrator must return an error response with error details.
21 No action taken (unable to back out prior transaction)	CARD_NUMBER_INVALID
22 Suspected Malfunction	HTTP 503 Payment integrator must return Service Unavailable since Google requires a synchronous response.
25 Unable to locate record in file, or account number is missing from the inquiry	CARD_NUMBER_INVALID
28 File is temporarily unavailable	HTTP 503 Payment integrator must return Service Unavailable since Google requires a synchronous response.
30 Format error	HTTP 500 Payment integrator must return an error response with error details.
41 Merchant should retain card (card reported lost)	CARD_LOST_OR_STOLEN
43 Merchant should retain card (card reported stolen)	CARD_LOST_OR_STOLEN
51 Insufficient funds	INSUFFICIENT_FUNDS
52 No checking account	CARD_NUMBER_INVALID
53 No savings account	CARD_NUMBER_INVALID
54 Expired card	CARD_EXPIRED
57 Transaction not permitted to cardholder	TRANSACTION_NOT_ALLOWED
58 Transaction not allowed at terminal	TRANSACTION_NOT_ALLOWED
59 Suspected fraud	SUSPECTED_FRAUD
61 Activity amount limit exceeded	CARD_ACTIVITY_EXCEEDS_AMOUNT_LIMIT
62 Restricted card (for example, in country exclusion table)	TRANSACTION_NOT_ALLOWED
63 Security violation	CVN_MISMATCH
65 Activity count limit exceeded	CARD_ACTIVITY_EXCEEDS_COUNT_LIMIT
68 Response received too late	Payment integrator should treat as Deadline Exceeded
78 Blocked, first used. The transaction is from a new cardholder, and the card has not been properly unblocked.	CARD_NOT_ACTIVATED
80 Visa transactions: credit issuer unavailable	HTTP 503 Payment integrator must return Service Unavailable since Google requires a synchronous response.
80 Private label and check acceptance: Invalid date	CARD_EXPIRATION_DATE_INVALID
82 Negative CAM, dCVV, iCVV, or CVV results	CVN_MISMATCH
85 No reason to decline a request for account number verification, address verification, CVV2 verification; or a credit voucher or merchandise return	SUCCESS
91 Issuer unavailable or switch inoperative (STIP not applicable or available for this transaction)	HTTP 503 Payment integrator must return Service Unavailable since Google requires a synchronous response.
92 Destination cannot be found for routing	TRANSACTION_COULD_NOT_BE_ROUTED
93 Transaction cannot be completed, violation of law	TRANSACTION_NOT_ALLOWED
94 Duplicate transmission	HTTP 500 Payment integrator is responsible to support proper idempotency so this should not happen. If it does, the payment integrator must return an error response and investigate.
95 Reconcile error	HTTP 500 Payment integrator must return an error response with error details.
96 System malfunction, System malfunction or certain field error conditions	HTTP 500 Payment integrator must return an error response with error details.
N0 Force STIP	HTTP 503 Payment integrator must return Service Unavailable since Google requires a synchronous response.
N3 Cash service not available	HTTP 503 Payment integrator must return Service Unavailable since Google requires a synchronous response.
N4 Cashback request exceeds issuer limit	CARD_ACTIVITY_EXCEEDS_AMOUNT_LIMIT
N7 Decline for CVV2 failure	CVN_MISMATCH
P2 Invalid biller information	CUSTOMER_INFO_INVALID
Q1 Card authentication failed	CARD_AUTHENTICATION_FAILED
R0 Stop payment order	STOP_PAYMENT
R1 Revocation of authorization order	REVOCATION_OF_AUTHORIZATION
R3 Revocation of all authorizations order	REVOCATION_OF_AUTHORIZATION
XA Forward to issuer	ISSUER_DECLINED
XD Forward to issuer	ISSUER_DECLINED
Z3 Unable to go online	HTTP 503 Payment integrator must return Service Unavailable since Google requires a synchronous response.