Існує три типи помилок:
- Помилка під час валідації.
- Помилка під час обробки платежу (процесінгу).
- Системна помилка.
Валідація
HTTP status - 400
{
"uuid": "11a13368-b7b5-486e-af6d-9dc99b182c66",
"type": "validation",
"errors": [
{
"message": "Too small: expected string to have >=1 characters",
"code": "too_small",
"path": "client_phone"
},
{
"message": "invalid phone",
"code": "custom",
"path": "client_phone"
}
]
}
Обробка
HTTP status - 400
{
"uuid": "b8d0b376-524c-43e1-afc8-84a7d4bfa1dc",
"type": "processing",
"error": "Session not found or allowed usage time expired!",
"code": "SessionNotFoundError"
}
Повідомлення про помилки обробки платежу (процесінгу)
| Код помилки (resultCode) | Опис українською | Опис англійською |
|---|---|---|
| 100 | Операція виконана успішно. | Successful. |
| 101 | Операція виконана успішно на часткову суму. | Partially successful. |
| 102 | Операція виконана успішно тільки на суму покупки. | Successful, purchase only. |
| 200 | Операція відхилена емітентом або платіжною системою. Зверніться до банку-емітенту. | External decline. Call to issuer. |
| 201 | Карта втрачена або вкрадена. | Lost or stolen card. |
| 202 | Досягнуто ліміт по сумі або кількості операцій. Зверніться до банку-емітенту. | Uses limit exceeded. Call to issuer. |
| 203 | Невірний номер картки. | Invalid card. |
| 204 | Операції по карті обмежені емітентом. Зверніться до банку-емітенту. | Restricted or invalid card status. Call to issuer. |
| 205 | Авторизація неможлива. Зверніться до банку-емітента. | Unable to authorize. Call to issuer |
| 206 | Недостатньо коштів. | Insufficient funds. |
| 207 | Невірне значення CVV. | Bad CVV. |
| 208 | Невірне значення CAVV. | Bad CAVV. |
| 209 | Сплив строк дії картки. | Expired card. |
| 210 | Рахунок клієнта не знайдено або вказано невірно. | Ineligible account or Account not found. |
| 211 | Інвойс сплачено. Відміна неможлива. | Unable to cancel. Invoice already paid. |
| 212 | Інвойс очікує на оплату. | Pending invoice. |
| 213 | Masterpass недоступний. Спробуйте пізніше. | Masterpass unavailable. Try again later. |
| 214 | Masterpass недоступний. Спробуйте пізніше. | Invalid merchant or service provider. |
| 215 | Некоректний торговець або сервіс-провайдер | Dynamic СVV expired. |
| 216 | Термін дії динамічного СVV вичерпано. | No permission for this operation. |
| 217 | P2P Debit по картам Банків-нерезидентів заборонено. | P2P Debit on cards of nonresident banks is prohibited. |
| 301 | Операція не підтримується. | Transaction not supported. |
| 302 | Сесія не знайдена або неактивна. | Session not found or inactive. |
| 303 | Не знайдена оригінальна транзакція. | Original transaction not found. |
| 304 | Невірні параметри або код транзакції. | Ineligible transaction or Invalid transaction code. |
| 305 | Помилка формату даних. | Format error. |
| 306 | Невірна сума. | Invalid amount. |
| 307 | Помилка в реквізитах платежу. | Personal information input error. |
| 308 | Дублювання транзакції. | Duplicate transaction. |
| 309 | Перевищено еквайринговий ліміт. Зверніться до банку-еквайєру. | Acquirer limit exceeded. Call to acquirer. |
| 310 | Відбувся тайм-аут. | Timeout. |
| 311 | Невірний ідентифікатор терміналу. | Invalid terminal identifier. |
| 312 | Цей тип карток не підтримується. | Card not supported. |
| 313 | Транзакція не оброблена. | Transaction not processed. |
| 314 | Потрібно ввести CVV-код. | CVV input required. |
| 315 | Потрібно обрати тип оплати частинами. | Installment confirmation required. |
| 316 | Сесія прострочена. | Session expired. |
| 317 | Операція не підтримує протокол 3DS 1.0. | Operation does not support protocol 3DS 1.0. |
| 318 | Фінансова операція не знайдена. | Operation not found. |
| 319 | У запиті виявлено подвоєння комісії. | Duplicate Fee. |
| 320 | Помилка розшифрування криптограми. | Cryptogram not decrypted, use new cryptogram. |
| 321 | Знижка не може дорівнювати нулю. | Discount amount cannot be 0. |
| 400 | Потрібна верифікація 3DS. | 3DS Verify required. |
| 401 | Потрібна верифікація LookUp. | Lookup Verify required. |
| 402 | Ліміт кредитування перевищено. | Credit limit exceeded. |
| 403 | Невірний OTP. | Invalid OTP. |
| 404 | Токен не знайдено. | Token not found. |
| 405 | Перевищено дозволену кількість спроб введення OTP. | OTP tries limit was exceeded. |
| 406 | Операція виконується. Запросіть статус пізніше. | Transaction is processing. Try to request status later. |
| 407 | Неуспішна верифікація. | Client verification unsuccessful. |
| 408 | Облікові дані не знайдено. | Credentials not found. |
| 409 | Заборонений тип операції. Зверніться до служби підтримки. | Restricted operation type. |
| 410 | Країну не знайдено. | Country not found. |
| 411 | Країна заборонена. | Country is prohibited. |
| 412 | Валюту не знайдено. | Currency not found. |
| 413 | Валюта заборонена. | Currency is prohibited. |
| 414 | Курс обміну не знайдено. | Exchange rate not found. |
| 415 | Лише картки On-Us. | On-Us cards only. |
| 416 | Динамічний MCC вимкнено, транзакція відхилена. | Dynamic MCC is disabled, transaction is rejected. |
| 417 | Некоректний MCC, транзакція відхилена. | Invalid MCC, transaction declined. |
| 418 | Операція відхилена. Токен належить іншому мерчанту. | Operation declined. The token is owned by another merchant. |
| 500 | Системна помилка. Зверніться до служби підтримки. | System error. Call to support. |
| 501 | Термінал тимчасово заблоковано. | Terminal temporarily blocked. |
| 502 | Неавторизоване використання. | Unauthorized usage. |
| 900 | Щось трапилось. Зверніться до служби підтримки. | Unexpected error. Call to support. |
Системна помилка
HTTP status - 500
{
"uuid": "9d7d7d20-3a33-4661-a579-de459ff1add6",
"type": "fatal",
"error": "system error. Please try again later or contact support."
}
{
"type": "fatal",
"uuid": "6f23c6ef-ХХХХ-ХХХХ-ХХХХ-0574a6a2bfee",
“errors”: {
"en": "System error. Please try again later or contact support."
}
}
Повідомлення про системні помилки
| Код помилки | Опис українською | Опис англійською |
|---|---|---|
| SystemError | Виникла системна помилка. Повторіть спробу пізніше або зверніться до служби підтримки | System error. Please try again later or contact support |
| PublicQueryError | Дані неправильні | Invalid data |
| InvalidSignError | Невірний підпис | Invalid signature |
| CorruptedRequestError | Запит невiрний | Request is incorrect |
| SessionNotFoundError | Сесію не знайдено або дозволений час її використання сплив! | Session not found or allowed usage time expired! |
| IpAddressNotRegisteredError | Ця IP-адреса не зареєстрована на продавця | Ip-address not registered for this merchant error |
| HoldMixError | Неможливо змiшувати використання холда в рiзних операцiях однiєї сесiї | It is impossible to mix the use of a hold in different operations of one session |
| WrongAmountError | Передана невiрна сума операцiї | Transferred operation amount is incorrect |
| ContragentNotFoundError | Контрагента не знайдено | Contragent not found |
| UnknownPaymentError | Невідома помилка платіжної системи | Unknown payment system error |
| WrongSessionStatusError | Невiрний статус сесії | Invalid session status |
| ExpressWaybillCreationError | Помилка створення експрес-накладної | Error creating express waybill |
| DeliveryPriceCalculationError | Помилка при розрахунку вартостi доставки | Error in calculating delivery cost |
| WarehouseCapacityError | Обране вiддiлення не пiдтримує такий об`єм | The selected branch does not support such a volume |
| Fatal | Виникла системна помилка. Повторіть спробу пізніше або зверніться до служби підтримки. | System error. Please try again later or contact support. |