Skip to content

Integrating with Keeta API

  • Authenticate

    All API endpoints (except Get Access Token itself) require authentication. Therefore, you must first obtain an access token by calling the Get Access Token endpoint before making any further requests.

  • Configure Store Mapping and Webhooks

    After obtaining the access token, you can register the mapping between your internal merchantId and the Keeta merchantId, and configure webhook endpoints by calling the Merchant Onboarding endpoint.

  • Place a Test Order

    Once the store mapping has been successfully configured, refer to the Keeta Test App to place a test order for the configured store and proceed to the Order Module testing phase.

  • Order Workflow Testing

    At this stage, whenever a new order is placed from the registered store, you will receive a PLACED event via webhook or polling.

    Upon receiving a PLACED event, you should first retrieve order details, and then either confirm or cancel the order.

    Once the order is prepared, you must either mark it as ready or dispatch it — depending on whether the delivery will be fulfilled by the merchant or a third-party logistics provider.

    ✅ Good job! Your app is now ready to receive and process orders. For more advanced features, please refer to the relevant sections of this documentation.