Prerequisites for Marketplace Application Development

Before you begin developing your marketplace application for integration with the POS Hub platform, ensure you have the following prerequisites in place. This guide will help you streamline your development process and ensure a successful integration.

1. POS Hub Developer Account & Application Setup

To interact with the POS Hub API, you must first register as a developer and create an application within the POS Hub Developer's area.

• Register as a Developer: If you haven't already, sign up for a POS Hub developer account.
• Create Your Application: Once registered, create a new application and select MARKETPLACE as the application type. During this process, you will be issued:
  • Client ID: A public identifier for your application.
  • Client Secret: A private key that must be kept secure.
• Configure Endpoints: Set up the necessary URLs for your application:
  • Redirect URL: The URL where users are sent after authorizing your application. This is crucial for the OAuth2 flow.
  • Webhook URL: The endpoint on your server that will receive real-time events from POS Hub (e.g., order status updates from a POS).
  • Menu Publish Endpoint: The endpoint responsible for receiving menu data from POS Hub to be published on your marketplace.
  • Store Status Endpoint: The store status toggle endpoint, called by POS Hub to open/pause the store for a period of time.

2. Third-Party Marketplace Developer Account

Your application will act as a bridge between POS Hub and an external marketplace (e.g., Uber Eats, DoorDash). Therefore, you will need developer access to that marketplace's platform.

• Developer/Sandbox Account: Gain access to a developer or sandbox environment for the third-party marketplace.
• API Credentials: Obtain API keys, tokens, or other credentials required to make authenticated requests to the marketplace's API.
• API Documentation: Have the official API documentation for the marketplace readily available. You will need it to understand their data models for menus, orders, and store management.

3. Understanding Core POS Hub Concepts

Familiarize yourself with the fundamental concepts and patterns of the POS Hub API to ensure a smooth integration.

• Application Anatomy: Understand the structure and types of applications within POS Hub, particularly the MARKETPLACE application type.
• Authentication & Authorization: Understand how to authenticate your application using OAuth2, specifically the Client Credentials Grant for application-level access and the Authorization Code Grant for user-initiated installations.
• Integration Flow: Review the end-to-end flow for marketplace applications, from installation to menu publishing and receiving order updates.
• Webhooks: Grasp the mechanics of how POS Hub dispatches webhook events to your application. For marketplaces, this is crucial for receiving order status updates (e.g., ACCEPTED, CANCELLED) from the POS.
• API Response Structures: Understand the consistent JSON structure for API requests and responses.
• Error Handling: Learn how to interpret and handle various HTTP status codes and error responses from the API.