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

# Partner API V2

> Referência completa da Partner API V2, organizada por recurso.

Todas as rotas ficam em `https://api.deliveryvip.com.br/partner/v2` e exigem um token com o scope `dv.partner`. Há dois formatos de caminho:

| Formato | Exemplo | Alcance |
| - | - | - |
| Pelo recurso | `/merchants/{merchantId}`, `/resales/{resaleId}` | Tudo o que o token alcança; filtre listagens com o header `x-partners`. |
| Pelo parceiro | `/{partnerId}/plans`, `/{partnerId}/invoices` | O parceiro ou a revenda informada no caminho, que precisa estar no alcance do token. |

> [card] [Autenticação](/docs/reference/partner/v2/authentication.md)
>
> Scope, alcance do token, `x-partners` e erros comuns.

> [card] [Lojas](/docs/reference/partner/v2/merchant.md)
>
> Listagem, cadastro, assinatura, recursos, membros e apps.

> [card] [Revendas](/docs/reference/partner/v2/resale.md)
>
> Listagem, cadastro, assinatura, membros e apps.

> [card] [Planos](/docs/reference/partner/v2/plans.md)
>
> Consulta dos planos de cobrança.

> [card] [Faturas](/docs/reference/partner/v2/invoices.md)
>
> Faturas por loja e resumo por revenda.

> [card] [Cadastro](/docs/reference/partner/v2/signup.md)
>
> Cadastro público de loja e proprietário.


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