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

# Instalando o app na loja

> O passo a passo que o lojista segue na Delivery Store para instalar e autorizar o seu app.

Sem instalação, o seu token não alcança a loja. Este guia mostra o que o **lojista** faz para instalar o seu app. Envie esta página para ele junto com o token de autorização.

> [!NOTE]
>
> Os passos abaixo valem para os dois tipos de distribuição. Na [distribuição interativa](/docs/inicio/primeiros-passos/distribuicao-interativa.md), depois de colar o token o lojista é levado para o seu app e autoriza o acesso por lá, em vez de clicar em **Instalar**.

![Fluxo de instalação: token de autorização, busca do app, instalação e merchantId](https://mintcdn.com/deliveryvip-a4256422/ELxpcniK2_BP8zxT/images/fluxo-instalacao-app.png?fit=max\&auto=format\&n=ELxpcniK2_BP8zxT\&q=85\&s=4a51630ee4e688eb6266e3282eaa8981)

Fluxo de instalação do app na loja

**1. Abra a Delivery Store**

No painel da loja, o lojista abre o menu **Delivery Store** e clica em **Autorizar Aplicativo**.

![Menu Delivery Store com o botão Autorizar Aplicativo](https://mintcdn.com/deliveryvip-a4256422/ELxpcniK2_BP8zxT/images/merchant-delivery-store.png?fit=max\&auto=format\&n=ELxpcniK2_BP8zxT\&q=85\&s=85eb6597f9856c9ee4577617094d0c6a)

Delivery Store no painel da loja

**2. Cole o token de autorização**

Ele cola o **token de autorização** que você enviou e clica em **Buscar Aplicativo**.

![Campo para colar o token de autorização e botão Buscar Aplicativo](https://mintcdn.com/deliveryvip-a4256422/ELxpcniK2_BP8zxT/images/merchant-autorizar-app.png?fit=max\&auto=format\&n=ELxpcniK2_BP8zxT\&q=85\&s=581c69f438db1695ac20777c3cd40803)

Campo do token de autorização

> [!TIP]
>
> O token de autorização fica na tela de detalhes do app, no painel de developers.

**3. Revise as permissões e instale**

A tela mostra o app e as permissões que ele pede, como pedidos, catálogo ou autoatendimento. Se concordar, o lojista clica em **Instalar**.

![Detalhes do app com a lista de permissões e o botão Instalar](https://mintcdn.com/deliveryvip-a4256422/ELxpcniK2_BP8zxT/images/merchant-instalar-app.png?fit=max\&auto=format\&n=ELxpcniK2_BP8zxT\&q=85\&s=fdc01ced2c8e4f4f3ebd45d32b8a164f)

Revisão das permissões

O e-mail de contato do app recebe um aviso de cada nova instalação.

**4. Copie o merchantId**

Depois de instalar, o lojista vê a tela do app instalado com o **`merchantId`**. Ele copia esse valor e envia para você.

![Tela do app instalado mostrando o merchantId](https://mintcdn.com/deliveryvip-a4256422/ELxpcniK2_BP8zxT/images/merchant-app-instalado.png?fit=max\&auto=format\&n=ELxpcniK2_BP8zxT\&q=85\&s=7981d31477a410fc799f454bac64f8b5)

App instalado, com o merchantId

> [!TIP]
>
> Com o app instalado e o `merchantId` em mãos, [obtenha o token de acesso](/docs/inicio/primeiros-passos/distribuicao-direta.md#obtendo-o-token-de-acesso). O mesmo token atende esta e todas as outras lojas que instalaram o app.

> [!WARNING]
>
> Guarde o `merchantId` associado à loja no seu sistema. É ele que identifica a loja nas rotas por loja (`/merchant/v3/{merchantId}/...`) e no header `x-polling-merchants` do polling.

## Desinstalação

O lojista pode remover o app a qualquer momento pela Delivery Store. A partir daí, o seu token deixa de alcançar a loja. Para voltar, ela precisa instalar de novo.


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