Installation and setup

Requirements

• CS-Cart and Multi-Vendor 4.17.2 or later.
• Administrator access to the store’s admin panel.
• An Amazon seller account on the Professional selling plan (individual accounts cannot register private apps) and its primary user login. Amazon requires the primary user to register as a developer and to authorize an app.
• A cron job on your server (see step 8).

Install the add-on

1. Download the kv_amazon_sp-<version>.zip package from your Kavio Labs or CS-Cart Marketplace account.
2. In the admin panel, open Add-ons > Manage add-ons.
3. Click the gear button and choose Manual installation, then upload the archive.
4. Find Amazon Seller Connector (SP-API) in the list and make sure its status is Active.
5. Enter your license key under Settings > License (Kavio Labs downloads) and click Check now.

Create your own (private) Amazon app

The connector uses the Selling Partner API as a private developer: you register as a developer for your own seller account, create an app and authorize it yourself. Amazon documents this path for private applications (“Self-authorization”: the app is not published and you authorize it for your own account while it is in draft status). It costs nothing and does not involve Kavio Labs. The form and the review of your developer profile are Amazon’s and can take some time.

1. Sign in to Seller Central as the primary user and open Apps and Services > Develop Apps. Register as a developer for your own account (private developer): describe your use (own store integration), answer the data security questions and choose the roles. Roles to choose: Product Listing, Inventory and Order Tracking and, for the buyer name and delivery address of your orders, the role that allows personal data for merchant fulfilled orders (Direct-to-Consumer Delivery). See Amazon’s “Registering as a developer” and “Selling Partner API Roles” pages.
2. On the Develop Apps page choose Add new app client, give it a name, choose the SP-API type and select the roles from step 1. Save it.
3. Open the app’s LWA credentials (client identifier and client secret) and copy both. The client identifier starts with amzn1.application-oa2-client..
4. In the app list choose Authorize app (self-authorization). Amazon shows a refresh token (it starts with Atzr|). Each click creates a new refresh token and the earlier ones stay valid. Copy it at once and keep it private.
5. Your Seller ID (merchant token) is shown in Seller Central under Account Info > Your Merchant Token.

You do not need an AWS account, an IAM user or request signing: SP-API calls are authorized with the Login with Amazon access token only.

Connect Amazon

1. Open Orders > Amazon (the add-on page) and the Connection tab, or Add-ons > Manage add-ons > Amazon Seller Connector (SP-API) > Settings and click Connection.
2. Choose Test mode, enter the LWA client ID, LWA client secret and Refresh token of your app (you may use the same values for test and live), your Seller ID and the Amazon store (country) you sell on. Test mode calls Amazon’s sandbox, which answers with static sample data; Live mode calls your real account.
3. Save and click Test connection: a green message lists the stores your account sells in.
4. Switch to Live mode, save and test again. In live mode the test also checks that your account sells on the chosen store.
5. Choose the Orders API: v2026-01-01 (recommended) or the deprecated v0 (see Configuration).
6. Open Categories, map your CS-Cart categories to Amazon product types and set the default brand; open Attributes to map the attributes the product type requires; open Rules for prices and stock (see Usage).
7. Choose the order statuses and the payment method for imported orders in the add-on settings.
8. Add the cron job from the settings page (Cron section). Every 5 minutes is enough: Amazon’s order search allows only one request every few minutes per seller, so the connector polls at the add-on’s sync interval.

Multi-Vendor

By default the marketplace owner connects one Amazon account for all vendors (Marketplace owner mode on). Switch it off to let each vendor connect their own Amazon account in the vendor panel (Connection tab); each vendor then creates their own private app.

Update

1. Upload the new package the same way. Your settings, credentials and data are kept.
2. The add-on adds missing tables and settings by itself on the first request after the update.

See CHANGELOG for what changed in each version.

Uninstall

Open Add-ons > Manage add-ons, click the add-on’s gear button and choose Uninstall. This removes the add-on’s settings, language variables and database tables, including the stored credentials. Revoke the app in Seller Central if you no longer use it.