# Коди помилок

**Перераховані нижче коди помилок не свідчать про успішність або неуспішність транзакцій**

Для перевірки статусу транзакції необхідно:

* очікувати callback
* перевірити статус транзакції по OPERATION\_ID
* перевірити статус транзакції по merchantRequestId

<table data-full-width="true"><thead><tr><th width="135.24999999999997">http code</th><th>msgType</th><th>msgCode</th><th>msgText</th></tr></thead><tbody><tr><td>200</td><td>ERROR</td><td>b_terminal_not_found</td><td>@Payment terminal not found</td></tr><tr><td><br></td><td>ERROR</td><td>b_merchant_not_found</td><td>@Merchant not found</td></tr><tr><td><br></td><td>ERROR</td><td>b_reverse_transaction_failed</td><td>@Failed to reverse transaction</td></tr><tr><td><br></td><td>ERROR</td><td>b_payment_invalid_refund_amount</td><td>@Payment invalid refund amount</td></tr><tr><td><br></td><td>ERROR</td><td>b_phys_transaction_not_found</td><td>@Phys transaction not found</td></tr><tr><td><br></td><td>ERROR</td><td>b_cannot_process_logic_transaction</td><td>@Cannot process logic transaction</td></tr><tr><td><br></td><td>ERROR</td><td>b_authorize_transaction_failed</td><td>@Failed to authorize transaction</td></tr><tr><td><br></td><td>ERROR</td><td>b_initiate_transaction_failed</td><td>@Failed to initiate transaction</td></tr><tr><td><br></td><td>ERROR</td><td>b_payment_logic_transaction_not_found</td><td>@Payment logic transaction not found</td></tr><tr><td><br></td><td>ERROR</td><td>b_explicit_payment_execution_not_supported</td><td>@Payment type doesn't support explicit execution</td></tr><tr><td><br></td><td>ERROR</td><td>b_payment_not_found</td><td>@Payment not found</td></tr><tr><td><br></td><td>ERROR</td><td>b_operation_not_found</td><td>@Operation not found</td></tr><tr><td><br></td><td>ERROR</td><td>b_payment_refund_not_supported</td><td>@Payment type doesn't support refund</td></tr><tr><td>200</td><td>ERROR</td><td>b_invalid_request</td><td>Невірний запит</td></tr><tr><td>200</td><td>ERROR</td><td>b_unsupported_payment_system</td><td>Платіжна система не підтримується</td></tr><tr><td>200</td><td>ERROR</td><td>b_validation_card_expiration_date_and_security_code</td><td>Значення повинно складатися з 7 цифр.</td></tr><tr><td>200</td><td>ERROR</td><td>b_invalid_pan_format</td><td>Неправильний формат повного номера картки</td></tr><tr><td>200</td><td>ERROR</td><td>b_payment_invalid_refund_status</td><td>@Payment invalid refund status</td></tr><tr><td>200</td><td>ERROR</td><td>b_validation_card_expiration_date</td><td>Значення повинно складатися з 4 цифр</td></tr><tr><td>200</td><td>ERROR</td><td>b_encryptor_failed_decrypt_message</td><td>Не вдалося розшифрувати повідомлення</td></tr><tr><td>200</td><td>ERROR</td><td>b_virtual_device_not_found</td><td>Віртуальний пристрій не знайдено</td></tr><tr><td>200</td><td>ERROR</td><td>b_refresh_token_absent</td><td>Токен оновлення відсутній</td></tr><tr><td>200</td><td>ERROR</td><td>b_err_missing_recipient_id</td><td>Не вказано recipientItn або recipientPassport. Один із параметрів є обов’язковим.</td></tr><tr><td>200</td><td>ERROR</td><td>b_err_invalid_itn_format</td><td>Невірний формат recipientItn. Має містити лише 10 цифр.</td></tr><tr><td>200</td><td>ERROR</td><td>b_overload_error</td><td>@Overload error</td></tr><tr><td>400</td><td>ERROR</td><td>b_duplicate_field_value</td><td>Value {data} must be unique</td></tr><tr><td>400</td><td>ERROR</td><td>b_request_is_not_correct</td><td>Запит не в правильному форматі</td></tr><tr><td>400</td><td>ERROR</td><td>b_error_parse_json</td><td>JSON parse error: {info}</td></tr><tr><td>400</td><td>ERROR</td><td>b_txn_not_allowed</td><td>@transaction type is not allowed for this Merchant</td></tr><tr><td>400</td><td>ERROR</td><td>b_failed_to_get_apple_pay_session</td><td>@Failed to get apple pay session</td></tr><tr><td>400</td><td>ERROR</td><td>b_user_merchant_request_mismatch</td><td>@User's merchant ID doesn't match the merchant ID from request</td></tr><tr><td>401</td><td>ERROR</td><td>b_expired_token</td><td>@Token Expired</td></tr><tr><td><br></td><td>ERROR</td><td>b_unknown_device</td><td>@Unknown Device</td></tr><tr><td>401</td><td>ERROR</td><td>b_used_token</td><td>Використаний токен</td></tr><tr><td>401</td><td>ERROR</td><td>b_auth_token_expired</td><td>Термін дії токена аутентифікації закінчився</td></tr><tr><td>401</td><td>ERROR</td><td>b_previous_auth_token_expired</td><td>@Previous Auth Token Expired</td></tr><tr><td>404</td><td>ERROR</td><td>b_service_unavailable</td><td>@Service '{service}' unavailable</td></tr><tr><td>404</td><td>ERROR</td><td>payment_operation_not_found</td><td>@Payment operation is not found.</td></tr><tr><td>404</td><td>ERROR</td><td>b_hpp_order_not_found</td><td>@The HPP order not found</td></tr><tr><td>404</td><td>ERROR</td><td>b_merchant_balances_not_found</td><td>@Balance not found.</td></tr><tr><td>500</td><td>ERROR</td><td>b_hpp_order_expired</td><td>@The HPP order is expired</td></tr><tr><td>500</td><td>ERROR</td><td>b_unknown_error</td><td>Невідома помилка</td></tr><tr><td>503</td><td>ERROR</td><td>b_server_is_overloaded</td><td><p>@Server is overloaded</p><p>(необхідно повторити спробу запиту пізніше)</p></td></tr></tbody></table>

#### Приклад відповіді з помилкою

```json
{
    "requestId": "29a36a0a-5926-11ed-9b6a-0242ac120002",
    "serviceId": "api-gateway",
    "msgCode": "b_used_token",
    "msgType": "ERROR",
    "msgText": "@Used Token Alert!",
    "isLocalized": false,
    "msgAttrs": {},
    "errorCauses": []
}

```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.merchant.alb.ua/dovidniki/kodi-pomilok.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.