Перейти к содержанию

Обробка платежу

Перелік статусів

Статус платежу визначає етап проведення транзакції. Статус може бути проміжним та фінальним.

Послідовність зміни статусів

Статус Фінальний Значення
created Початковий статус після створення інвойсу, процесування не розпочато. У відповіді має бути повернено 201 (Created) статус-код HTTP, що означає успішне створення інвойсу
expired Час очікування обробки платіжного інвойсу перевищив ліміт (заданий у налаштуваннях виплати властивістю invoice_lifetime).
process_pending Результат обробки транзакції невідомий (наприклад, не отримано відповіді платіжного провайдера) і також може бути невідомий протягом тривалого часу.
processed ✔ * Підтверджує успішне процесингу платежу.
process_failed ✔** Значить збій процесингу. Статус може бути присвоєний у разі виникнення помилки, що повторюється, і збої отримання відповіді
refund_pending Результат повернення невідомий (наприклад, не отримано відповіді платіжного провайдера) і також може бути невідомий протягом тривалого часу
partially_refunded Повернення зроблено на суму, меншу за суму, зазначену в інвойсі.
refunded Платіж повністю повернено.
refund_failed Повернення завершилося неуспішно.
charged_back Платіж у повному обсязі повернуто платнику банком-емітентом у порядку чарджбеку.
partially_charged_back Платіж частково повернуто платнику банком-емітентом у порядку чарджбеку.

* — Статус вважається фінальним, однак після нього платіж може бути відхилений з додаткових причин або відправлений на повернення (рефанд або чарджбек)

** — Статус визначається як фінальний після досягнення максимальної кількості спроб провести транзакцію (за замовчуванням — 5)

Перелік резолюцій

Код резолюції – це уточнення статусу транзакції.

За проміжних і успішних фінальних статусів резолюція отримує код ok. За неуспішних фінальних статусів можуть бути отримані наступні резолюції:

Код резолюції Опис
ok Запит завершився: відноситься до успішних і неуспішних транзакцій
antifraud_error Транзакція заблокована службою безпеки емітента або еквайера
card_status_is_restricted_for_provider Використання картки обмежено еквайером
client_auth_failed Картка клієнта не пройшла авторизацію/відмова авторизації
customer_is_blocked Клієнт заблокований службою підтримки
card_expired Закінчився або невірно введений термін дії картки
declined_error Відмова емітента (без деталізації докладної причини)
duplicated_transactio Дублювання транзакції
expired Кинута транзакція на моменті вводу карткових даних, натискання кнопки оплати або при проходженні перевірки 3D-Secure
functionality_is_not_permitte Відмова емітента (обмеження по картці)
gateway_internal_error Внутрішня помилка процесингу
general_fatal_error Відмова проведення транзакції через труднощі
insufficient_funds Недостатньо коштів на карті клієнта
invalid_amount Неможливо обробити суму через обмеження/ліміти емітента
invalid_card Картка недійсна, закрита або заблокована
invalid_card_status Обмеження по використанню картки
invalid_cvv Невірний CVV
invalid_details Деталі транзакції не пройшли валідацію на стороні еквайера
issuer_unavailable Емітент карти недоступний
limit_violation Відмова емітента: перевищено ліміт по картці/клієнту
lost_or_stolen_card Карта втрачена або вкрадена
processing_error Помилка процесингу
provider_fatal_error Помилка на стороні еквайера
routing_error Платіж відхилений налаштуваннями роутингу
timeout Отриманий таймаут на одному із етапів проведення транзакції
blocked_by_firewall Транзакція заблокована антифрод-системою

Рівень деталізації причини неуспішності транзакції залежить від рівня інформаційної відкритості постачальників послуг (PSP) та банків-еквайєрів (для транзакцій за картковими методами).

Зверніть увагу!

  • Перелік резолюцій може бути розширено.
  • Отримання резолюції, відмінної від зазначеної у переліку, має впливати на процесинг транзакції, оскільки цей атрибут має інформаційний характер.
  • Фінальність та успішність транзакції визначається виключно статусом платежу (status).

Ідентифікація платежу

На різних етапах прийому платежу ідентифікатори обробляються з різним найменуваннями. Зв'язки між ними відображені на схемі нижче.

Зв'язки ідентифікаторів

Note

Receiver Reference Number (RRN, номер одержувача транзакції) і Acquirer Reference Number (ARN, номер транзакції, що надається еквайєром) використовуються тільки для карткових розрахунків.