# Obsługa kodów dla transakcji kartowych

Kody odpowiedzi zwracane jedynie w przypadku transakcji kartowych typu **sprzedaż (sale)**, o statusach: `settled`, `authorized`, `rejected`

W odpowiedzi na transakcję kartową otrzymamy notyfikację z dodatkowymi parametrami: `statusCode` oraz `statusCodeDescription`.

gdzie:

- `statusCode` - kod odpowiedzi od dostawcy. W przypadku braku kodu z poniższej listy zwracana zostaje wartość bezpośrednio od dostawcy.
- `statusCodeDescription` - opis błędu. W przypadku braku kodu z poniższej listy zwracana jest pusta wartość.

## Przykład

```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"
    }
}
```

## Kody odpowiedzi dostawcy

| StatusCode     | StatusCodeDescription  | Opis |
|-----------|:-----------------------:|-------|
| `INT_CREDIT_CARD_DISABLED`   | `INT_CREDIT_CARD_DISABLED` | Płatność nieodstępna dla kart kredytowych |
| `CODE_000`   | `CODE_000 - OK` | Płatność zaakceptowana |
| `CODE_01` | `CODE_01 - Refer to card issuer` | Skontaktuj się z wystawcą karty |
| `CODE_02` | `CODE_02 - Refer to card issuer, special condition` | Błąd wystawcy karty, skontaktuj się z wystawcą karty |
| `CODE_03` | `CODE_03 - Invalid merchant or service provider` | Błąd konfiguracji sklepu|
| `CODE_04` | `CODE_04 - Pickup card` | Zatrzymaj kartę |
| `CODE_05` | `CODE_05 - Do not honor` | Odmowa banku, skontaktuj się z wystawcą karty |
| `CODE_06` | `CODE_06 - General error` | Błąd |
| `CODE_07` | `CODE_07 - Pick up card, special condition (fraud account)` | Zatrzymaj kartę, próba oszustwa. |
| `CODE_08` | `CODE_08 - Honor with ID` | Karta obsługiwana jedynie z dowodem osobistym  |
| `CODE_10` | `CODE_10 - Partial approval` | Częściowe zatwierdzenie |
| `CODE_11` | `CODE_11 - Approved (V.I.P)` | Płatność zaakceptowana  |
| `CODE_12` | `CODE_12 - Invalid transaction` | Nieprawidłowa transakcja |
| `CODE_13` | `CODE_13 - Invalid amount` | Limit dla transakcji internetowych został przekroczony. |
| `CODE_14` | `CODE_14 - Invalid account number (no such number)` | Nieprawidłowy numer konta (nie ma takiego rachunku) |
| `CODE_15` | `CODE_15 - Invalid issuer/No such issuer (first 8 digits of account number do not relate to an issuing identifier)` | Nie ma takiego wydawcy |
| `CODE_19` | `CODE_19 - Re-enter transaction` | Wprowadź transakcję ponownie |
| `CODE_20 `| `CODE_20 - Invalid response`| Nieprawidłowa odpowiedź |
| `CODE_21` | `CODE_21 - No action taken`| Nie podjęto żadnych działań |
| `CODE_30` | `CODE_30 - Message format error` | Błąd formatu wiadomości |
| `CODE_33` | `CODE_33 - Expired Card - Pick Up` | Karta utraciła ważność - karta zgubiona albo zgłoszona  |
| `CODE_34` | `CODE_34 - Suspected Fraud - Pick Up`| Podejrzenie oszustwa |
| `CODE_35` | `CODE_35 - Contact Acquirer - Pick Up`| Skontaktuj się z dostawcą |
| `CODE_39` | `CODE_39 - No credit account` | Brak rachunku karty kredytowej |
| `CODE_40` | `CODE_40 - Requested Function Not Supported`| Żądana funkcja nie jest obsługiwana |
| `CODE_41` | `CODE_41 - Lost card, pick up (fraud account)` | Karta złoszona jako zagubiona |
| `CODE_43` | `CODE_43 - Pickup card (stolen card)` | Karta zgloszona jako skradziona |
| `CODE_51` | `CODE_51 - Insufficient funds` | Brak środków na karcie.|
| `CODE_52` | `CODE_52 - No checking account` | Brak rachunku karty kredytowej |
| `CODE_53` | `CODE_53 - No savings account` | Brak rachunku karty |
| `CODE_54` | `CODE_54 - Expired card` | Karta wygasła lub Płacący podał niepoprawne daty ważności karty. |
| `CODE_56` | `CODE_56 - No Card Record` | Brak zapisu karty |
| `CODE_57` | `CODE_57 - Card disabled for e-commerce or cross-border transactions` | Karta wyłączona dla e-commerce lub transakcji transgranicznych |
| `CODE_59` | `CODE_59 - Suspected fraud` | Podejrzenie oszustwa |
| `CODE_61` | `CODE_61 - Exceeds approval amount` | Przekroczony limit karty |
| `CODE_62` | `CODE_62 - Restricted card / Country exclusion table` | Ograniczenie karty ( karta nieważna w tym regionie lub kraju) |
| `CODE_63` | `CODE_63 - Security violation (source is not correct issuer)` | Naruszenie bezpieczeństwa |
| `CODE_64` | `CODE_64 - Transaction does not fulfill AML requirement` | Transakcja nie spełnia wymogu AML |
| `CODE_65` | `CODE_65 - Exceeds withdrawal frequency limit` | Przekroczenie limitu ilości transakcji|
| `CODE_75` | `CODE_75 - Allowable number of PIN-entry tries exceeded` | Przekroczono dopuszczalną liczbę prób wprowadzenia kodu PIN |
| `CODE_83` | `CODE_83 - Fraud/Security (Mastercard use only)` | Oszustwo/bezpieczeństwo (tylko do użytku Mastercard) |
| `CODE_90` | `CODE_90 - Destination not available` | Miejsce docelowe niedostępne |
| `CODE_93` | `CODE_93 - Card disabled for e-commerce transactions` | Karta wyłączona dla transakcji e-commerce |
| `CODE_99` | `CODE_99 - Authorization error - default` | Błąd autoryzacji |
| `CODE_114` | `CODE_114 - No account of type requested` | Brak żądanego konta typu |
| `CODE_570` | `CODE_570 - 3D Secure authentication failed` | Uwierzytelnianie 3D Secure nie powiodło się |
| `CODE_581` | `CODE_581 - Exceeded limit of unsuccessful transaction attempts for the specified card` | Przekroczony limit nieudanych prób transakcji dla określonej karty |
| `CODE_AC` | `CODE_AC - Account closed (do not try again)` | Konto zamknięte (nie próbuj ponownie) |
| `CODE_N0` | `CODE_N0 - Unable to authorize / Force STIP` | Niepowodzenie autoryzacji karty |
| `CODE_N8` | `CODE_N8 - Transaction amount exceeds preauthorized approval amount` | Zbyt wysoka kwota transakcji |
| `CODE_P1` | `CODE_P1 - Over daily limit (try again later)` | Przekroczono dzienny limit |
| `CODE_P9` | `CODE_P9 - Enter lesser amount` | Wprowadź mniejszą kwotę |
| `CODE_PF` | `CODE_PF - Possible fraud (do not try again)` | Podejrzenie oszustwa (nie próbuj ponownie) |
| `CODE_Q1` | `CODE_Q1 - Card Authentication failed` | Niepowodzenie autoryzacji karty |
| `CODE_SD` | `CODE_SD - Soft decline (strong authentication required)` | Miękkie odrzucenie (wymagane silne uwierzytelnienie) |
| `CODE_T3` | `CODE_T3 - Card not supported` | Karta nie obsługiwana |
| `CODE_T5` | `CODE_T5 - Card inactive or closed (updated information needed)` | Karta nieaktywna lub zamknięta (potrzeba zaktualizować informacje) |
| `CODE_T8` | `CODE_T8 - Invalid account` | Nieważne konto |
| `CODE_Z3` | `CODE_Z3 - Unable to go online` | Błąd komunikacji z wydawcą |

## Kody odpowiedzi dostawcy - sandbox

> W środowisku sandbox możliwa jest symulacja zwracanego kodu poprzez ustawienie odpowiedniej kwoty wraz z wybraną kartą zwracającą status **rejected (odrzucona)**

| StatusCode     | StatusCodeDescription  | Opis |
|-----------|:---------------------------:|-------|
| `CODE_05` | `CODE_05 - Do not honor`    | Domyślny kod odpowiedzi, istnieje możliwość wywołania go wykonując transakcję odrzuconą na kwotę 15 groszy |
| `CODE_51` | `CODE_51 - Insufficient funds` | Domyślny kod odpowiedzi, istnieje możliwość wywołania go wykonując transakcję odrzuconą na kwotę 151 groszy |
| `CODE_114`| `CODE_114 - No account of type requested` | Domyślny kod odpowiedzi, istnieje możliwość wywołania go wykonując transakcję odrzuconą na kwotę 1141 groszy |
| `CODE_AC` | `CODE_AC - Account closed (do not try again)` | Domyślny kod odpowiedzi, istnieje możliwość wywołania go wykonując transakcję odrzuconą na kwotę 14143 groszy |