> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bukiopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DELETE /api/v1/coupons/:id: Remover Cupom da Loja

> Remove permanentemente um cupom da loja pelo ID. Para suspender temporariamente, use active: false no endpoint de atualização em vez de deletar.

Use este endpoint para excluir permanentemente um cupom de desconto da sua loja. Após a remoção, o código do cupom deixará de ser válido e não poderá ser recuperado. Se desejar apenas desativar o cupom temporariamente, considere utilizar o endpoint de atualização com `active: false`.

## Método

`DELETE /api/v1/coupons/:id` — Requer autenticação.

## Parâmetro de Rota

<ParamField path="id" type="string" required>
  Identificador único do cupom a ser removido (ex: `cpn_123`).
</ParamField>

<Warning>
  Esta operação é **irreversível**. Uma vez deletado, o cupom não pode ser recuperado e seu código ficará permanentemente inativo. Se precisar apenas suspender o cupom temporariamente, use o endpoint [Atualizar Cupom](/api-reference/coupons/update) com `active: false`.
</Warning>

## Exemplo de Requisição

```bash theme={null}
curl -X DELETE 'https://api.bukiopay.com/api/v1/coupons/cpn_123' \
  --header 'Authorization: Bearer sk_live_sua_api_key'
```

## Resposta

```json theme={null}
{
  "message": "Cupom deletado com sucesso"
}
```

## Campos da Resposta

<ResponseField name="message" type="string">
  Mensagem de confirmação indicando que o cupom foi removido com sucesso.
</ResponseField>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.