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

# Pedidos

> Receba, confirme e acompanhe os pedidos das lojas que instalaram o seu app.

A API de pedidos é orientada a eventos: a DeliveryVip avisa o que aconteceu com cada pedido e o seu PDV busca os detalhes e responde com ações. Todo pedido passa pelas mesmas quatro etapas.

**1. Receba o evento**

Consulte novos eventos a cada 30 segundos em `GET /merchant/v3/events:polling`, ou receba-os na hora por [webhook](/docs/guides/merchant/webhooks.md).

**2. Confirme o recebimento**

Envie o acknowledgment em `POST /merchant/v3/events/acknowledgment` para tirar os eventos da fila.

**3. Busque o pedido**

Obtenha itens, cliente, entrega e pagamento em `GET /merchant/v3/orders/{orderId}`.

**4. Atualize o status**

Confirme, prepare, despache, entregue ou cancele o pedido com as ações.

> [!TIP]
>
> Quer ver isso funcionando? O guia [Receba seu primeiro pedido](/docs/guides/merchant/order/fluxo-de-integracao/recepcao-de-pedidos.md) tem um script completo em Node.js e Python.

## Por onde seguir

> [card] [Seu primeiro pedido](/docs/guides/merchant/order/fluxo-de-integracao/recepcao-de-pedidos.md)
>
> Do token ao pedido confirmado, com código pronto para rodar.

> [card] [Definições](/docs/guides/merchant/order/definicoes.md)
>
> Tipos de pedido, agendamento e o ciclo de vida de cada tipo.

> [card] [Fluxo de integração](/docs/guides/merchant/order/fluxo-de-integracao.md)
>
> Cada etapa em detalhe: polling, eventos, acknowledgment, detalhes e ações.

> [card] [Listar pedidos](/docs/guides/merchant/order/listar-pedidos.md)
>
> Consulte o histórico de pedidos de uma loja com paginação.

> [!NOTE]
>
> A Merchant API V3 segue o modelo da especificação [Open Delivery](https://www.opendelivery.com.br), o padrão aberto para integrar plataformas de pedidos e PDVs. Se o seu sistema já implementa Open Delivery, veja a [integração Open Delivery](/docs/guides/open-delivery.md).


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