Ontwikkelaars

Codevoorbeelden

Volledige flows in curl en JavaScript: een afhaalbestelling vanuit een app, inloggen van klanten met loyaliteit, en een tafel reserveren.

De technische documentatie is in het Engels.

Takeaway order from an app

A customer app picks a location, shows the menu, places a pickup order, sends the customer to pay and follows the order until it is ready. Only the publishable key is needed.

  1. 1

    List locations

    Pick a location; its sales_channel_token goes in X-Sales-Channel from now on. Reference

    curl
    curl "https://api.conciar.com/connect/v1/locations" \
  -H "Accept: application/json" \
  -H "X-Api-Key: pk_your_publishable_key"
  2. 2

    Load the menu

    Categories, items and option groups with prices. Reference

    curl
    curl "https://api.conciar.com/connect/v1/store/restaurant/menu" \
  -H "Accept: application/json" \
  -H "X-Api-Key: pk_your_publishable_key" \
  -H "X-Sales-Channel: cnct_ch_your_channel_token"
  3. 3

    Place the order

    Returns the order, its order_token and the payment URL. Reference

    curl
    curl -X POST "https://api.conciar.com/connect/v1/store/restaurant/orders" \
  -H "Accept: application/json" \
  -H "X-Api-Key: pk_your_publishable_key" \
  -H "X-Sales-Channel: cnct_ch_your_channel_token" \
  -H "Idempotency-Key: order-2026-10-16-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "item_id": 101,
        "qty": 2,
        "options": [
          501
        ]
      }
    ],
    "customer": {
      "first_name": "Alex",
      "email": "alex@example.com"
    },
    "payment_method_key": "ideal",
    "return_url": "https://www.example.com/order/return"
  }'
  4. 4

    Follow the order

    Poll with the order_token until the status is ready. Reference

    curl
    curl "https://api.conciar.com/connect/v1/store/restaurant/orders/EXAMPLE-0001" \
  -H "Accept: application/json" \
  -H "X-Api-Key: pk_your_publishable_key" \
  -H "X-Sales-Channel: cnct_ch_your_channel_token" \
  -H "X-Order-Token: ot_example_order_token"

Customer sign-in and loyalty

Sign a customer in with an emailed code, then show their points, stamp card and deals.

  1. 1

    Send a sign-in code

    The customer gets a 6-digit code by email. Reference

    curl
    curl -X POST "https://api.conciar.com/connect/v1/auth/otp/request" \
  -H "Accept: application/json" \
  -H "X-Api-Key: pk_your_publishable_key" \
  -H "Content-Type: application/json" \
  -d '{
    "identifier": "alex@example.com",
    "type": "email"
  }'
  2. 2

    Verify the code

    Returns the access token. Reference

    curl
    curl -X POST "https://api.conciar.com/connect/v1/auth/otp/verify" \
  -H "Accept: application/json" \
  -H "X-Api-Key: pk_your_publishable_key" \
  -H "Content-Type: application/json" \
  -d '{
    "identifier": "alex@example.com",
    "type": "email",
    "code": "123456"
  }'
  3. 3

    Show loyalty

    With Authorization: Bearer and the access token. Reference

    curl
    curl "https://api.conciar.com/connect/v1/store/customer/loyalty" \
  -H "Accept: application/json" \
  -H "X-Api-Key: pk_your_publishable_key" \
  -H "X-Sales-Channel: cnct_ch_your_channel_token" \
  -H "Authorization: Bearer your_customer_access_token"

Check availability and book a table

With the public booking API, no key: check the restaurant, find an open day and time, book, and handle a deposit or card guarantee.

  1. 1

    Get the booking settings

    Whether the restaurant takes online bookings and the largest party. Reference

    curl
    curl "https://api.conciar.com/public/v1/restaurants/bistro-example" \
  -H "Accept: application/json"
  2. 2

    Find an open day

    Each day of the month: open, closed, full or unavailable. Reference

    curl
    curl "https://api.conciar.com/public/v1/restaurants/bistro-example/calendar?party_size=2&month=2026-10" \
  -H "Accept: application/json"
  3. 3

    List the times

    Bookable times on that day, with any deposit or guarantee. Reference

    curl
    curl "https://api.conciar.com/public/v1/restaurants/bistro-example/times?party_size=2&date=2026-10-24" \
  -H "Accept: application/json"
  4. 4

    Book

    Confirmed straight away, or a payment or card page in next_step. Reference

    curl
    curl -X POST "https://api.conciar.com/public/v1/restaurants/bistro-example/reservations" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id": "6f1c2a9e-0000-4000-8000-000000000000",
    "party_size": 2,
    "date": "2026-10-24",
    "time": "19:00",
    "first_name": "Alex",
    "last_name": "Example",
    "email": "alex@example.com",
    "phone_country_id": 150,
    "phone": "+31 6 00000000",
    "return_url": "https://www.example.com/booked"
  }'
  5. 5

    Check after paying

    Look the booking up by your request_id. Reference

    curl
    curl "https://api.conciar.com/public/v1/restaurants/bistro-example/reservations/6f1c2a9e-0000-4000-8000-000000000000" \
  -H "Accept: application/json"

Keys, tokens, names and ids in these examples are made up. Every endpoint, parameter and error code is in the API reference.