ASA2 Documentation

Appearance

Multi-Marketplace Configuration ​

The Creators API in ASA2 supports a multi-marketplace architecture. This allows you to configure separate API credentials for each Amazon marketplace (country store).

Why Separate Credentials? ​

Unlike PA API 5.0 where a single set of credentials can access all marketplaces, the Creators API requires you to create credentials for each marketplace separately in Amazon Associates Central.

This approach provides:

  • Better account management: Each marketplace has its own tracking ID
  • Flexible control: Enable or disable specific marketplaces as needed
  • Gradual migration: Move from PA API to Creators API one marketplace at a time

Managing Multiple Marketplaces ​

Configured Marketplaces table

The Configured Marketplaces table shows all your configured marketplaces at a glance:

Marketplace The country name (e.g., Germany, USA, United Kingdom).

Status Shows Enabled (green) or Disabled (gray). Disabled marketplaces won't use Creators API for product lookups.

Credential Type Indicates whether the marketplace uses Cognito (v2) or LWA (v3) credentials.

API Version The Creators API version being used (e.g., 2.2, 3.1). This is automatically determined based on the credential type and marketplace region.

Partner Tag Your Amazon Associates Tracking ID for this marketplace. Partially hidden for security.

Default A star icon indicates the default marketplace. This marketplace is used when no specific country is selected.

Actions

  • Edit: Modify the credentials or settings
  • Delete: Remove the marketplace configuration

Adding a Marketplace ​

  1. Click the "+ Add Marketplace" button
  2. Select the marketplace from the dropdown
  3. Select the Credential Type — choose "Cognito (v2)" for existing credentials or "LWA (v3)" for credentials issued since February 2026
  4. Enter your Credential ID and Credential Secret
  5. Enter your Partner Tag (Tracking ID) for this marketplace
  6. Check "Enable Marketplace" to activate it
  7. Optionally check "Set as Default Marketplace"
  8. Click "Add Marketplace"

Add Marketplace form

Setting a Default Marketplace ​

The default marketplace is used when:

  • No specific country code is provided in a shortcode
  • A product's country cannot be determined
  • You're using features that don't specify a marketplace

To set a default marketplace:

  1. Click "Edit" on the desired marketplace
  2. Check "Set as Default Marketplace"
  3. Save the changes

Only one marketplace can be the default. Setting a new default automatically removes the default status from the previous one.

Enabling and Disabling Marketplaces ​

You can temporarily disable a marketplace without deleting its credentials:

  1. Click "Edit" on the marketplace
  2. Uncheck "Enable Marketplace"
  3. Save the changes

When a marketplace is disabled:

  • ASA2 will use PA API 5.0 for products from that marketplace
  • The credentials remain stored and can be re-enabled later
  • Other marketplaces continue to use Creators API

This is useful for:

  • Troubleshooting issues with a specific marketplace
  • Temporarily switching back to PA API
  • Testing before fully enabling Creators API

API Routing Logic ​

When you request product data, ASA2 automatically determines which API to use based on this logic:

  1. Check the product's marketplace (country code)
  2. Look for Creators API credentials for that marketplace
  3. If credentials exist and are enabled: Use Creators API
  4. Otherwise: Fall back to PA API 5.0

This means you can have a mixed setup where some marketplaces use Creators API while others use PA API.

Example configuration:

MarketplaceCredential TypeCreators APIAPI Used
GermanyCognito (v2)EnabledCreators API 2.2
United StatesLWA (v3)EnabledCreators API 3.1
United Kingdom—DisabledPA API 5.0
France—Not configuredPA API 5.0

ASA2 - The Amazon Affiliate Plugin for WordPress

© 2026 getasa2.com