Response Codes

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.