Webhook

O webhook entrega eventos de pedidos em tempo real via HTTPS. Recomendado para integrações centralizadas que gerenciam múltiplos merchants.

Webhook está disponível apenas para autenticação centralizada.

Quando usar webhook

✅ Integração centralizada (SaaS)
✅ Múltiplos merchants
✅ Eventos em tempo real
❌ Evite se sua infraestrutura não garante alta disponibilidade

Alternativa: Use polling para integrações distribuídas ou com infraestrutura menos estável.

Quick Start

1. Configure o webhook

Acesse Meus Apps → [seu app] → Webhook
Habilite webhook e cadastre URL HTTPS
Salve as alterações

! [Configure o webhook] (../../../images/webhook-configuration.png)

2. Configure a presença*

Por padrão, o sistema habilita presença para cada aplicação registrada no webhook. Após registrar o webhook, o endpoint recebe eventos de presença em até 30 segundos.

Saiba mais sobre o conceito de presença no webhook aqui.

Presença por aplicativo ou por merchant

Escolha o modo de controle de presença conforme sua necessidade:Por aplicativo (padrão)

Uma única resposta 202 Accepted marca todos os merchants como online
Use quando todos os merchants têm a mesma disponibilidade

Por merchant (controle individualizado)

Responda com lista dos merchants online
Use quando precisar controlar disponibilidade individual (ex.: horários diferentes, manutenção pontual)

Configure o modo na aba Webhook do Developer Portal. Veja detalhes sobre presença.

3. Valide assinatura

Todas as requests incluem header X-IFood-Signature
Valide usando HMAC SHA256 + seu client secret
Veja como validar

4. Responda rapidamente

Retorne 202 Accepted em até 5 segundos
Use fila para processar eventos assíncronamente

5. Libere os IPs do iFood

Se sua infraestrutura usa firewall, configure allowlist com os IPs do iFood para receber eventos. Veja a lista de IPs.

6. Teste a integração

Use botão "Testar conexão" no Developer Portal
Gere pedidos de teste

7. Bloqueio da integração

O iFood só bloqueia webhooks em casos extremos, após tentar contato sobre problemas de integração. Verifique o status do bloqueio na área do aplicativo.! [Bloqueio de webhooks] (../../../images/webhook-blocked.png)