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

> ## Agent Instructions
> Documentação das APIs da DeliveryVip, em português. Regras que mais quebram integrações: (1) Merchant API: faça polling em GET /merchant/v3/events:polling no máximo a cada 30 s por token; confirme todo evento recebido com POST /merchant/v3/events/acknowledgment e corpo [{"id": "<eventId>"}] (o campo lido é id, não eventId), inclusive eventos repetidos ou que o sistema não trata; deduplique por eventId; o evento é só um aviso, busque o pedido na orderURL. (2) Tokens client_credentials valem 24 h e não têm refresh_token: peça outro ao receber 401. (3) Webhooks: valide a assinatura HMAC sobre o corpo bruto e responda 2xx rápido; o polling é a reconciliação. (4) Open Delivery: host od.deliveryvip.com.br, um client_secret por loja, datas em UTC. (5) Fidelidade: o operador implementa 5 rotas assinadas com HMAC e chama o config push; o estorno precisa ser idempotente. (6) Partner API: scope dv.partner. Não invente endpoints: use a referência gerada das specs OpenAPI.

# Remover um desconto

> Tire um desconto da loja de vez, liberando o código do cupom.

Remove o desconto. Ele deixa de valer, some da listagem e, se for cupom, o `code` fica livre para outro cupom. Os pedidos que já usaram o desconto não mudam.

> [!TIP]
>
> Quer só pausar o desconto e manter o histórico consultável? [Desative](/docs/guides/merchant/discount/acoes-dos-descontos/desativar-um-desconto.md) em vez de remover. Depois da remoção, nem as [estatísticas](/docs/guides/merchant/discount/obter-estatistica-do-desconto.md) ficam disponíveis.

## Requisição

**merchantId** `uuid` *required*

A loja.

**discountId** `uuid` *required*

O `id` do desconto.

```bash cURL theme={null}
curl --request DELETE 'https://api.deliveryvip.com.br/merchant/v3/{merchantId}/discounts/{discountId}' \
  --header 'Authorization: Bearer {token}'
```

```js Node.js theme={null}
await fetch(`https://api.deliveryvip.com.br/merchant/v3/${merchantId}/discounts/${discountId}`, {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${token}` },
})
```

```python Python theme={null}
requests.delete(
    f"https://api.deliveryvip.com.br/merchant/v3/{merchant_id}/discounts/{discount_id}",
    headers={"Authorization": f"Bearer {token}"},
)
```

## Resposta

Retorna `200 OK` com o [objeto desconto](/docs/guides/merchant/discount/obter-detalhes-do-desconto.md#resposta) como estava antes da remoção.

```json 200 OK theme={null}
{
  "id": "4572126a-6161-4b68-af04-3cb2fb4fa7a5",
  "createdAt": "2024-08-01T19:43:15-03:00",
  "startsAt": "2024-04-28T17:18:00-03:00",
  "type": "SMART",
  "name": "Desconto 10%",
  "status": "ACTIVE",
  "rules": {
    "valueType": "PERCENTAGE",
    "value": 10.0,
    "minimumOrderValue": 32.0,
    "usageLimit": 0,
    "usagePerCustomer": "MANY",
    "discountType": "SUBTOTAL"
  },
  "options": ["NON_PROMOTION_PRODUCTS"]
}
```

> [!WARNING]
>
> A remoção não tem volta pela API. Depois dela, qualquer chamada com o mesmo `discountId` responde `404`.

## Erros

| Status | Quando |
| - | - |
| `403 Forbidden` | A loja não contratou o módulo de descontos. |
| `404 Not Found` | O `merchantId` não autorizou o seu app, ou o desconto não existe ou já foi removido. |


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