KPrimeros pasos
Homologación
Sobre nuestras APIs
Bloqueo de aplicaciones
Para garantizar la seguridad y estabilidad de la plataforma, sigue nuestras Mejores prácticas al integrar con las APIs de iFood. El uso inadecuado puede resultar en bloqueo temporal o permanente de tu cuenta.Nuestros sistemas monitorean el uso de las APIs. Si detectamos violaciones, enviaremos un email con:- Tipo de infracción y evidencias
- Plazo para corrección
- Consecuencias si no corriges en el plazo
Datos actualizados
Mantén tus datos actualizados (email, teléfono) para recibir notificaciones sobre infracciones. Datos desactualizados pueden resultar en bloqueos sin aviso previo.
Niveles de bloqueo
| Nivel | Restricción |
|---|---|
| I | La aplicación del Integrador será retirada del área de Marketplace en el Portal del Socio. En caso de ser un Super Integrador, el mismo perderá el sello del programa. |
| II | La integración quedará impedida de solicitar para su aplicación nuevas autorizaciones de merchants. |
| III | Bloqueo de la aplicación para consumo de las APIs de iFood |
Nivel I
En este nivel de bloqueo, la aplicación del Integrador será removida de la lista del Marketplace del Portal del Socio, lo que imposibilitará que los Merchants visualicen la aplicación. Esta acción impactará directamente la realización de nuevas integraciones con los Merchants.Plazo de corrección Nivel I
Plazo de corrección: 15 días corridos, contados a partir de la fecha de envío del primer comunicado.
Nivel II
En este nivel de bloqueo, la integración estará sujeta a todas las sanciones previstas en el bloqueo de nivel I. Además, no será posible solicitar nuevas autorizaciones de merchants para la aplicación. Merchants que ya utilizan el PDV tampoco podrán reautorizar la aplicación si la sesión expira.El integrador también perderá la elegibilidad al programa Super Integrador en el próximo ciclo de premiación en este nivel de bloqueo II.Plazo de corrección Nivel II
Plazo para corrección del bloqueo nivel II: 15 días corridos después del primer comunicado.
Nivel III
En este nivel de bloqueo, la integración estará sujeta a todas las sanciones previstas en el bloqueo de nivel I y nivel II. Además, la aplicación será completamente bloqueada para consumo de las APIs de iFood, es decir, ningún merchant integrado al sistema de este integrador conseguirá utilizar la integración con iFood. Inicialmente, será aplicado un bloqueo temporal de 24 horas, en un período de menor volumen de pedidos. Si el integrador no presenta un plan de acción dentro del plazo establecido, la aplicación será bloqueada nuevamente y por tiempo indeterminado, sin restricción de horarios.Plazo de corrección Nivel III
Plazo para presentar plan de acción: 10 días corridos después del bloqueo temporal de 24 horas.
Plazo de resolución
iFood se reserva el derecho de definir/actualizar el plazo de resolución de las infracciones cometidas por el integrador. Este plazo será estipulado y comunicado formalmente al integrador.
Tipos de infracciones
- No enviar ack para los eventos de polling
- Enviar solicitudes con formato inválido (Error 400)
- Usar tokens inválidos o expirados (Error 401)
- Consultar detalles de pedidos inexistentes (Error 404)
- Consultar Merchants no autorizados (Error 403)
- Hacer polling con intervalo menor a 30 segundos
- Consultar más de 10 veces el mismo pedido
- Exceder el máximo de solicitudes que una sola aplicación puede hacer en un período de tiempo determinado (Rate Limit)
- Exponer indebidamente credenciales en la url
- Mantener la aplicación inactiva sin llamadas a la API por 90 días consecutivos
| Endpoint | Límites |
|---|---|
| /orders/{id} | Tasa máxima de error <= 2% |
| /orders/{id}/confirm | Tasa máxima de error <= 2% |
| /orders/{id}/requestCancellation | Tasa máxima de error <= 2% |
| /events:polling | Tasa máxima de error <= 1% |
| /merchants/{merchantId}/status | Tasa máxima de error <= 1% |
| /merchants/{merchantId} | Tasa máxima de error <= 2% |
| /merchants | Tasa máxima de error <= 2% |
| /merchants/{merchantId}/interruptions | Tasa máxima de error <= 2% |
| /events/acknowledgment | Tasa mínima de ack >= 95% |
Cálculo de la tasa de error
Criterios para cálculo de la tasa de error:- Evaluación de las últimas 24 horas
- Tasa por endpoint = Requests con error / Total de requests
- Para /events/acknowledgment: Tasa = Acks enviados / Total de pollings
Tipos de infracciones
iFood puede alterar o adicionar nuevos tipos de infracciones en cualquier momento sin aviso previo.
Cómo desbloquear tu aplicación
- Corrige todas las infracciones identificadas
- Responde al email de notificación con:
- Confirmación de que corregiste las infracciones
- Fecha exacta de la corrección
- Si confirmamos la corrección: desbloqueamos tu aplicación.
- Si las infracciones persisten: mantenemos el bloqueo y el plazo original.
¿Esta página fue útil?
Evalúa tu experiencia en el nuevo portal de desarrolladores: