Как использовать ключ идемпотентности

Ключ идемпотентности - это уникальный идентификатор операции. Вы можете его самостоятельно генерировать и использовать, когда есть необходимость запретить повторное выполнение той же операции до её завершения. Например, чтобы не сделать двойную выплату или списание.

Срок действия ключа составляет 24 часа.

Формат

Идентификатор ключа идемпотентности указывается в заголовке запроса.

Название	Обязательность	Тип	Описание
X-PARTNER-IDEMPOTENCY-KEY	-	string	Ключ идемпотентности. Формат: от 4 до 64 знаков

Пример запроса с ключом идемпотентности

curl -X POST \
  https://proxy-demo.zetplat.com/api/v1/transaction/initiate \
  -H 'Content-Type: application/json' \
  -H 'X-Project-Id: your_project_name' \
  -H 'X-Signature: signature' \
  -H 'X-PARTNER-IDEMPOTENCY-KEY: testkey' \
  -d '{
    // тело запроса
  }'

Список методов с поддержкой ключа идемпотентности

• transaction/initiate
• transaction/init/transfer
• transaction/start/transfer
• transaction/init/checkout
• transaction/start/checkout
• transaction/approve
• transaction/finalize
• transaction/cancel
• transaction/refund

Список возможных ошибок

• idempotency_key_params_mismatch — Ключ уже был использован ранее для другой сессии.
• idempotency_key_already_exists — Предыдущий запрос с таким же ключом еще не обработан.
• idempotency_key_not_supported — Метод не поддерживает использование ключа идемпотентности.