Статуси операцій

Повний реєстр значень status і status_code, які повертає API. Про структуру відповіді з помилкою див. Обробка помилок.

Основні статуси

Статус	Опис	Дія
init	Транзакція створена, обробка ще не розпочата	Очікуйте наступний статус
pending	Транзакція в обробці	Очікуйте callback
success	Транзакція успішна	Видайте замовлення
failure	Транзакція неуспішна	Розберіть причину за status_code

Коди статусів (status_code)

Успішні операції

Код	Опис	Дія
transaction_successful	Транзакція успішна	Видайте замовлення
transaction_created	Операція створена успішно	Продовжуйте за сценарієм оплати
subscription_successful	Підписка успішна	Активуйте доступ
unsubscribed_successfully	Відміна підписки успішна	Зафіксуйте відміну

Очікування дій

Код	Опис	Дія
3ds_required	Необхідна 3DS перевірка	Перенаправте користувача на 3DS
confirmation_required	Необхідне підтвердження	Викличте confirm
confirm_required	Те саме, застаріла назва	Викличте confirm
waiting_for_complete	Очікує завершення (списання)	Викличте confirm
waiting_for_redirect	Очікує редирект для 3DS	Перенаправте користувача
waiting_for_verification	Очікує верифікації	Завершіть верифікацію картки
pending	Платіж в обробці	Очікуйте callback
additional_information_is_pending	Запит в обробці	Очікуйте callback

Помилки авторизації

Код	Опис	Дія
authorization_error	Помилка авторизації	Перевірте ключі API
authorization_failed	Помилка авторизації	Перевірте ключі API
access_error	Помилка верифікації даних	Перевірте дані запиту
access_not_allowed	Доступ заборонено	Зверніться до підтримки
public_key_not_found	Некоректний ключ	Перевірте ключі API

Помилки картки

Код	Опис	Дія
card_expired	Строк дії картки минув	Попросіть іншу картку
card_is_lost_or_stolen	Картка втрачена/вкрадена	Попросіть звернутися до банку
card_not_found	Картку не знайдено в гаманці	Попросіть додати картку заново
card_not_supported	Тип картки не підтримується	Попросіть іншу картку
card_type_is_not_supported	Тип картки не підтримується	Попросіть іншу картку
card_has_constraints	Операція по картці заборонена	Попросіть іншу картку
card_branch_is_blocked	Картка заблокована	Попросіть іншу картку
card_branch_daily_limit_reached	Перевищено денний ліміт	Попросіть іншу картку
card_bin_not_found	БІН не знайдено	Зверніться до підтримки
card_verification_required	Потрібна верифікація картки — виникає при оплаті карткою з гаманця	Завершіть верифікацію
invalid_card_data	Некоректні дані картки	Попросіть перевірити дані картки
invalid_card_token	Невалідний токен картки	Створіть новий токен
wrong_card_number	Некоректний номер картки	Попросіть перевірити номер
wrong_cvv	Некоректний CVV	Попросіть перевірити CVV
cvv_is_required	Потрібен CVV	Попросіть ввести CVV
payment_card_has_invalid_status	Картка неактивна	Попросіть іншу картку

Помилки лімітів

Код	Опис	Дія
insufficient_funds	Недостатньо коштів	Попросіть іншу картку
daily_card_usage_limit_reached	Перевищено денний ліміт картки	Попросіть іншу картку
completion_limit_reached	Перевищено ліміт операцій	Зверніться до підтримки
transaction_amount_limit	Перевищено ліміт суми	Зменшіть суму або зверніться до підтримки
transaction_limit_exceeded	Перевищено ліміт операцій	Зверніться до підтримки
reached_the_limit_of_attempts_for_ip	Перевищено спроби з IP	Зачекайте перед повторною спробою

Помилки транзакцій

Код	Опис	Дія
transaction_declined	Операція відхилена банком	Попросіть іншу картку
transaction_rejected	Транзакція відхилена	Попросіть іншу картку
transaction_not_found	Транзакція не знайдена	Перевірте external_id або id
transaction_already_paid	Транзакція вже оплачена	Перевірте дублікати
transaction_cannot_be_processed	Помилка обробки	Повторіть із тим самим external_id
transaction_not_supported	Операція не підтримується	Зверніться до підтримки
transaction_is_canceled_by_payer	Скасовано платником	Запропонуйте оплатити знову
transaction_is_not_recurring	Операція не рекурентна	Перевірте налаштування рекурентних платежів
transaction_success_primary_not_found	Не знайдено холд	Перевірте external_id первинної операції
action_already_done	Дублікат запиту	Візьміть результат попереднього запиту
action_not_allowed	Операція заборонена	Зверніться до підтримки

Помилки даних

Код	Опис	Дія
invalid_data	Помилка в даних	Перевірте обов’язкові поля
invalid_request_body	Невалідний формат	Перевірте JSON запиту
invalid_currency	Невалідна валюта	Використайте код ISO 4217
invalid_token	Невалідний токен	Створіть новий токен
invalid_transaction_amount	Невалідна сума	Перевірте amount
invalid_transaction_status	Невалідний статус	Перевірте поточний статус операції
invalid_transaction_type	Невалідний тип	Перевірте тип операції
invalid_phone_number	Невалідний номер телефону	Перевірте формат номера
invalid_recipient_name	Невалідне ім’я отримувача	Перевірте ім’я отримувача
invalid_verification_code	Невалідний код з SMS	Попросіть ввести код повторно
wrong_amount	Некоректна сума	Перевірте amount
wrong_account_number	Некоректний номер рахунку	Перевірте номер рахунку
wrong_authorization_code	Некоректний SMS код	Попросіть ввести код повторно
wrong_pin	Некоректний PIN	Попросіть ввести PIN повторно
wrong_sms_password	Некоректний SMS код	Попросіть ввести код повторно

Помилки платіжних методів

Код	Опис	Дія
payment_method_not_found	Метод не знайдено	Перевірте тип методу
payment_method_not_allowed	Метод заборонено	Зверніться до підтримки
payment_method_already_confirmed	Вже підтверджено	Перевірте дублікати
payment_system_not_supported	Система не підтримується	Попросіть іншу картку
payment_was_refunded	Платіж повернено	Перевірте історію повернень
payment_settings_not_found	Налаштування не знайдено	Зверніться до підтримки
3ds_not_supported	3DS не підтримується	Зверніться до підтримки
recurring_transactions_not_allowed	Рекурентні платежі заборонені	Зверніться до підтримки
preauth_not_allowed	Preauth заборонено	Зверніться до підтримки

Помилки підписок

Код	Опис	Дія
plan_not_found	План не знайдено	Перевірте ID плану
plan_not_active	План не активний	Активуйте план у бізнес кабінеті
subscription_not_found	Підписка не знайдена	Перевірте ID підписки
subscription_not_active	Підписка не активна	Перевірте стан підписки

Помилки користувачів

Код	Опис	Дія
user_not_found	Користувача не знайдено	Перевірте ідентифікатор користувача
customer_auth_not_found	Користувач не авторизований	Передайте заголовок X-CUSTOMER-AUTH
customer_auth_token_expired_or_invalid	Токен користувача невалідний	Попросіть увійти повторно
customer_id_not_passed	ID користувача не передано	Передайте customer.id
customer_profile_not_found	Профіль не знайдено	Перевірте customer.id
wallet_not_configured	Гаманець не налаштовано	Зверніться до підтримки
sender_info_required	Потрібна інформація про платника	Заповніть дані платника
missed_payout_method_data	Потрібні дані отримувача	Заповніть дані способу виплати
receiver_info_error	Некоректні дані отримувача	Перевірте дані отримувача

Помилки магазину

Код	Опис	Дія
store_is_blocked	Магазин заблоковано	Зверніться до підтримки
store_is_not_active	Магазин не активний	Зверніться до підтримки
terminal_not_found	Термінал не знайдено	Зверніться до підтримки
fee_not_found	Комісії не налаштовані	Зверніться до підтримки
restricted_ip	IP заблоковано	Перевірте список дозволених IP

Помилки повернень

Код	Опис	Дія
incorrect_refund_sum_or_currency	Некоректна сума/валюта повернення	Перевірте суму та валюту
confirm_amount_cannot_be_more_than_the_transaction_amount	Сума confirm більша за транзакцію	Зменшіть суму підтвердження
confirmation_timeout	Таймаут підтвердження	Перевірте статус, тоді повторіть

Системні помилки

Код	Опис	Дія
internal_error	Загальна помилка	Повторіть із тим самим external_id
request_failed	Помилка запиту	Повторіть із тим самим external_id
timeout	Сервер не відповідає	Повторіть із тим самим external_id
failed_to_create_transaction	Помилка створення	Повторіть із тим самим external_id
failed_to_finish_transaction	Помилка завершення	Перевірте статус, тоді повторіть
failed_to_load_wallet	Помилка гаманця	Повторіть запит
failed_to_send_sms	Помилка SMS	Повторіть запит
failed_to_verify_card	Верифікація невдала	Повторіть верифікацію
session_expired	Сесія закінчилась	Почніть оплату заново
token_does_not_exist	Токен не існує	Створіть новий токен
country_not_supported	Країна не підтримується	Зверніться до підтримки
currency_rate_not_found	Курс не знайдено — виникає при конвертації валюти	Зверніться до підтримки
no_discount_found	Знижка не знайдена	Перевірте параметри знижки
pin_tries_exceeded	Перевищено спроби PIN	Почніть оплату заново
anti_fraud_check	Заблоковано безпекою	Зверніться до підтримки