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

# Cadastro

> Endpoint para cadastrar loja e proprietário a partir de uma landing page pública.

Endpoint de cadastro público de lojas, chamado pelo backend da sua landing page. Exige [autenticação](/docs/reference/partner/v2/authentication.md) com o scope `dv.partner`. Veja o guia de [Cadastro](/docs/guides/partner/signup.md).

| Endpoint | Para quê |
| - | - |
| `POST /partner/v2/{partnerId}/signup` | Criar a loja e a conta do proprietário com os dados do formulário. Com o ID de uma revenda, a loja nasce nela. |

O fluxo: o visitante preenche o formulário, o **seu backend** chama o endpoint e, se a resposta trouxer `entryUrl`, redireciona o visitante para ela. O `entryUrl` é de uso único e vale 5 minutos. Para cadastrar lojas a partir do seu próprio sistema, use [Cadastrar uma loja](/docs/guides/partner/merchant/utilizando-a-api/adicionar-um-merchant.md).

> [!WARNING]
>
> A resposta é `201` com a mesma `message` para e-mail novo e e-mail já cadastrado. Só a presença de `entryUrl` indica que a conta foi criada.

> [!CAUTION]
>
> Nunca chame este endpoint do navegador: o token `dv.partner` daria acesso a toda a sua rede.


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