Integrate a food ordering or reservations marketplace platform

Introduction

Your client or company must have a Sinqro Channel account. Get Sinqro connected businesses real-time info, get the order or reservation in your marketplace and push the request to Sinqro API.

Getting started

To get started using any Sinqro API you need to create your developer account

Once in your developer panel, create an app integration:

  1. Go to Platform Integrations
  2. Click on New Platform Integration
  3. In the form, select Integrate a food ordering or reservations marketplace platform
  4. Wait for your platform integration request approval

Once your request has been approved, you can manage your platform integration details and get you API credentials (required to call our API as you will see in the API Security section)

Use Cases

We're sorry, we are still working in the GUIDE for this case. For now you can only access the API reference.

Market Platform API Basics

Environments

Sandbox

https://sandbox-api.sinqro.com/market-platform/v1

Production

https://api.sinqro.com/market-platform/v1

Security

About your credentials
In order to get your credentials, you need first to create your Platform Integration. You can find the steps at Getting Started section.
Authorization

All API services require an authorization token sent in headers ‘x-api-server-access-token’.

You can get your platform integration assigned token in your developer panel.

Authentication

All this API services require an authentication token sent in headers 'x-api-user-access-token'.

You can get your platform integration assigned token in your developer panel.

Errors

Error codeHTTPError message
CART_ADD_PRODUCT_FAILED400Cart add product failed
CART_AMOUNT_INSUFFICIENT400The amount does not exceed the minimum necessary
CART_EMPTY400Cart is empty
CART_EMPTY_AMOUNT400Cart total amount is 0
CART_ITEM_TYPE_CODE_REQUIRED400Item type code is required
CART_ITEM_TYPE_NOT_FOUND404Cart item type not found
CART_NOT_FOUND404Cart not found
CART_TOKEN_REQUIRED400Cart token is required
CONSUMER_NAME_REQUIRED400Consumer name required
CONSUMER_PHONE_NUMBER_REQUIRED400Consumer phone number required
DINERS_NUMBER_CAN_NOT_BE_0400Diners number can't be 0
ERROR_CREATING_ADDRESS400Error creating address
EXTERNAL_CONSUMER_ID_REQUIRED400External consumer ID required
INACCURATE_ADDRESS400More accurate address is needed
INVALID_MENU_QUANTITY400Invalid menu quantity
INVALID_PRODUCT_QUANTITY400Invalid product quantity
MAX_DINERS_EXCEEDED400Max diners exceeded
MENU_ID_REQUIRED400Menu ID is required
MENU_NOT_FOUND404Menu not found
MENU_SECTION_ID_REQUIRED400Menu section ID is required
MENU_SECTION_NOT_FOUND404Menu section not found
MENU_SELECTION_NOT_FOUND404Menu selection not found
ORDER_CANCELLATION_COMMENT_IS_REQUIRED400Order cancellation comment is required
ORDER_CANT_BE_CANCELLED_BY_CLIENT400Order can't be cancelled by client
ORDER_CAN_NOT_BE_CREATED400Order can not be created
ORDER_NOT_FOUND404Order not found
ORDER_PLACE_REQUIRED400Place is required for order creation
ORDER_POSTAL_CODE_REQUIRED400Postal code is required to calculate times
ORDER_TYPE_CODE_REQUIRED400Order type code is required
ORDER_TYPE_NOT_FOUND404Order type not found
OUT_OF_RANGE400The address is out of range
POSTAL_CODE_NOT_ALLOWED_FOR_DELIVERY400Postal code is not allowed for delivery
PRODUCT_ID_REQUIRED400Product ID is required
PRODUCT_NOT_FOUND404Product not found
PRODUCT_OPTION_NOT_FOUND404Product option not found
SELLING_POINT_ID_REQUIRED400SellingPoint ID is required
SELLING_POINT_NOT_FOUND404SellingPoint not found
UNAUTHORIZED401Unauthorized request
UNAVAILABLE_PRODUCT400Unavailable product
UNAVAILABLE_PRODUCT_OPTION400Unavailable product option
UNDEFINED_PAYMENT_METHOD400Select payment method

Market Platform API Services