# Handling card transaction codes

Response codes returned only for **sale** card transactions with the following statuses: `settled`, `authorised`, `rejected`.

In response to a card transaction, we will receive a notification with additional parameters: `statusCode` and `statusCodeDescription`.

where:

- `statusCode` - response code from the provider. If there is no code from the list below, the value is returned directly from the provider.
- `statusCodeDescription` - error description. If there is no code from the list below, an empty value is returned.

## Example

```json
{
    "transaction": {
        "id": "25d78bd7-a210-486a-8e14-cbq474c31cqe",
        "type": "sale",
        "status": "settled",
        "source": "web",
        "created": 1657016052,
        "modified": 1657016052,
        "notificationUrl": "https://yourshopdomain.com/notification",
        "serviceId": "eb751aad-c300-4d9a-b677-7efc31ef7add",
        "amount": 100,
        "currency": "PLN",
        "title": "test2",
        "orderId": "test2",
        "paymentMethod": "card",
        "paymentMethodCode": "ecom3ds",
        "statusCode": "CODE_000",
        "statusCodeDescription": "CODE_000 - OK"
    },
    "payment": {
        "id": "59a387b3-2192-42ff-a4c8-8bae165b74c8",
        "title": "test2",
        "amount": 100,
        "status": "settled",
        "created": 1657016036,
        "orderId": "test2",
        "currency": "PLN",
        "modified": 1657016052,
        "serviceId": "eb751aad-c300-4d9a-b677-7efc31ef7add",
        "notificationUrl": "https://yourshopdomain.com/notification"
    }
}
```

## Provider response codes

| StatusCode     | StatusCodeDescription  | Description |
|-----------|:-----------------------:|-------|
| `INT_CREDIT_CARD_DISABLED`   | `INT_CREDIT_CARD_DISABLED` | Payment is not available for credit cards |
| `CODE_000`   | `CODE_000 - OK` | Payment accepted |
| `CODE_01` | `CODE_01 - Refer to card issuer` | Please contact your card issuer |
| `CODE_02` | `CODE_02 - Refer to card issuer, special condition` | Card issuer error, contact your card issuer |
| `CODE_03` | `CODE_03 - Invalid merchant or service provider` | Store configuration error |
| `CODE_04` | `CODE_04 - Pickup card` | Keep the card |
| `CODE_05` | `CODE_05 - Do not honor` | Bank refusal, contact your card issuer |
| `CODE_06` | `CODE_06 - General error` | Error |
| `CODE_07` | `CODE_07 - Pick up card, special condition (fraud account)` | Keep the card, attempted cheating |
| `CODE_08` | `CODE_08 - Honor with ID` | The card is only supported with an ID card  |
| `CODE_10` | `CODE_10 - Partial approval` | Partial Approval |
| `CODE_11` | `CODE_11 - Approved (V.I.P)` | Payment accepted  |
| `CODE_12` | `CODE_12 - Invalid transaction` | Invalid transaction |
| `CODE_13` | `CODE_13 - Invalid amount` | The limit for internet transactions has been exceeded |
| `CODE_14` | `CODE_14 - Invalid account number (no such number)` | Invalid account number (there is no such account) |
| `CODE_15` | `CODE_15 - Invalid issuer/No such issuer (first 8 digits of account number do not relate to an issuing identifier)` | There is no such issuer |
| `CODE_19` | `CODE_19 - Re-enter transaction` | Enter the transaction again |
| `CODE_20` | `CODE_20 - Invalid response`| Invalid response | 
| `CODE_21` | `No action taken`| No action was taken |
| `CODE_30` | `CODE_30 - Message format error` | Message format error |
| `CODE_33` | `CODE_33 - Expired Card - Pick Up` | The card has expired - the card is lost or reported |
| `CODE_34`| `CODE_34 - Suspected Fraud - Pick Up`| Suspected fraud |
| `CODE_35`| `CODE_35 - Contact Acquirer - Pick Up`| Contact vendor |
| `CODE_39` | `CODE_39 - No credit account` | No credit card bill |
| `CODE_40`| `CODE_40 - Requested Function Not Supported`| The requested function is not supported |
| `CODE_41` | `CODE_41 - Lost card, pick up (fraud account)` | Card reported as lost |
| `CODE_43` | `CODE_43 - Pickup card (stolen card)` | Card reported as stolen |
| `CODE_51` | `CODE_51 - Insufficient funds` | There are no funds on the card|
| `CODE_52` | `CODE_52 - No checking account` | No credit card bill |
| `CODE_53` | `CODE_53 - No savings account` | No card account |
| `CODE_54` | `CODE_54 - Expired card` | The card has expired or the Payer provided incorrect card expiry dates |
| `CODE_56` | `CODE_56 - No Card Record` | No card saving |
| `CODE_57` | `CODE_57 - Card disabled for e-commerce or cross-border transactions` | The card is disabled for e-commerce or cross-border transactions |
| `CODE_59` | `CODE_59 - Suspected fraud` | Suspected fraud |
| `CODE_61` | `CODE_61 - Exceeds approval amount` | Card limit exceeded |
| `CODE_62` | `CODE_62 - Restricted card / Country exclusion table` | Card restriction (card not valid for this region or country) |
| `CODE_63` | `CODE_63 - Security violation (source is not correct issuer)` | Security breach |
| `CODE_64` | `CODE_64 - Transaction does not fulfill AML requirement` | The transaction does not meet the AML requirement |
| `CODE_65` | `CODE_65 - Exceeds withdrawal frequency limit` | Exceeding the limit of the number of transactions. |
| `CODE_75` | `CODE_75 - Allowed number of PIN-entry tries exceeded` | The permitted number of PIN entry attempts has been exceeded |
| `CODE_83` | `CODE_83 - Fraud/Security (Mastercard use only)` | Fraud / Security (Mastercard Use Only) |
| `CODE_90` | `CODE_90 - Destination not available` | Destination unavailable |
| `CODE_93` | `CODE_93 - Card disabled for e-commerce transactions` | Card disabled for e-commerce transactions |
| `CODE_99` | `CODE_99 - Authorization error - default` | Authorization error |
| `CODE_114` | `CODE_114 - No account of type requested` | The requested type account is missing |
| `CODE_570` | `CODE_570 - 3D Secure authentication failed` | 3D Secure authentication failed |
| `CODE_581` | `CODE_581 - Exceeded limit of unsuccessful transaction attempts for the specified card` | The limit of unsuccessful transaction attempts for the specified card has been exceeded |
| `CODE_AC` | `CODE_AC - Account closed (do not try again)` | Account closed (don't try again)|
| `CODE_N0` | `CODE_N0 - Unable to authorize / Force STIP` | Card authorization failed |
| `CODE_N8` | `CODE_N8 - Transaction amount exceeds preauthorized approval amount` | Transaction amount too high |
| `CODE_P1` | `CODE_P1 - Over daily limit (try again later)` | Daily limit exceeded |
| `CODE_P9` | `CODE_P9 - Enter lesser amount` | Enter a smaller amount |
| `CODE_PF` | `CODE_PF - Possible fraud (do not try again)` | Suspected cheating (don't try again). |
| `CODE_Q1` | `CODE_Q1 - Card Authentication failed` | Card authorization failed |
| `CODE_SD` | `CODE_SD - Soft decline (strong authentication required)` | Soft Rejection (Strong Authentication Required) |
| `CODE_T3` | `CODE_T3 - Card not supported` | Card not supported |
| `CODE_T5` | `CODE_T5 - Card inactive or closed (updated information needed)` | Card inactive or closed (need to update information) |
| `CODE_T8` | `CODE_T8 - Invalid account` | Invalid account |
| `CODE_Z3` | `CODE_Z3 - Unable to go online` | Communication error with the publisher |

## Provider response codes - sandbox

> In the sandbox environment, it is possible to simulate the returned code by setting the appropriate amount together with the selected card returning the rejected status.

| StatusCode     | StatusCodeDescription  | Opis |
|-----------|:-----------------------:|-------|
| `CODE_05` | `CODE_05 - Do not honor` | The default response code for rejected transactions |
| `CODE_51` | `CODE_51 - Insufficient funds` | Code returned for a rejected transaction for the amount of 1 PLN |
| `CODE_114` | `CODE_114 - No account of type requested` | Default response code, it is possible to call it by performing a rejected transaction for the amount of 1141 pennies |
| `CODE_AC` | `CODE_AC - Account closed (do not try again)` | Default response code, it is possible to call it by performing a rejected transaction for the amount of 14143 pennies |