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

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

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

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

Статус	Фінальний	Значення
`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`	Транзакція заблокована антифрод-системою
`auth_3ds_required`	Необхідне проходження 3DS-перевірки
`auth_otp_required`	Необхідне проходження OTP-перевірки
`auth_fatal_error`	Остаточна помилка авторизації
`card_expired`	Закінчився термін дії картки
`card_3ds_enrolled`	Використана картка з обов'язковою 3DS-перевіркою
`card_blocked_by_invalid_pin`	Картка заблокована, оскільки використано некоректний PIN-код
`card_lost`	Картка втрачена
`card_not_3ds_enrolled`	Картка не підтримує 3DS-перевірку
`card_stolen`	Картка втрачена
`card_restricted`	Транзакції по даній картці обмежені
`card_restricted_by_acquirer`	Транзакції по цій картці обмежені еквайєром
`invalid_card_type`	Некоректний тип картки
`card_usage_limit_violation`	Перевищення ліміту спроб авторизації картки
`card_usage_issuer_limit_violation`	Перевищення ліміту спроб авторизації картки, встановленого емітентом
`card_verification_failed`	Помилка верифікації картки
`client_auth_failed`	Помилка авторизації користувача
`customer_blocked`	Користувачеві заборонено проведення транзакцій даного типу
`general_decline`	Загальна відмова
`transaction_expired`	Сплив термін дії транзакції
`fatal_decline`	Остаточна відмова
`fatal_error`	Остаточна відмова проведення транзакції
`fatal_invalid_card`	Картка не пройшла валідацію, повторне використання картки - заборонено
`forced_captured`	Процес фіналізований вручну
`insufficient_funds`	Недостатньо коштів
`invalid_3ds_code`	Неправильно введено код 3DS-перевірки
`invalid_amount`	Некоректно введено суму транзакції
`invalid_card`	Картка не пройшла валідацію
`invalid_cardholder`	Ім'я власника картки не пройшло валідацію
`invalid_cvv`	Невірний CVV
`invalid_details`	Деталі транзакції не пройшли валідацію
`invalid_expire_date`	Невірний термін дії картки
`invalid_otp_code`	Невірно введено код OTP-перевірки
`issuer_decline`	Загальна відмова емітента
`issuer_unavailable`	Емітент не доступний
`limit_violation`	Ліміт перевищено
`unable_determine_3ds_enrolment`	Неможливо визначити входження картки в 3DS-систему
`unknown`	Невідома помилка

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

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

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

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

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

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

Note

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