Сообщение об активации одного кода

Один код → redeemed. Только коды вашего supplier_id.

Эндпоинт

POST /v1/supplier/usage/report

Scope: supplier:usage:write

Idempotency-Key: обязателен.

Пример запроса

{
  "data": {
    "codeNormalized": "QUEEN14-48AMU",
    "redeemedAt": "2026-07-14T10:00:00Z",
    "externalRef": "erp-act-998877",
    "options": { "allowDirectRedeemFromAvailable": false }
  }
}

Либо codeId, либо codeNormalized / code.

Переходы статуса

• Основной: realized → redeemed
• available → redeemed только при allowDirectRedeemFromAvailable: true
• Уже redeemed → success: true, alreadyRedeemed: true (идемпотентно)

Пример ответа

{
  "success": true,
  "data": { "codeId": "…", "newStatus": "redeemed", "alreadyRedeemed": false }
}

См. также

• Пакетное сообщение об активации кодов