Налаштування та використання сервісу callback

Сервіс переопитування статусу callback
Сервіс callback - це сервіс, в рамках якого WS2MPI обробляє запити клієнта наступним чином:
• ініціює переопитування про статус виконання операції у разі, коли клієнту не було надіслано відповідь на отриманий від нього запит;
• ініціює надсилання результату переопитування клієнту.
Сервіс переопитування статусу callback можливий для використання тільки для методів WS2MPI:
p2pTransfer transfer
p2pTransfer a2c
p2pTransfer c2a
Payment
Ознака для використання сервісу callback конкретним клієном налаштовується за заявкою клієнта в конфігураційному файлі системи WS2MPI.

Уточнення щодо логіки роботи механізму:

для кожного ExtSystemid налаштовуєтся свій callback URL (якщо під час реєстрації це було вказано).

під час виконання запиту, якщо ми бачимо, що клієнт не отримав відповідь з фінальним статусом операції, на нашій стороні зводиться watch dog, який стежить за станом платежу.

як тільки статус платежу змінюється, наш сервіс викликає метод вказаний у налаштуваннях для цього ExtSystemid з мінімальним набором даних (див. структуру тіла запиту callback)

після цього, для отримання детальної інформації щодо цієї операції ви можете зробити запит відповідного методу (/ConfirmExt).

Після отримання успішної відповіді зі значенням поля OrderStatus = 1 або 2 або після відправки максимально допустимої кількості запитів сервіс:
a) callback формує та надсилає клієнту POST запит наступної структури:
• тіло запиту:

Тіло запиту callback

№	Назва тегу	Тип даних	Обов'язковість	Опис
1	orderNumber	ANS 1..32	Yes	Номер (ідентифікатор) замовлення в системі інтернет-магазину продавця. Унікальний для кожного магазину в системі та генерується при реєстрації замовлення
2	respStatus	N3	Yes	Статус обробки запиту
3	orderStatus	N1	No	Статус замовлення, згенерований після реєстрації замовлення. Є у випадку, якщо respStatus = 200.
4	orderId	ANS 1..36	No	Номер замовлення, отриманий під час реєстрації замовлення.

b) callback приймає від клієнту відповідь наступної структури:
• тіло відповіді:

Тіло відповіді для сервісу callback

№	Назва тегу	Тип даних	Обов'язковість	Опис
1	orderNumber	ANS 1..32	Yes	Номер (ідентифікатор) замовлення в системі інтернет-магазину продавця. Унікальний для кожного магазину в системі та генерується при реєстрації замовлення.
2	applicationStatus	N3	Yes	Статус обробки запиту

У випадку, якщо у повідомленні відповіді applicationStatus ≠ 200, WS2MPI відправляє повторні POST запити кожні h мілісекунд, максимально допустима кількість запитів – k, до отримання відповідного повідомлення з applicationStatus = 200 або до моменту відправки максимально допустимої кількості запитів.

Налаштування та використання сервісу callback

Тіло запиту callback#

Тіло відповіді для сервісу callback#

Тіло запиту callback

Тіло відповіді для сервісу callback