Overview

A sales channel app is a specialized app for integrating sales channels (such as Amazon, eBay, and custom-built apps) into the SHOPLINE Admin, enabling unified management of orders, products, and fulfillment workflows.

Capabilities​

Sales channel apps target selling scenarios outside the online store. With a sales channel app, you can achieve the following capabilities:

• Integrate touchpoints in multiple channels: Connect external platforms (such as Amazon, eBay, Shopee, and Facebook Marketplace) or merchants' custom-built touchpoints (such as mobile apps) to SHOPLINE.

• Centralize order fulfillment: Display orders from all sales channels in the SHOPLINE Admin and fulfill them consistently.

• Synchronize product listings: Manage product listings published to sales channels in the SHOPLINE Admin.

• Authorize account integration: Authenticate and link sales channel accounts via OAuth 2.0 to enable cross-platform data sharing.

Sales channel categories​

Sales channel apps generally support integrating the following categories of sales channels:

Typical integration flow​

The overall integration and business flow for a sales channel app from installation to order generation is as follows:

graph LR
    A[Merchant installs app] --> B[Merchant authorizes app]
    B --> C[App prompts merchant to link sales channel account]
    C --> D{Additional requirements needed?}
    D -->|Yes| E[App meets additional sales channel requirements]
    subgraph COL[" "]
        direction TB
        F[Sales channel is ready] --> G[Merchant publishes product listings to sales channel]
        G --> H[App creates orders and merchant fulfills orders]
    end
    D -->|No| F
    classDef node fill:#1C212D,stroke:#111111,stroke-width:1px,color:#FFFFFF
    class A,B,C,D,E,F,G,H node
    style COL fill:none,stroke:none
    linkStyle default stroke:#111111,stroke-width:1.5px

1. App installation and authorization: The merchant installs the app in the SHOPLINE App Store and completes OAuth 2.0 authorization. For more details, refer to App authorization.

2. Channel account connection: The app guides the merchant to link their sales channel account (such as a Shopee account). If the merchant is not registered with the sales channel, the app directs them to complete registration on the sales channel page.

3. Review and configuration: If the target platform requires a qualification review, the app should prompt the merchant to provide additional information or wait for the review result.

4. Product publishing and data sync: The merchant publishes products to the sales channel. The app retrieves the product list and keeps data in sync by listening to the Product added to sales channels webhook.

5. Order sync and fulfillment: After an order is generated on the sales channel, the app calls the Create an order API to write order data to the SHOPLINE Admin, where the merchant fulfills the order.

Checkout creation and management​

Sales channel apps can create checkout objects and obtain checkout URLs using one of the following two methods:

Permanent cart link​

The basic link format is as follows:

https://{handle}.myshopline.com/cart/{sku_id}:{quantity},{sku_id}:{quantity}

In addition to product information, you can append optional query parameters (such as checkout[email] and discount={discount_code}) at the end of the URL using ? to hold customer information or discount information. For complete fields and examples of permanent cart links, refer to Permanent cart links.

Storefront API​

With this method, the app calls the checkoutCreate mutation endpoint to create a checkout object and retrieves checkoutUrl from the response. Before calling this API, the app must have obtained the unauthenticated_write_checkouts_info access scope. The app can also retrieve checkoutUrl of an existing cart via the cart object.

App requirements​

Sales channel apps must satisfy both general app specifications and sales channel requirements listed below: