Buscar na documentação
ctrl+4K
Primeiros passos
Homologação
Sobre nossas APIs

Gerar pedidos de teste

O iFood oferece duas formas de criar pedidos para testar sua integração. Escolha a mais adequada ao seu cenário.

Crie pedidos instantaneamente com um clique no Portal do Desenvolvedor.O que é gerado automaticamente
  • Endereço de entrega padrão
  • Itens do catálogo da loja
  • Forma de pagamento padrão
  • Cliente de teste vinculado
Apps multicategoria (mercado, farmácia, petshop, shopping) devem usar geração manual — a automática está temporariamente indisponível.

  1. Acesse developer.ifood.com.br e faça login.
  2. Abra o menu Testes (clique no seu nome ou no menu lateral).
  3. Clique em Gerar pedido de teste (canto superior direito).
  4. Selecione a loja de teste.
  5. Confirme a geração — o pedido é criado instantaneamente.
Após a geração, o modal mostra:
  • Nome da loja — identificação
  • ID do pedido — use em chamadas de API
  • Email do usuário — login no app (modo teste)
Próximos passos:
  • Consulte: GET /orders/{id}
  • Acompanhe no app usando o email informado
  • Manipule o pedido via módulos da API

Simule uma compra real no app ou site iFood para testar fluxos e exceções.Quando usar
  • Testar itens específicos do catálogo
  • Testar diferentes métodos de pagamento
  • Aplicar cupons de desconto
  • Validar o fluxo completo de checkout

1. Faça login
Acesse ifood.com.br ou o app iFood. Use o email de teste em: Portal do Desenvolvedor > Testes > Usuário de Testes

2. Configure o endereço de testea) Clique em "Entregar Em" (topo da página)
b) Pesquise: Ramal Bujari, 100
c) Complete e salve:
  • Confirme a localização no mapa
  • Em Bairro, digite Bujari
  • Clique em Salvar Endereço

3. Mantenha a loja abertaLojas de teste funcionam 24/7, mas só aparecem abertas se estiverem conectadas à API.Faça polling a cada 30 segundos: GET /events:polling
Loja aparece fechada? Verifique se seu aplicativo:
  • Faz polling regularmente
  • Envia headers de autenticação corretos
  • Processa os eventos recebidos
Saiba mais sobre polling →

4. Localize a loja de teste
  • Use a barra de pesquisa e digite o nome exato da loja.
  • Selecione a loja nos resultados.
Loja não aparece?
  1. Clique em Perfil
  2. Selecione Editar Dados
  3. Ative Modo Teste
Ainda não aparece? Abra um chamado de suporte →

5. Monte o pedido
  • Adicione produtos do catálogo.
  • Atinja o valor mínimo da loja.

6. Finalize o pedidoEscolha o método de pagamento:
MétodoRecomendaçãoObservação
Dinheiro na entregaPreferencialNão requer dados de cartão
Cartão na entregaRecomendadoNão requer dados de cartão
Cartão de crédito onlineUse dados de testeDados abaixo
PIX❌ IndisponívelNão disponível para testes
Débito em conta❌ IndisponívelNão disponível para testes
Dados de cartão para testes
Número: 4111 1111 1111 1111
Validade: 03/2030
CVV: 737
Use apenas estes dados de teste. Nunca use cartões reais.

  • Você receberá eventos via API.
  • Pode consultar via GET /orders/{id}.
  • Pode acompanhar no app iFood.

  1. No checkout, antes de finalizar
  2. Clique em Adicionar Cupom
  3. Digite o código e confirme
CódigoDesconto aplicado emQuem paga
VOUCHER_IFOODValor total do carrinhoiFood
VOUCHER_RESTValor total do carrinhoLoja
VOUCHER_ENTGRATISTaxa de entregaiFood
CampoValor
targetCART ou DELIVERY_FEE
sponsorshipIFOOD ou MERCHANT
Documentação completa: Estrutura de cupons →Cupons por item específico (ITEM, PROGRESSIVE_DISCOUNT_ITEM) exigem campanhas; use exemplos de resposta para mapear.
  • Habilite Modo Teste (Perfil > Editar Dados > Modo Teste)
  • Verifique polling /events:polling
  • Use exatamente: Ramal Bujari, 100
  • Informe "Bujari" no campo bairro
  • Aguarde até 30s (delay de processamento)
  • Use o ID do modal de confirmação
  • Verifique header x-request-homologation
  • Se 404: implemente retry com backoff (até 10 minutos)
  • Implemente polling a cada 30s ou registre webhook
  • Envie ACK para eventos recebidos
  • Verifique código, país (BR/CO), valor mínimo e uso prévio

Faça:
  • Teste métodos de pagamento suportados
  • Simule valores diferentes
  • Teste com e sem cupons
  • Valide todos os eventos
  • Use retry para consultas que retornam 404 (exponential backoff, até 10 minutos)
Evite:
  • Usar cartões reais
  • Fazer polling mais rápido que 30s
  • Consultar pedidos com mais de 7 dias
  • Fazer retries infinitos


Precisa de ajuda? Abra um chamado de suporte →
Esta página foi útil?
Avalie sua experiência no novo Developer portal: