How it works

Integration flow

1. Discovery

• GET /merchants — Lists all stores linked to your token
• GET /merchants/{merchantId} — Gets complete details of a store

2. Monitoring

• GET /merchants/{merchantId}/status — Queries store availability

• OK — Ready to receive orders
• WARNING — Online with restrictions
• CLOSED — Closed (expected, outside operating hours)
• ERROR — Problem to investigate

3. Operational management

• PUT /merchants/{merchantId}/opening-hours — Sets weekly hours
• GET /merchants/{merchantId}/opening-hours — Queries hours

• POST /merchants/{merchantId}/interruptions — Creates pause
• GET /merchants/{merchantId}/interruptions — Lists pauses
• DELETE /merchants/{merchantId}/interruptions/{interruptionId} — Removes pause

4. Check-in (Groceries Stores)

• POST /merchants/checkin-qrcode — Generate PDF with QR codes for printing

1. List all stores linked to your token
2. Every 30 seconds: Query status of each store
3. If status = ERROR: Investigate specific validations
4. If needed to pause: Create interruption
5. For Groceries stores: Generate and maintain printed QR codes

Store queries

List all stores

curl --location 'https://merchant-api.ifood.com.br/merchant/v1.0/merchants' \
  --header 'Authorization: Bearer TOKEN'

• page - Page number (starting at 1)
• size - Number of stores per page (default: 100)

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Pizzaria Central",
    "corporateName": "Pizzaria Central LTDA"
  },
  {
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "name": "Burger King #42",
    "corporateName": "Restaurant Brands International Brazil"
  }
]

Get store details

curl --location 'https://merchant-api.ifood.com.br/merchant/v1.0/merchants/550e8400-e29b-41d4-a716-446655440000' \
  --header 'Authorization: Bearer TOKEN'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Pizzaria Central",
  "corporateName": "Pizzaria Central LTDA",
  "description": "Specializes in Neapolitan pizza",
  "averageTicket": 85.50,
  "exclusive": false,
  "type": "RESTAURANT",
  "status": "AVAILABLE",
  "createdAt": "2024-01-15T10:30:00",
  "address": {
    "street": "Rua das Flores",
    "number": "123",
    "city": "São Paulo",
    "state": "SP",
    "postalCode": "01310-100",
    "country": "BR",
    "district": "Centro",
    "latitude": -23.5505,
    "longitude": -46.6333
  },
  "operations": {
    "name": "delivery",
    "salesChannel": {
      "name": "ifood-app",
      "enabled": true
    }
  }
}

Store status

Requirements to receive orders

1. Within opening hours
2. Has a catalog with at least one menu enabled
3. Has a delivery area configured
4. Has no active interruptions
5. Receives polling every 30 seconds

Check availability

• is-connected: Polling every 30 seconds
• opening-hours: Within opening hours

Penalties

• Automatic: Do not allow immediate reopening (e.g., many cancellations). Wait for the penalty to end.
• Manual: Can be removed by the store (e.g., interruptions created by the store).

Check reopening possibility

{
  "reopenable": {
    "identifier": "cca57aab-5ac0-4af4-a04d-48261350bebc",
    "type": "UNAVAILABILITY",
    "reopenable": true
  }
}

Interruptions

List interruptions

Create interruption

Remove interruption

Opening hours

List hours

Configure hours

Configuration example

{
  "storeId": "09e9a8c8-fda3-4991-acfc-43b15397caf6",
  "shifts": [
    {
      "dayOfWeek": "MONDAY",
      "start": "09:00:00",
      "duration": 360
    },
    {
      "dayOfWeek": "TUESDAY",
      "start": "09:00:00",
      "duration": 360
    },
    {
      "dayOfWeek": "WEDNESDAY",
      "start": "09:00:00",
      "duration": 360
    },
    {
      "dayOfWeek": "THURSDAY",
      "start": "09:00:00",
      "duration": 360
    },
    {
      "dayOfWeek": "FRIDAY",
      "start": "05:00:00",
      "duration": 420
    },
    {
      "dayOfWeek": "FRIDAY",
      "start": "13:00:00",
      "duration": 300
    },
    {
      "dayOfWeek": "FRIDAY",
      "start": "19:00:00",
      "duration": 210
    }
  ]
}

Check-in do entregador

Generate QR code

• Maximum: 20 stores per request
• All stores must be linked to the access token

Next steps

• Introduction — Module overview
• Endpoints — Detailed technical reference
• Operations — Configure operation types
• Best Practices — Recommended patterns
• Homologation — Validation criteria

• Orders (Order) — Receive, confirm, and manage orders
• Logistics — Track order delivery
• Catalog — Manage menus and prices
• Events — Receive real-time notifications

Support

• Contact support
• API References with all endpoints
• Homologation criteria to validate your integration