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

# Lojas

> Cadastre e administre as lojas (merchants) da sua rede, da assinatura aos membros do painel.

Cada loja (merchant) da sua rede tem uma assinatura, um plano de cobrança, recursos contratados, membros com acesso ao painel e apps autorizados. Esta seção cobre o ciclo completo, do cadastro ao cancelamento.

**1. Cadastre a loja**

`POST /partner/v2/{partnerId}/merchants`. A loja nasce em `TRIAL` por 10 dias, no plano padrão do parceiro.

**2. Dê acesso ao lojista**

Adicione membros com `POST /partner/v2/merchants/{merchantId}/members` e, se quiser, gere um magic link de acesso.

**3. Ative a assinatura**

`POST /partner/v2/merchants/{merchantId}/activate`, com o código do contrato e o plano.

**4. Acompanhe**

Consulte vendas, contrate recursos adicionais e use aviso, bloqueio e cancelamento quando precisar.

> [card] [Definições](/docs/guides/partner/merchant/definicoes.md)
>
> Status da assinatura, ciclo de vida, recursos e papéis de membros.

> [card] [Utilizando a API](/docs/guides/partner/merchant/utilizando-a-api.md)
>
> Todos os endpoints de lojas, com exemplos.


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