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

# Definições de revendas

> Status e ciclo de vida da assinatura de uma revenda e o efeito dela sobre as lojas.

A assinatura da revenda usa os mesmos status e transições da assinatura das lojas, mas **não tem plano**: a cobrança da revenda vem dos preços que o parceiro define para ela.

## Tipos de Assinaturas

| status | Descrição |
| - | - |
| `TRIAL` | Status inicial de toda revenda nova. Dura 10 dias (`trialExpiresAt`). |
| `TRIAL_EXPIRED` | O período de teste acabou sem ativação. A revenda perde o acesso à plataforma. |
| `ACTIVATED` | Assinatura ativa. |
| `CANCELLED` | Assinatura cancelada. |
| `DEMO` | Assinatura de demonstração. Não pode ser ativada. |

## Ciclo de Vida da Assinatura

![Estados da assinatura: TRIAL, TRIAL\_EXPIRED, ACTIVATED e CANCELLED, com as transições activate e cancel](https://mintcdn.com/deliveryvip-a4256422/ELxpcniK2_BP8zxT/images/ciclo-assinatura-loja.png?fit=max\&auto=format\&n=ELxpcniK2_BP8zxT\&q=85\&s=224700b8d7eae9ee5805a7ed1c8aef4e)

Status da assinatura de uma revenda

Enquanto `ACTIVATED`, a revenda pode estar em aviso (`warning`) ou bloqueada (`blocked`), exatamente como uma loja. Veja [Aviso e bloqueio](/docs/guides/partner/merchant/definicoes.md#aviso-e-bloqueio).

## Efeito sobre as lojas da revenda

| Situação da revenda | Efeito nas lojas dela |
| - | - |
| Fora de `ACTIVATED` | Nenhuma loja da revenda pode ser ativada (`Partner subscription is not activated`). |
| Teste expirado, bloqueada ou cancelada | As lojas perdem a licença e não contratam recursos. |
| Cancelada pela API | Todas as lojas `ACTIVATED` da revenda são canceladas também. |


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