First Connection

Overview

A Connection is an authenticated link between NexusCommerce and one marketplace account. Once connected, NexusCommerce can read and write listings, sync orders, update inventory, and retrieve advertising data.

Each marketplace has its own OAuth or API-key flow. This guide covers all seven supported marketplaces.

Key Concepts

Connection Status — Each connection has one of four statuses:

• active — Credentials are valid and the adapter is syncing normally
• error — Last sync attempt failed; hover over the status badge for the error message
• rate_limited — The marketplace temporarily throttled requests; the adapter backs off automatically
• pending — Connection was created but the first sync has not completed

Sync Interval — How often the adapter polls for updates. Configurable per connection: 15 minutes, 1 hour, 4 hours, or daily. Webhooks (where supported) supplement polling for real-time order updates.

Getting Started

Navigate to Connections in the left sidebar and click Add Connection.

Amazon

Amazon uses the SP-API (Selling Partner API) with OAuth 2.0 via Login with Amazon (LWA).

Required credentials:

• LWA Client ID
• LWA Client Secret
• Refresh Token (obtained via the Seller Central OAuth flow)
• Marketplace ID (e.g., ATVPDKIKX0DER for US, A1F83G8C2ARO7P for UK)

Steps:

1. In Seller Central, go to Apps & Services > Develop Apps
2. Create a new application with SP-API access
3. Note your Client ID and Client Secret
4. Run the OAuth flow to obtain a refresh token
5. In NexusCommerce, paste all four values and click Test Connection

The adapter requests these SP-API scopes: sellingpartnerapi:orders, sellingpartnerapi:catalog, sellingpartnerapi:fulfillment, sellingpartnerapi:reports.

Bol.com

Bol.com uses OAuth 2.0 client credentials.

Required credentials:

• Client ID
• Client Secret

Obtain these from the Bol.com Seller Portal under API settings. The adapter targets the Bol.com Retailer API v10.

eBay

eBay uses OAuth 2.0 with a user consent flow.

Required credentials:

• App ID (Client ID)
• Dev ID
• Cert ID (Client Secret)
• User Token (OAuth user access token)

In NexusCommerce, click Connect via eBay to open the eBay consent page. After approval, the tokens are stored automatically.

Walmart

Walmart Marketplace API uses HTTP signatures.

Required credentials:

• Consumer ID
• Private Key (PEM format)
• Channel Type (seller or solution provider)

Obtain these from the Walmart Seller Center under Developer > API Management. Paste the PEM private key directly into the credential field.

Shopify

Shopify uses custom apps with scoped access tokens.

Required credentials:

• Shop domain (e.g., your-store.myshopify.com)
• Admin API Access Token

In your Shopify admin, go to Settings > Apps and sales channels > Develop apps. Create a custom app and configure these scopes: read_products, write_products, read_orders, write_orders, read_inventory, write_inventory.

Zalando

Zalando Partner API uses OAuth 2.0 client credentials.

Required credentials:

• Client ID
• Client Secret
• Partner ID

Access is granted by Zalando upon partner approval. Contact your Zalando partner manager for API credentials.

Kaufland

Kaufland uses API key authentication.

Required credentials:

• Client Key
• Secret Key
• Storefront (e.g., de, at, cz, sk)

Obtain keys from the Kaufland Seller Portal under Settings > API Access.

Features

Testing a Connection

Every connection form includes a Test Connection button. This makes a lightweight API call (typically a catalog or order list with limit=1) to verify credentials before saving.

A successful test shows:

Connection valid — marketplace: Amazon US
Seller name: Your Store Name

Manual Sync

After creating a connection, click Sync Now on the connection card to trigger an immediate full sync. The UI shows a progress indicator with the count of products, orders, and inventory records imported.

Webhook Registration

For marketplaces that support webhooks (Shopify, eBay), NexusCommerce automatically registers webhook endpoints during connection setup. The webhook URL format is:

https://your-nexuscommerce-domain.com/api/webhooks/<marketplace>/<connection-id>

Re-authentication

When a token expires, the connection status changes to error with the message Token expired. Click Reconnect on the connection card to re-run the OAuth flow without losing existing sync history.

Configuration