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.