Build & sell an app for a food ordering or reservations marketplace clients

Introduction

Build an app for a specific chain or group where the user can order food or book a table to the marketplace related selling points.

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 Apps
  2. Click on New App
  3. In the form, select Build & sell an app for a food ordering or reservations marketplace clients
  4. Wait for your app request approval

Once your request has been approved, you can manage your app 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 App API Basics

Environments

Sandbox

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

Production

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

Security

About your credentials
In order to get your credentials, you need first to create your App. 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 app assigned token in your developer panel.

Authentication

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

You can the retrieve the user token with a successful request to the login API service..

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
CHECKOUT_ALREADY_CLOSED400Chekout already closed
CHECKOUT_ALREADY_USED_TO_CREATE_ORDER400Checkout already used to create order
CLIENT_ACCOUNT_REQUIRED400ClientAccount is required
CLIENT_MAX_DISCOUNT_USAGES_REACHED_LIMIT400Client max discount usages reached limit
CLIENT_NOT_FOUND404Client not found
CLIENT_WITHOUT_ACCOUNT_PERMISSION400Client doesn't have client permission for the current client account
CONSUMER_ID_REQUIRED400Consumer Id required
CONSUMER_NOT_FOUND404Consumer not found
COUPON_CAN_NOT_BE_ADDED_TWICE400Coupon can not be added twice
COUPON_DOES_NOT_EXISTS400Coupon does not exists
COUPON_NOT_FOUND404Coupon not found
DINERS_NUMBER_CAN_NOT_BE_0400Diners number can't be 0
DISCOUNT_MAX_USAGES_REACHED_LIMIT400Discount max usages reached limit
DISCOUNT_MIN_CART_AMOUNT_INSUFFICIENT400Discount min cart amount insufficient
DISCOUNT_ONLY_ALLOW_FIRST_ORDER400Discount only allow first order
EMAIL_ALREADY_IN_USE400Email is already in use
EMAIL_REQUIRED400Email is required
ERROR_CREATING_ADDRESS400Error creating address
INACCURATE_ADDRESS400More accurate address is needed
INSUFFICIENT_ACCOUNT_AMOUNT400Wallet amount used exceed account balance amount
INVALID_DISCOUNT_DATES400Invalid discount dates
INVALID_EMAIL400Invalid email
INVALID_MENU_QUANTITY400Invalid menu quantity
INVALID_PRODUCT_QUANTITY400Invalid product quantity
LASTNAME_REQUIRED400Lastname is required
LOGIN_ERROR400Incorrect user or password
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
MOBILE_REQUIRED400Mobile is required
NAME_REQUIRED400Name is required
ORDER_AMOUNT_INSUFFICIENT_AFTER_DISCOUNT_APPLIED400Order amount insufficient after discount applied
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_PAYMENT_CREATION_FAILED400Order payment creation failed
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
PASSWORD_REQUIRED400Password is required
PAYMENT_AMOUNT_NOT_ALLOWED400Payment amount exceed order pending amount
PHONE_LENGTH_ERROR400Phone lenght error
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
RECOVERY_CODE_NOT_MATCH400Recovery code does not match
RECOVERY_CODE_REQUIRED400Recovery code is required
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
WRONG_SELECTED_TIME400Wrong selected time

Market App API Services