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

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

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

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

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

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

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

За проміжних і успішних фінальних статусів резолюція отримує код 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, номер транзакції, що надається еквайєром) використовуються тільки для карткових розрахунків.