> ## 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.

# Descontos

> Endpoints para listar, criar, atualizar, ativar e remover descontos e consultar estatísticas.

Endpoints para listar, consultar, criar, atualizar, ativar, desativar e remover cupons e descontos automáticos, e para consultar as estatísticas de uso de cada um. Todos exigem [autenticação](/docs/reference/merchant/v3/authentication.md) com o scope `od.all`. Para exemplos e regras, veja o guia de [Descontos](/docs/guides/merchant/discount.md).

| Endpoint | Para quê | Guia |
| - | - | - |
| `GET /{merchantId}/discounts` | Listar os descontos da loja. | [Listar descontos](/docs/guides/merchant/discount/listar-descontos.md) |
| `GET /{merchantId}/discounts/{discountId}` | Detalhes de um desconto. | [Obter detalhes](/docs/guides/merchant/discount/obter-detalhes-do-desconto.md) |
| `POST /{merchantId}/discounts` | Criar um desconto `SMART` ou um cupom (`COUPON`). | [Adicionar](/docs/guides/merchant/discount/adicionar-um-desconto.md) |
| `PATCH /{merchantId}/discounts/{discountId}` | Alterar um desconto. | [Atualizar](/docs/guides/merchant/discount/atualizar-um-desconto.md) |
| `POST .../available` e `unavailable` | Ligar ou desligar na hora. | [Ações](/docs/guides/merchant/discount/acoes-dos-descontos.md) |
| `DELETE /{merchantId}/discounts/{discountId}` | Remover. | [Remover](/docs/guides/merchant/discount/remover-um-desconto.md) |
| `GET /{merchantId}/discounts/{discountId}/stats` | Quanto o desconto vendeu. | [Estatística](/docs/guides/merchant/discount/obter-estatistica-do-desconto.md) |

> [!NOTE]
>
> A API de descontos está em **beta** e ainda pode mudar. O `status` (`SCHEDULED`, `ACTIVE`, `OVERDUE`) é calculado pelas datas, não enviado.


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