Транзакції та повторні спроби
Відкликання — це асинхронна бізнес-операція. Успішна відповідь HTTP означає, що запит оброблено; він не встановлює, що кошти надійшли по мережі.
Зберігайте один бізнес-ідентифікатор
Згенеруйте та збережіть client_request_id, перш ніж надсилати вилучення. Повторно використовуйте його для повторних спроб тієї ж запланованої операції, зокрема після перезапуску процесу. Зберігайте узгодженість полів транзакції; поточна реалізація відхиляє повторюваний ідентифікатор із суперечливими бізнес-параметрами.
Не покладайтеся лише на заголовок Idempotency-Key. Наданий SDK може додати цей заголовок, але поточний договір дедуплікації зняття коштів базується на полі тіла client_request_id.
Розуміти дані запиту
У цій таблиці виділено основні поля, а не повну схему запиту. Підтвердьте попередній перегляд, підтвердження комісії та спеціальні вимоги до зберігання щодо версії інтеграції. Уникайте двійкових значень із плаваючою комою та не копіюйте приклади ланцюжків чи номерів активів між середовищами.
Слідкуйте за результатом
Список є ілюстративним і може доповнюватися. Зберігайте невідомі стани для дослідження замість того, щоб відображати їх успіх чи невдачу. Сама по собі невдала або відхилена мітка не є достатнім доказом того, що нічого не було підписано чи трансльовано.
Відновити після тайм-ауту
Зробіть запит GET /api/v1/withdrawals/by-request, використовуючи оригінальний параметр запиту client_request_id. Продовжуйте опитування або узгодження початкової операції, поки її результат невизначений. Якщо потрібне поновлення авторизації, використовуйте той самий ідентифікатор і узгоджену процедуру поновлення.
Скасування залежить від фактичного етапу підписання та перевірок сервера. Розпочинайте бізнес-операцію заміни лише після того, як буде встановлено, що оригінал не переданий і неможливий для передачі. Отримувати події через webhooksі збережіть API запити як шлях узгодження.