Отримання стану раніше створеної заявки на оформлення Покупки Частинами (Callback)
Як це працює
- Магазин надсилає запит на створення заявки на оформлення Покупки Частинами з передачею параметра result_callback
- Після опрацювання операції Монобанком на сервер магазину буде надіслано запит POST що містить результат опрацювання запиту. Формат запиту буде аналогічний відповідісервісу перевірки станів
- Для перевірки справжності запиту із сервера Монобанку необхідно:
- сформувати signature на боці вашого сервера, використовуючи отриманий від Монобанку запит.
- отримане значення signature необхідно порівняти з отриманою з Callback від Монобанку
- якщо signature ідентичні, то Ви отримали справжню відповідь від сервера Монобанку (не змінений третьою особою/без втручання третіх осіб) і можна продовжувати виконувати операцію, відповідно до отриманого статусу платежу. Для отримання поточного статусу транзакції до отримання фінального Callback, використовуйте API сервісу перевірки станів, який можна виконувати в будь-який момент.
- сформувати signature на боці вашого сервера, використовуючи отриманий від Монобанку запит.
| Статус | Суб-статус | Пояснення |
|---|---|---|
| SUCCESS | ACTIVE | заявка успішна, товар передано клієнтові, гроші надіслано магазину. Фінальний статус за заявкою |
| SUCCESS | DONE | заявка успішна, товар передано клієнтові, гроші надіслано магазину, ПЧ погашено клієнтом. |
| SUCCESS | RETURNED | магазином прийнято повернення товару, гроші перераховано клієнтові |
| IN_PROCESS | WAITING_FOR_CLIENT | очікування підтвердження від клієнта кредитного договору у застосунку монобанк |
| IN_PROCESS | WAITING_FOR_STORE_CONFIRM | кредитна угода ПЧ підтверджена клієнтом. Важливо! Ключовий статус після отримання якого необхідно передати товар клієнтові |
| FAIL | CLIENT_NOT_FOUND | Клієнта не знайдено. Варіанти: не є клієнтом монобанку; зазначено не фінансовий номер |
| FAIL | EXCEEDED_SUM_LIMIT | Клієнт перевищив допустимий ліміт на ПЧ. Ліміт можна подивитися у застосунку монобанк у меню Розстрочка. |
| FAIL | EXISTS_OTHER_OPEN_ORDER | У клієнта є інша відкрита заявка на ПЧ. Рішення: скасувати відкриту заявку у застосунку клієнтом чи магазином методом reject; почекати 15 хв, заявка перейде у статус CLIENT_PUSH_TIMEOUT |
| FAIL | FAIL | Внутрішня помилка на боці Банку. Рекомендуємо повторити подання заявки через 5 хв. |
| FAIL | NOT_ENOUGH_MONEY_FOR_INIT_DEBIT | Недостатньо коштів для першого списання. Рішення: поповнити картку монобанку на суму першого платежу |
| FAIL | REJECTED_BY_CLIENT | Клієнт відмовився від здійснення купівлі |
| FAIL | RESTRICTED_BY_RISKS | Потрібно звернутися до банку для отримання причини відмови у ПЧ |
| FAIL | CLIENT_PUSH_TIMEOUT | Клієнт не ухвалив рішення щодо кредитного договору ПЧ у застосунку монобанку. Кредитний договір активний 15 хв. Рішення: зв’язатися з клієнтом; повторити заявку |
| FAIL | REJECTED_BY_STORE | Магазин відмовився від продажу |
HEADER PARAMETERS:
signature
required
string
store-id
required
string
Ідентифікатор магазину (виданий під час укладання договору)
REQUEST BODY SCHEMA: application/json
order_id
required
string
Унікальний ідентифікатор заявки
post
/api/order/state
Request samples
Payload
200 Успішна відповідь сервісу
400 Помилка у запиті
401 Підпис не передано або не валідний
500 Внутрішня помилка сервісу
Response samples
200
400
401
500