Arquivar cupom

Arquiva o cupom: marca como ARCHIVED e preenche deletedAt. Redemptions históricas continuam acessíveis para auditoria, mas o cupom desaparece das listagens (exceto com includeDeleted=true). Arquivados não podem mais ser editados nem ter whitelist alterada. Idempotente: arquivar um cupom já arquivado retorna success: true sem erro.

DELETE/v2/coupons/:id

Não há restore via API

id Uma vez arquivado, não há endpoint para reativar via API. Se foi acidente, contate o suporte ou faça via dashboard. Pra cupons que você só quer pausar temporariamente, use POST /:id/pause em vez de DELETE.

Autenticação

HTTP Basic Auth. Envie sua secret key no header:

Authorization: Basic {base64(secret:SUA_SECRET_KEY)}

Parâmetros

idstring (path, UUID)obrigatório

UUID do cupom a arquivar.

Exemplo: cpn_a8f3d2e1-...

Respostas

200

Cupom arquivado. Se já estava arquivado, retorna alreadyDeleted: true.

JSON

{
  "success": true
}

404

Cupom não encontrado.

JSON

{ "status": 404, "error": "Cupom nao encontrado" }

Exemplos

cURL

curl -X DELETE "https://api.ihubplay.com/v2/coupons/cpn_a8f3d2e1-..." \
  -H "Authorization: Basic $(echo -n 'secret:SUA_SECRET_KEY' | base64)"