MercatDevelopers
  1. Webhooks
MercatDevelopers
  • Getting Started
  • Auth
    • Authenticate client
      POST
  • Stores
    • List all stores
      GET
    • Get store details
      GET
  • Menus
    • Get menu details
      GET
  • Orders
    • Get order details
      GET
  • Webhooks
    • Webhooks
    • stores.update
    • orders.create
    • orders.update
    • menus.update
  1. Webhooks

orders.create

Webhook
POST
orders.create
Triggered when an order is created:
Cash/card payments: immediately with status created
Online payments: after payment confirmation (status created)
Scheduled orders: with status creation_scheduled
The payload contains the full Order object including items, deliveries, and customer information.
See stores.update webhook for HTTP request details, delivery guarantees, security, and best practices.

Request

Body Params application/jsonRequired

Example
{
    "client_id": "acme-corp",
    "event_id": "660e8400-e29b-41d4-a716-446655440001",
    "event_type": "orders.create",
    "event_timestamp": 1705348900,
    "api_version": "v1",
    "event_data": {
        "id": 12345,
        "user_phone": "+56912345678",
        "user_email": "customer@example.com",
        "user_address": "123 Main Street, Santiago",
        "user_name": "John Doe",
        "apartment_details": "Apt 4B",
        "user_latitude": -33.4489,
        "user_longitude": -70.6693,
        "dispatch_note": "Ring doorbell",
        "dispatch_method": "store_delivery",
        "store_id": 1,
        "status": "created",
        "platform": "web",
        "requested_time": "2024-01-15T19:30:00Z",
        "promised_delivery_time": "2024-01-15T20:00:00Z",
        "promised_pick_up_time": null,
        "created_at": "2024-01-15T19:25:00Z",
        "subtotal_price": 25.5,
        "delivery_price": 3,
        "tip": 2.5,
        "discount": 0,
        "loyalty_discount": 0,
        "total_price": 31,
        "items": [
            {
                "id": 1,
                "product_id": 101,
                "quantity": 2,
                "name": "Margherita Pizza",
                "instructions": "Extra cheese please",
                "price": 12.5,
                "modifiers": [
                    {
                        "id": 5,
                        "name": "Extra Cheese",
                        "price": 2,
                        "action": "add",
                        "quantity": 1
                    }
                ]
            }
        ],
        "deliveries": [
            {
                "id": 1,
                "type": "own_delivery",
                "confirmation_code": "ABC123",
                "status": "confirmed",
                "tracking_url": "https://tracking.example.com/ABC123"
            }
        ]
    }
}

Responses

🟢200OK
Webhook received successfully
This response does not have a body.
🔴500Server Error
Modified at 2026-02-17 15:11:07
Previous
stores.update
Next
orders.update
Built with