Skip to content

Settings

Open Add-ons > Manage add-ons > eBay Marketplace Connector > Settings.

Setting Default Description
Enable On When off, no new work is started. Jobs of work that is already under way are still processed.
Marketplace owner mode On On: every order is processed with the marketplace owner’s account and vendors have no connection page. Off: each vendor connects their own account.
Debug log Off Also stores every HTTP call with masked request and response. Secrets are never stored.
Log retention (days) 90 Older log entries are removed by the cron run.
Sync interval (minutes) 15 How often stock and price are pushed, orders imported and shipments reported.
Status of imported orders O
Payment method ID for imported orders empty Empty = the first active payment method.

Credentials are not ordinary settings: they are entered on the Connection page and stored encrypted (AES-256-GCM, key derived from your store’s own secret). They are never shown again; leave a secret field empty to keep the saved value.

Field Description
Mode Test uses the Sandbox keyset (api.sandbox.ebay.com); Live uses the Production keyset (api.ebay.com).
Client ID / Client secret The App ID and Cert ID of your keyset at developer.ebay.com (one pair for Sandbox, one for Production).
RuName (sandbox / production) The redirect URL name of the keyset (developer account > User Tokens). It is sent to eBay as the redirect address of the consent and of the code exchange; its auth accepted URL is the address shown on the Connection page.
Marketplace eBay site the listings are published on: EBAY_US, EBAY_GB, EBAY_DE, EBAY_FR, EBAY_IT, EBAY_ES, EBAY_AU, EBAY_CA, EBAY_NL, EBAY_IE, EBAY_AT, EBAY_CH, EBAY_PL. It sets the currency and the language of the listing.
Fulfillment / payment / return policy ID IDs of your eBay business policies for the marketplace (Show my policies lists them). Every offer references them.
Inventory location key The merchant location key of a warehouse in your eBay account. Create location creates one from the address fields.
New offers Publish at once, or keep unpublished (you publish in Seller Hub).

The authorization itself (access and refresh token) is stored encrypted next to the keyset and is removed when the keyset changes or on Disconnect.

The queue runs from cron. Use either the command line or the secret web address shown in the Cron section of the settings:

  • php /path/to/store/admin.php --dispatch=kv_ebay.cron
  • https://your-store.example/index.php?dispatch=kv_ebay.cron&key=<secret>
  • Log lists every call, job and webhook with filters (level, action, text, dates) and a CSV export.
  • Jobs lists the queue. A job that fails is retried after 5 minutes, 15 minutes, 1 hour, 3 hours and 12 hours, then marked “Gave up”; use Retry to queue it again.

In the vendor panel a vendor sees only their own records. With the marketplace owner mode off the vendor also gets the Connection tab for their own account.