# Response Codes

Response codes are defined in their respective services.

e.g.

- [`ReserveFundsResponseCode`](https://developers.google.com/standard-payments/payment-integrator-card-fop-api/v1/payment-integrator-card-fop-api/reserveFunds#ReserveFundsResponseCode)
- [`CaptureResponseCode`](https://developers.google.com/standard-payments/payment-integrator-card-fop-api/v1/payment-integrator-card-fop-api/capture#CaptureResponseCode)
- [`VerifyCardWithMinimumReservationResponseCode`](https://developers.google.com/standard-payments/payment-integrator-card-fop-api/v1/payment-integrator-card-fop-api/verifyCardWithMinimumReservation#VerifyCardWithMinimumReservationResponseCode)

## 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. |