RaioMerchant

Developers

Plug Raio into your own systems

A clean REST API to connect your POS, stock management or ERP to your Raio store. Orders flow into the tools you already use — no double entry, no tablets stacked on the counter.

REST + Webhooks

Predictable, documented, versioned

JSON over HTTPS, bearer-token authentication, and webhooks for everything that happens to an order. If you've used a modern payment API, you already know how this works.

  • Sandbox environment with test orders and couriers
  • Signed webhooks with automatic retries
  • Rate limits designed for real kitchens, not toys
  • Versioned API — we never break you silently
# Fetch your open orders
curl https://api.raio.app/v1/orders?status=open \
  -H "Authorization: Bearer rk_live_xxxxxxxxxxxx"

{
  "data": [
    {
      "id": "ord_8f3k2m",
      "status": "open",
      "customer": { "name": "J. Silva", "zone": "Pinheiros" },
      "items": [
        { "name": "Feijoada completa", "quantity": 2, "unit_price": 45.90 }
      ],
      "total": 91.80,
      "currency": "BRL",
      "placed_at": "2026-07-09T12:04:11-03:00"
    }
  ]
}

Getting access

From sandbox to production in four steps

  1. 01

    Create a developer account

    Any registered Raio merchant can enable developer access from the dashboard, free of charge.

  2. 02

    Get your sandbox keys

    Test against a full sandbox environment with fake orders and couriers — no real customers involved.

  3. 03

    Build and certify

    Follow the integration checklist. Our team reviews your flows for order acceptance and error handling.

  4. 04

    Go live

    Swap sandbox keys for production keys and your integration is live for all your locations.

Ready to build?

Read the docs or request sandbox keys — and if you're a POS vendor working with multiple merchants, ask about our technology partner program.

Read the API docsRequest sandbox access