Order Webhook Structure

Order Webhook Structure

Foodmato sends order updates through webhooks for POS and integrators.

Events sent by Foodmato

  • order.created

  • order.accepted

  • order.preparing

  • order.ready

  • order.picked_up

  • order.completed

  • order.cancelled

Sample webhook payload

{
  "event": "order.created",
  "timestamp": "2025-02-14T10:30:00Z",
  "order_id": "12345",
  "restaurant_id": "987",
  "items": [
    {
      "name": "Margherita Pizza",
      "quantity": 1
    }
  ],
  "total_amount": 18.50,
  "customer": {
    "name": "John Doe",
    "phone": "+49 123 456789"
  }
}

Securing webhooks

  • Validate signature header

  • Use HTTPS endpoints

  • Use IP allow listing (optional for enterprises)

Recommended best practices

  • Acknowledge payloads with 200 OK

  • Retry logic on integrator side

  • Store event logs for reconciliation

    • Related Articles

    • API Access Request

      Foodmato provides API access for approved partners such as POS systems, aggregators, and enterprise restaurants. Who can request API access POS companies Delivery management platforms Multi-branch restaurants Integrators onboarding multiple merchants ...

    • Troubleshooting Merchant Device

      Common issues & fixes 1. Device not receiving orders ✔ Check internet connection ✔ Ensure app is running in foreground ✔ Disable battery saver mode ✔ Restart device 2. Printer not printing Check Bluetooth pairing Ensure paper is loaded correctly ...

    • POS Integration Steps (Deliverect, Otter, etc.)

      Foodmato supports planned integrations with Deliverect, Otter, and other POS aggregators (2025 roadmap). Integration flow Merchant chooses POS provider POS provider requests Foodmato API access Restaurant links Foodmato account to the POS Menus and ...

    • Update Requirements

      Keeping the Merchant App updated ensures: Faster loading Better compatibility Security improvements New features (prep time, menu tools, etc.) How to update Go to the Play Store Search Foodmato Merchant Tap Update If automatic updates are enabled, ...