Loja de teste
Como pedir uma loja de teste ao suporte e gerar pedidos reais marcados com test: true.
A API não tem sandbox. O ambiente de desenvolvimento é uma loja de teste em produção, criada pelo suporte sob pedido. Ela usa a mesma URL base, os mesmos endpoints e o mesmo comportamento de qualquer loja, com uma diferença: todo pedido dela sai com "test": true.
Isso significa que o que você homologa é exatamente o que vai rodar. Não há divergência entre ambientes para descobrir depois.
Pedindo a loja
Mande uma mensagem para o suporte pelo WhatsApp: (11) 95502-1289. Inclua:
- o nome do seu sistema ou empresa;
- o e-mail de quem vai acessar o painel da loja de teste;
- os escopos que a credencial precisa (
orders:read,orders:write,merchant:read,catalog:read); - o modo de entrega (
POLLING,WEBHOOKouBOTH) e, se houver webhook, a URL HTTPS.
O suporte cria a loja, e a credencial é gerada no painel dela como em qualquer loja: Integrações > Open Delivery > Conceder acesso. Peça também o endereço do cardápio digital da loja, que é por onde você vai gerar pedidos.
Uma loja de teste por integrador
A loja de teste é sua para desenvolver, homologar e reproduzir problemas. Depois de entrar em produção com lojas reais, mantenha a de teste: ela continua útil para validar mudanças na sua integração.
Gerando um pedido
Pedidos de teste nascem do mesmo jeito que pedidos reais: pelo cardápio digital da loja. Abra o endereço do cardápio no navegador ou no celular, monte um carrinho, escolha entrega ou retirada, informe um telefone e finalize.
Em segundos o evento CREATED aparece no polling ou chega no seu webhook, e GET /v1/orders/{orderId} devolve o pedido com "test": true:
{
"id": "9b1e2d3c-4f5a-4b6c-8d7e-0f1a2b3c4d5e",
"displayId": "1042",
"type": "DELIVERY",
"orderTiming": "INSTANT",
"createdAt": "2026-09-19T14:32:10Z",
"merchant": {
"id": "6d2f4c8a-1b3e-4f5a-9c7d-2e8b0a1f3c5d",
"name": "Loja de teste Acme"
},
"test": true
}Para testar cada tipo de pedido:
| Cenário | Como gerar |
|---|---|
Entrega (DELIVERY) | Finalize com endereço de entrega |
Retirada (TAKEOUT) | Escolha retirar na loja |
Agendado (SCHEDULED) | Escolha um horário futuro, se a loja de teste permitir agendamento |
Cancelado (CANCELLED) | Cancele pelo painel da loja, ou chame POST /v1/orders/{orderId}/requestCancellation |
Editado (MODIFIED) | Altere o pedido pelo painel da loja |
Os cenários de pagamento que dependem de um provedor real, como Pix online, podem não estar disponíveis na loja de teste. Para o fluxo da integração isso não muda nada: o evento CREATED de um pedido pago no Pix só sai quando o pagamento é confirmado, e a partir dali o comportamento é idêntico.
Tratando o campo test
Uma loja real nunca gera "test": true. Mesmo assim, trate o campo no seu sistema:
- em desenvolvimento, use-o para separar pedidos de teste nos seus relatórios;
- em produção, decida explicitamente o que fazer se ele vier
true(por exemplo, não imprimir na cozinha nem faturar).
Ignorar o campo funciona hoje; tratá-lo evita que um pedido de teste acabe em um relatório fiscal.
Próximos passos
- Primeira integração em 10 minutos: use a loja de teste para percorrer o fluxo completo.
- Obter credenciais: o que o painel mostra ao conceder o acesso.
- Suporte: o que enviar quando algo não funcionar.