Идемпотентность
POST /invoices и POST /withdrawals принимают заголовок Idempotency-Key (любая строка, например id заказа или UUID).
curl -s "$API/invoices" -H "API-Token: $TOKEN" \
-H "Idempotency-Key: order-5512" -H "Content-Type: application/json" \
-d '{"amount": "100.00", "network": "tron", "payload": "order-5512"}'- Повтор с тем же ключом и тем же телом возвращает сохранённый первый ответ и заголовок
Idempotent-Replay: true. Новый инвойс или вывод не создаётся. - Тот же ключ с другим телом вернёт
422 IDEMPOTENCY_KEY_REUSED. Тела сравниваются после подстановки значений по умолчанию:{"amount": "10"}и{"amount": "10", "currency": "USDT"}считаются одинаковыми. - Ключи действуют в пределах приложения 30 дней. Повтор с тем же ключом позже считается новым запросом.
- Сохраняется только успешный ответ. Если запрос завершился ошибкой (
INSUFFICIENT_FUNDS,DAILY_LIMITи т. п.), повтор с тем же ключом выполнится заново. - Параллельные запросы с одним ключом безопасны: второй ждёт, пока первый завершится, и получает его ответ (блокировка
pg_advisory_xact_lockпо ключу). Если первый завершился ошибкой, второй выполнится сам. DELETE /invoices/{id}иPOST /webhooks/testключ не используют. Повторная отмена вернётINVOICE_NOT_CANCELABLE.