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

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

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

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

Статус	Фінальний	Значення
`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`	✔	Платіж частково повернуто платнику банком-емітентом у порядку чарджбеку.
`verified`	✔	Платіж успішно підтверджено, і він готовий до подальшої обробки.
`verify_failed`	✔	Перевірка платежу не вдалася; обробка не може бути продовжена.
`authorize_pending`		Запит на авторизацію ініційовано, очікується відповідь.
`authorized`		Оплата була успішно авторизована.
`authorize_failed`	✔	Запит на авторизацію було відхилено або не виконано.
`void_pending`		Запит на анулювання було ініційовано.
`voided`	✔	Блокування авторизації було успішно скасовано.

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

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

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

Код резолюції	Опис
`ok`	Запит завершився: відноситься до успішних і неуспішних транзакцій
`antifraud_error`	Транзакція заблокована службою безпеки емітента або еквайера
`card_status_is_restricted_for_provider`	Використання картки обмежено еквайером
`client_auth_failed`	Картка клієнта не пройшла авторизацію/відмова авторизації
`customer_is_blocked`	Клієнт заблокований службою підтримки
`card_expired`	Закінчився або невірно введений термін дії картки
`declined_error`	Відмова емітента (без деталізації докладної причини)
`duplicated_transaction`	Дублювання транзакції
`expired`	Кинута транзакція на моменті вводу карткових даних, натискання кнопки оплати або при проходженні перевірки 3D-Secure
`functionality_is_not_permitted`	Відмова емітента (обмеження по картці)
`gateway_internal_error`	Внутрішня помилка процесингу
`general_fatal_error`	Відмова проведення транзакції через труднощі
`insufficient_funds`	Недостатньо коштів на карті клієнта
`invalid_amount`	Неможливо обробити суму через обмеження/ліміти емітента
`invalid_card`	Картка недійсна, закрита або заблокована
`invalid_card_status`	Обмеження по використанню картки
`invalid_details`	Деталі транзакції не пройшли валідацію на стороні еквайера
`issuer_unavailable`	Емітент карти недоступний
`limit_violation`	Відмова емітента: перевищено ліміт по картці/клієнту
`lost_or_stolen_card`	Карта втрачена або вкрадена
`processing_error`	Помилка процесингу
`provider_fatal_error`	Помилка на стороні еквайера
`routing_error`	Платіж відхилений налаштуваннями роутингу
`timeout`	Отриманий таймаут на одному із етапів проведення транзакції
`blocked_by_firewall`	Транзакція заблокована антифрод-системою
`auth_3ds_required`	Для обробки потрібна верифікація 3D-Secure
`auth_otp_required`	Для обробки потрібна перевірка OTP
`auth_fatal_error`	Не вдалося здійснити авторизацію картки
`card_3ds_enrolled`	Для обробки цієї картки потрібна верифікація 3D-Secure
`card_blocked_by_invalid_pin`	Картку заблоковано через неправильне введення PIN-коду
`card_lost`	Картка вважається втраченою
`card_not_3ds_enrolled`	Картка не підтримує верифікацію 3D-Secure
`card_restricted`	Обробка транзакцій за цією карткою обмежена
`card_restricted_by_acquirer`	Еквайр обмежує обробку транзакцій за цією карткою
`invalid_card_type`	Тип картки є недійсним
`card_verification_failed`	Не вдалося верифікувати картку
`general_decline`	Відмова без деталізації причини
`invalid_3ds_code`	Невірний код підтвердження 3D-Secure
`invalid_cvv`	Неправильний CVV картки
`ACCESS_DENIED`	Користувач не авторизований або прав недостатньо для здійснення операції
`INVALID_CREDENTIALS`	Неправильні параметри автентифікації
`INVALID_PAN`	Невірний PAN
`INVALID_REQUEST`	Неправильний формат запиту
`TRANSACTION_NOT_FOUND`	Транзакція не знайдена
`card_is_lost`	Карта втрачена
`card_is_stolen`	Карта вкрадена
`card_status_is_restricted`	Використання картки обмежено
`card_usage_frequency_limit_violation`	Відмова емітента: перевищено ліміт по картці/клієнту
`fatal_card_expired`	Термін дії картки пройшов
`fatal_timeout`	З'єднання розірвано, тому що минув час очікування
`issuer_decline`	Транзакція відхилена емітентом: зв'яжіться з банком-емітентом для прояснення ситуації
`pin_tries_limit_was_reached`	Досягнуто ліміту спроб введення PIN-коду
`provider_error`	Помилка провайдера
`fatal_issuer_unavailable`	Емітент карти недоступний
`invalid_account`	Недійсний обліковий запис
`INVALID_TOKEN`	Передано невірний токен
`error`	При здійсненні платежа сталася помилка, але результат фінальний
`invalid_expire_date`	Невірний термін дії

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

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

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

Деталізовані причини помилок (failure_reason) по резолюції routing_error:¶

failure_reason	Деталізована причина
`limit_customer_number_day`	Ліміт кількості успішних платежів по клієнту за день
`limit_customer_sum_month`	Ліміт суми успішних платежів по клієнту за місяць
`limit_card_sum_month`	Ліміт суми успішних платежів по PAN за місяць
`limit_card_number_day`	Ліміт кількості успішних платежів по PAN за день
`customer_data_empty`	Відсутні обов'язкові дані клієнта
`foreign_card`	Заборонена оплата карткою цієї країни

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

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

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

Note

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