Response Codes

  • Response codes are defined for each service and can be found in their respective documentation links.

  • ISO 8583 response codes have been mapped to Google response codes for easier integration.

  • Some ISO 8583 codes may trigger an error response with a specific HTTP code and message.

  • This mapping list is not exhaustive, and Google should be contacted for unmapped ISO codes.

  • Payment integrators are responsible for handling error responses and ensuring idempotency.

Response codes are defined in their respective services.

e.g.

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.