Pausar cupom

Coloca o cupom no status `PAUSED`. Pausados não funcionam em novos checkouts, mas as redemptions já feitas continuam válidas. Use isso pra desativar temporariamente sem perder histórico — você pode reativar via `POST /:id/resume`. Only funciona se o cupom estiver `ACTIVE`. Status diferente retorna 400.

POST/v2/coupons/:id/pause

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.

Exemplo: cpn_a8f3d2e1-...

Respostas

200

Cupom pausado. Retorna o objeto completo com status: PAUSED.

JSON

{
  "id": "cpn_a8f3d2e1-...",
  "code": "VERAO2026",
  "status": "PAUSED",
  "updatedAt": "2026-05-26T16:00:00.000Z"
}

400

Cupom não está em ACTIVE (já pausado, arquivado, etc).

JSON

{ "status": 400, "error": "Status atual (PAUSED) nao permite pause" }

404

Cupom não encontrado.

JSON

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

Exemplos

cURL

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