Buscar en la documentación
ctrl+4K
Primeros pasos
Homologación
Sobre nuestras APIs

Generar pedidos de prueba

iFood ofrece dos formas de crear pedidos para probar tu integración. Elige la que mejor se adapte a tu escenario.

Crea pedidos al instante con un clic en el Portal del Desarrollador.Qué se genera automáticamente
  • Dirección de entrega por defecto
  • Artículos del catálogo de la tienda
  • Método de pago por defecto
  • Cliente de prueba vinculado
Las apps multicategoría (supermercado, farmacia, pet shop, shopping) deben usar generación manual — la automática está temporalmente indisponible.

  1. Accede a developer.ifood.com.br e inicia sesión.
  2. Abre el menú Tests (haz clic en tu nombre o en el menú lateral).
  3. Haz clic en Generar pedido de prueba (arriba a la derecha).
  4. Selecciona la tienda de prueba.
  5. Confirma — el pedido se crea al instante.
Después de generar, el modal muestra:
  • Nombre de la tienda — identificación
  • ID del pedido — usar en llamadas API
  • Email del usuario — inicio de sesión en la app (modo prueba)
Próximos pasos:
  • Consulta: GET /orders/{id}
  • Sigue el pedido en la app con el email proporcionado
  • Gestiona el pedido usando los módulos de la API

Simula una compra real en la app o el sitio de iFood para probar flujos y casos límite.Cuándo usar
  • Probar artículos específicos del catálogo
  • Probar distintos métodos de pago
  • Aplicar cupones de descuento
  • Validar el flujo completo de pago

1. Inicia sesión
Accede a ifood.com.br o a la app de iFood. Usa el email de prueba en: Portal del Desarrollador > Tests > Usuarios de prueba

2. Configura la dirección de pruebaa) Haz clic en "Entregar en" (parte superior de la página)
b) Busca: Ramal Bujari, 100
c) Completa y guarda:
  • Confirma la ubicación en el mapa
  • En Barrio, escribe Bujari
  • Haz clic en Guardar dirección

3. Mantén la tienda abiertaLas tiendas de prueba funcionan 24/7, pero solo aparecen abiertas si están conectadas a la API.Haz polling cada 30 segundos: GET /events:polling
¿La tienda aparece cerrada? Verifica que tu app:
  • Haga polling regularmente
  • Envíe headers de autenticación correctos
  • Procese los eventos recibidos
Más sobre polling →

4. Localiza la tienda de prueba
  • Usa la barra de búsqueda y escribe el nombre exacto de la tienda.
  • Selecciona la tienda en los resultados.
¿La tienda no aparece?
  1. Haz clic en Perfil
  2. Selecciona Editar datos
  3. Activa Modo de prueba
¿Aún no aparece? Abre un ticket de soporte →

5. Arma el pedido
  • Agrega productos del catálogo.
  • Llega al valor mínimo de la tienda.

6. Finaliza el pedidoElige el método de pago:
MétodoRecomendaciónObservación
Efectivo en entregaPreferidoNo requiere datos de tarjeta
Tarjeta en entregaRecomendadoNo requiere datos de tarjeta
Tarjeta de crédito onlineUsa datos de pruebaDatos abajo
PIX❌ No disponibleNo disponible para pruebas
Débito bancario❌ No disponibleNo disponible para pruebas
Datos de tarjeta para pruebas
Número: 4111 1111 1111 1111
Vencimiento: 03/2030
CVV: 737
Usa solo estos datos de prueba. Nunca uses tarjetas reales.

  • Recibirás eventos vía API.
  • Puedes consultar con GET /orders/{id}.
  • Puedes seguir el pedido en la app iFood.

  1. En el checkout, antes de finalizar
  2. Haz clic en Agregar cupón
  3. Ingresa el código y confirma
CódigoDescuento aplicado aQuién paga
VOUCHER_IFOODTotal del carritoiFood
VOUCHER_RESTTotal del carritoTienda
VOUCHER_ENTGRATISEnvíoiFood
CampoValor
targetCART o DELIVERY_FEE
sponsorshipIFOOD o MERCHANT
Documentación completa: Estructura de cupones →Los cupones por artículo (ITEM, PROGRESSIVE_DISCOUNT_ITEM) requieren campañas. Usa los ejemplos de respuesta para mapear estos escenarios.
  • Activa Modo de prueba (Perfil > Editar datos > Modo de prueba)
  • Verifica polling /events:polling
  • Usa exactamente: Ramal Bujari, 100
  • Ingresa Bujari en barrio
  • Espera hasta 30s (retraso de procesamiento)
  • Usa el ID del modal de confirmación
  • Verifica el header x-request-homologation
  • Si 404: implementa retry con backoff (hasta 10 minutos)
  • Implementa polling cada 30s o registra un webhook
  • Envía ACKs para los eventos recibidos
  • Verifica código, país (BR/CO), mínimo y uso previo

Haz:
  • Probar métodos de pago soportados
  • Simular diferentes valores
  • Probar con y sin cupones
  • Validar todos los eventos
  • Usar retry para 404s (exponential backoff, hasta 10 minutos)
Evita:
  • Usar tarjetas reales
  • Hacer polling más rápido que 30s
  • Consultar pedidos con más de 7 días
  • Retries infinitos


¿Necesitas ayuda? Abre un ticket de soporte →
¿Esta página fue útil?
Evalúa tu experiencia en el nuevo portal de desarrolladores: