---
title: "Alternar status de um cupom"
method: POST
path: "/coupons/toggle"
---

# Alternar status de um cupom

`POST /coupons/toggle`

Alterna o status de um cupom entre ativo e inativo.

Use essa rota para ativar ou desativar um cupom sem precisar deletá-lo.

## Query parameters

- `id` string, required

## Response `200`

Status do cupom alternado com sucesso.

- object
  - `data` CouponResponse — Os dados do seu cupom.
    - `id` string, required — Identificador único do cupom
    - `notes` string — Descrição sobre o cupom
    - `maxRedeems` integer — Quantidade de vezes em que o cupom pode ser resgatado. -1 significa ilimitado.
    - `redeemsCount` integer — Quantidade de vezes que o cupom já foi resgatado.
    - `discountKind` 'PERCENTAGE' | 'FIXED', required — Tipo de desconto aplicado, porcentagem ou fixo
    - `discount` number, required — Valor de desconto a ser aplicado
    - `devMode` boolean — Indica se o cupom foi criado em ambiente de testes.
    - `status` 'ACTIVE' | 'INACTIVE' | 'EXPIRED', required — Status atual do cupom.
    - `createdAt` string, date-time, required — Data de criação do cupom.
    - `updatedAt` string, date-time, required — Data de atualização do cupom.
    - `metadata` object — Objeto chave valor para metadados do cupom
  - `error` string, nullable
  - `success` boolean — Se a requisição obteve sucesso ou não.

## Other responses

- `401` — Não autorizado. Falha na autenticação.
- `404` — Cupom não encontrado.

---

[API](https://skmtc.net/abacatepay/apis/api-abacatepay.md) · [All operations](https://skmtc.net/abacatepay/apis/api-abacatepay/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/abacatepay/api-abacatepay/revisions/6b89a7fa70f5/schema)