Connecting an eBay Site

Each eBay marketplace is its own site in Spark Shipping. You choose the marketplace when you create the site, so if you sell on more than one (for example eBay US and eBay Motors), add one site for each.

Before you start

Spark Shipping manages eBay listings that use these settings. The same list is on the site's Credentials page:

• Listing Type: Fixed Price
• Listing Duration: GTC (Good 'Til Cancelled)
• Out of Stock Control: Enabled. This lets a listing stay live at 0 quantity instead of ending. If it's off, see eBay Error: The quantity must be a valid number greater than 0 for how to turn it on.

1. Create the site

1. Go to Sites and click New Site.
2. Click eBay and pick your marketplace: eBay US, eBay Motors, eBay Canada, eBay Canada (French), eBay UK or eBay Australia.

Spark Shipping creates the site and opens its Credentials page.

2. Get your eBay refresh token

1. On the Credentials page, click Get eBay Refresh Token. eBay opens in a new tab.
2. Sign in with the eBay account you sell from and allow Spark Shipping access.
3. eBay sends you back to the Sites page in Spark Shipping. The message at the top reads "Successfully received eBay token. Copy/paste following token to site settings:" followed by a long token.
4. Copy the whole token.

3. Paste the token and test

1. Open your eBay site again and click Credentials in the left menu.
2. Paste the token into eBay Refresh Token.
3. Click Test Connection.

The Connection Results panel shows two checks:

• Connection: Spark Shipping got an access token from eBay.
• UserSettings: whether Out of Stock Control is turned on in your eBay account.

The site only counts as connected when both checks pass. If UserSettings says "Out of Stock Control Preference is disabled", turn it on in eBay and click Test Connection again.

The test also does two things for you:

• If the site still has the default name "eBay" and your account has an eBay Store, the site is renamed to your store's name.
• Your eBay business policies (shipping, return and payment) are loaded so you can choose them as defaults.

4. Set your listing defaults

Before you push products to eBay, open Default Product Options and fill in your item location, shipping, returns and other listing defaults. Your eBay settings in Spark Shipping explains those fields.

Order options, such as Order Processing Delay and Add Prefix to Order IDs upon creation, are on Custom Settings.

When you need a new token

eBay asks you to regenerate the refresh token:

1. After 18 months.
2. After a change to your account details (password, business name, address and so on).
3. When eBay revokes a token for security reasons.

Also get a new token after you turn on Use the eBay Finances API on Custom Settings, so eBay grants the extra permission.

To regenerate, repeat steps 2 and 3: click Get eBay Refresh Token, paste the new token over the old one and click Test Connection. If you see "eBay Refresh token not valid" in a job log, this is the fix. See Error: eBay Refresh token not valid.