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

Generate test orders

iFood offers two ways to create orders to test your integration. Choose the one that fits your scenario.

Create orders instantly with one click in the Developer Portal.What is generated automatically
  • Default delivery address
  • Store catalog items
  • Default payment method
  • Linked test customer
Multi-category apps (grocery, pharmacy, pet shop, shopping) must use manual generation — automatic generation is temporarily unavailable.

  1. Go to developer.ifood.com.br and sign in.
  2. Open the Tests menu (click your name or the side menu).
  3. Click Generate test order (top-right).
  4. Select the test store.
  5. Confirm — the order is created instantly.
After generation, the modal shows:
  • Store name — identification
  • Order ID — use in API calls
  • User email — login in the app (test mode)
Next steps:
  • Query: GET /orders/{id}
  • Track the order in the app using the provided email
  • Manage the order using the API modules

Simulate a real purchase in the iFood app or site to test flows and edge cases.When to use
  • Test specific catalog items
  • Test different payment methods
  • Apply discount coupons
  • Validate the full checkout flow

1. Sign in
Open ifood.com.br or the iFood app. Use the test email from: Developer Portal > Tests > Test Users

2. Set the test addressa) Click "Deliver to" (top of the page)
b) Search: Ramal Bujari, 100
c) Complete and save:
  • Confirm the location on the map
  • In Neighborhood, type Bujari
  • Click Save Address

3. Keep the store openTest stores operate 24/7 but only appear open when connected to the API.Poll every 30 seconds: GET /events:pooling
Store appears closed? Check that your app:
  • Polls regularly
  • Sends correct authentication headers
  • Processes received events
Learn more about polling →

4. Find your test store
  • Use the search bar and type the exact store name.
  • Select the store from the results.
Store not listed?
  1. Open Profile
  2. Select Edit details
  3. Turn on Test Mode
Still not listed? Open a support ticket →

5. Build the order
  • Add products from the catalog.
  • Reach the store's minimum order value.

6. Complete checkoutChoose payment method:
MethodRecommendationNote
Cash on deliveryPreferredNo card data required
Card on deliveryRecommendedNo card data required
Online credit cardUse test dataSee below
PIX❌ Not availableNot supported in tests
Bank debit❌ Not availableNot supported in tests
Test card data
Number: 4111 1111 1111 1111
Expiry: 03/2030
CVV: 737
Use only these test details. Never use real cards.

  • You will receive events via API.
  • You can query: GET /orders/{id}.
  • You can track the order in the iFood app.

  1. In checkout, before placing the order
  2. Click Add coupon
  3. Enter the code and confirm
CodeDiscount applied toPaid by
VOUCHER_IFOODFull cartiFood
VOUCHER_RESTFull cartMerchant
VOUCHER_ENTGRATISDelivery feeiFood
FieldValue
targetCART or DELIVERY_FEE
sponsorshipIFOOD or MERCHANT
Full docs: Coupon structure →Item-specific coupons (ITEM, PROGRESSIVE_DISCOUNT_ITEM) require campaigns. Use the response examples to map these scenarios.
  • Enable Test Mode (Profile > Edit details > Test Mode)
  • Check polling /events:polling
  • Use exactly: Ramal Bujari, 100
  • Enter Bujari in neighborhood
  • Wait up to 30s (processing delay)
  • Use the Order ID from the confirmation modal
  • Check x-request-homologation header
  • If 404: implement retry with backoff (up to 10 minutes)
  • Poll every 30s or register a webhook
  • Send ACKs for received events
  • Check code, country (BR/CO), minimum value, and prior use

Do:
  • Test supported payment methods
  • Simulate different order totals
  • Test with and without coupons
  • Validate all events
  • Use retry for 404s (exponential backoff, up to 10 minutes)
Avoid:
  • Using real card data
  • Polling faster than 30s
  • Querying orders older than 7 days
  • Infinite retries

Was this page helpful?
Rate your experience in the new Developer portal: