Integration steps

1. Register your POS

   You create the account in the portal and receive a partner_name. See account registration.

2. Add the two mandatory contacts

   Without them you cannot perform operations in the system. See account registration.

3. Create an API key

   It is the value you send on the Authorization header and, at the same time, the key that protects your own endpoints. See API keys.

4. Define your endpoints

   At least one of type order notification. You can test them from the portal before saving. See endpoints.

5. Implement order reception

   Your endpoint accepts a POST with JSON, validates the Authorization header and replies 200. See receiving orders.

6. Implement menu updates

   Build the menu payload and send it. Validate it first, so format errors do not eat into your daily quota. See full menu update.

7. Allocate a test store and test end to end

   Point the test store at your webhook, place real orders on it and check what you received. See test store.

8. Verify your results in the trace

   Look your test orders up by code and confirm that what we sent matches what you processed. See order lookup.

9. Add the real brands and locations

   Every location must be activated by our team before it receives orders. See brands and locations.

10. Release the test store

    There are only so many of them, and the allocation expires in two weeks anyway. See test store.

Before you request a live store

• Your order endpoint replies 200 and does not process the same order twice (unique index on order_code).
• The menu passes validation with no errors.
• You have tested orders where the customer asks for cutlery, has allergies and adds paid attributes.
• You have tested a marketplace order, where you receive customer details and the address.
• You have decided whether to enable delivery retry.