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

# Utilizando a API de lojas

> Mapa de todos os endpoints de lojas da Partner API V2.

Todas as rotas abaixo ficam em `https://api.deliveryvip.com.br/partner/v2` e exigem um token com o scope `dv.partner`.

| Endpoint | O que faz |
| - | - |
| `GET /merchants` | [Listar lojas](/docs/guides/partner/merchant/utilizando-a-api/listar-merchants.md) com filtros. |
| `GET /merchants/sales` | [Listar vendas](/docs/guides/partner/merchant/utilizando-a-api/listar-vendas-dos-merchants.md) do mês por loja. |
| `GET /merchants/{merchantId}` | [Obter detalhes](/docs/guides/partner/merchant/utilizando-a-api/obter-detalhes-do-merchant.md) de uma loja. |
| `POST /{partnerId}/merchants` | [Cadastrar uma loja](/docs/guides/partner/merchant/utilizando-a-api/adicionar-um-merchant.md). |
| `GET/POST/PATCH/DELETE /merchants/{merchantId}/members` | [Membros](/docs/guides/partner/merchant/utilizando-a-api/membros-do-merchant.md) e magic link. |
| `POST /merchants/{merchantId}/activate` e afins | [Assinatura](/docs/guides/partner/merchant/utilizando-a-api/gerenciar-assinatura-dos-merchants.md): ativar, cancelar, avisar, bloquear, atualizar. |
| `POST /merchants/{merchantId}/features/*` | [Recursos](/docs/guides/partner/merchant/utilizando-a-api/gerenciar-recursos-dos-merchants.md) adicionais. |
| `POST/DELETE /merchants/{merchantId}/applications` | [Apps autorizados](/docs/guides/partner/merchant/utilizando-a-api/gerenciar-permissao-de-aplicativos-dos-merchants.md) na loja. |
| `GET /merchants/invoices` | [Faturas (descontinuado)](/docs/guides/partner/merchant/utilizando-a-api/listar-faturas-dos-merchants.md). Use [Faturas](/docs/guides/partner/invoices.md). |

> [card] [Listar lojas](/docs/guides/partner/merchant/utilizando-a-api/listar-merchants.md)
>
> Filtre por status, contrato, CNPJ/CPF e parceiro.

> [card] [Cadastrar uma loja](/docs/guides/partner/merchant/utilizando-a-api/adicionar-um-merchant.md)
>
> Crie a loja já vinculada ao parceiro ou a uma revenda.

> [card] [Gerenciar assinatura](/docs/guides/partner/merchant/utilizando-a-api/gerenciar-assinatura-dos-merchants.md)
>
> Ative, cancele, avise, bloqueie e troque de plano.

> [card] [Membros da loja](/docs/guides/partner/merchant/utilizando-a-api/membros-do-merchant.md)
>
> Quem acessa o painel da loja.


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