Search in documentation
ctrl+4K
First steps
Homologation
About our APIs

Application blocking

To ensure platform security and stability, follow our Best practices when integrating with iFood APIs. Inappropriate use may result in temporary or permanent blocking of your account.Our systems monitor API usage. If we detect violations, we will send an email with:
  • Type of infraction and evidence
  • Deadline for correction
  • Consequences if not corrected within the deadline
Updated data
Keep your data updated (email, phone) to receive notifications about infractions. Outdated data may result in blocks without prior notice.
LevelRestriction
IThe Integrator's application will be removed from the Marketplace area in the Partner Portal. If it's a Super Integrator, they will lose the program seal.
IIThe integration will be prevented from requesting new merchant authorizations for their application.
IIIApplication blocked from consuming iFood APIs
At this blocking level, the Integrator's application will be removed from the Partner Portal Marketplace list, making it impossible for Merchants to view the application. This action will directly impact the realization of new integrations with Merchants.
Level I correction deadline
Correction deadline: 15 calendar days, counted from the date of sending the first communication.
At this blocking level, the integration will be subject to all sanctions provided for in level I blocking. Additionally, it will not be possible to request new merchant authorizations for the application. Merchants that already use the POS will also not be able to reauthorize the application if the session expires.The integrator will also lose eligibility for the Super Integrator program in the next award cycle at this level II blocking.
Level II correction deadline
Deadline for level II blocking correction: 15 calendar days after the first communication.
At this blocking level, the integration will be subject to all sanctions provided for in level I and level II blocking. Additionally, the application will be completely blocked from consuming iFood APIs, meaning no merchant integrated to this integrator's system will be able to use the integration with iFood. Initially, a temporary 24-hour block will be applied during a period of lower order volume. If the integrator does not present an action plan within the established deadline, the application will be blocked again and for an indefinite period, without time restrictions.
Level III correction deadline
Deadline to present action plan: 10 calendar days after the 24-hour temporary block.
Resolution deadline
iFood reserves the right to define/update the resolution deadline for infractions committed by the integrator. This deadline will be stipulated and formally communicated to the integrator.
  • Not sending ack for polling events
  • Sending requests with invalid format (Error 400)
  • Using invalid or expired tokens (Error 401)
  • Querying details of non-existent orders (Error 404)
  • Querying unauthorized Merchants (Error 403)
  • Polling with intervals less than 30 seconds
  • Querying the same order more than 10 times
  • Exceeding the maximum requests that a single application can make in a given time period (Rate Limit)
  • Improperly exposing credentials in the url
  • Keeping the application inactive without API calls for 90 consecutive days
The endpoints listed below will have more rigorous monitoring, leading to the application of sanctions when abusive use is identified, including reflecting on the eligibility requirements of the Super Integrators Program.
EndpointLimits
/orders/{id}Maximum error rate <= 2%
/orders/{id}/confirmMaximum error rate <= 2%
/orders/{id}/requestCancellationMaximum error rate <= 2%
/events:pollingMaximum error rate <= 1%
/merchants/{merchantId}/statusMaximum error rate <= 1%
/merchants/{merchantId}Maximum error rate <= 2%
/merchantsMaximum error rate <= 2%
/merchants/{merchantId}/interruptionsMaximum error rate <= 2%
/events/acknowledgmentMinimum ack rate >= 95%
Criteria for error rate calculation:
  • Evaluation of the last 24 hours
  • Rate per endpoint = Requests with error / Total requests
  • For /events/acknowledgment: Rate = Acks sent / Total pollings
Non-compliance with these limits will result in integration blocking.
Types of infractions
iFood may change or add new types of infractions at any time without prior notice.
  1. Fix all identified infractions
  2. Reply to the notification email with:
    • Confirmation that you fixed the infractions
    • Exact date of the correction
Our team analyzes your request and:
  • If we confirm the correction: we unblock your application.
  • If infractions persist: we maintain the block and the original deadline.
Was this page helpful?
Rate your experience in the new Developer portal: