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

# Revendas

> Cadastre e administre as revendas que vendem a DeliveryVip abaixo do seu parceiro.

Uma revenda é um parceiro comercial abaixo de você: ela atende as próprias lojas, tem assinatura própria e pode ter membros e apps autorizados. Só o **parceiro** gerencia revendas; um token de revenda não acessa esta seção.

**1. Cadastre a revenda**

`POST /partner/v2/{partnerId}/resales`. A revenda nasce em `TRIAL` por 10 dias e ganha uma loja de demonstração (`DEMO`).

**2. Dê acesso**

Adicione membros ao painel da revenda e, se ela usar um sistema próprio, autorize o app dela com o scope `dv.partner`.

**3. Ative a assinatura**

`POST /partner/v2/resales/{resaleId}/activate`. Lojas da revenda só podem ser ativadas com a revenda ativa.

> [card] [Definições](/docs/guides/partner/resale/definicoes.md)
>
> Status e ciclo de vida da assinatura da revenda.

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


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