eBay

This guide covers what ParcelPilot needs to connect to eBay, where to find it in eBay’s developer tooling, and where to enter it in ParcelPilot.

What ParcelPilot needs

1. Environment: Production or Sandbox
2. Client ID (App ID)
3. Client Secret (Cert ID)
4. Refresh Token (OAuth user token refresh token)
5. Optional:
   • Site / marketplace (e.g. EBAY_GB)
   • Dev ID (only if your app uses a separate Dev ID)

Where to find it in eBay

Create or open your application

1. Go to the eBay Developer portal.
2. Open your application (or create a new one).
3. Locate your application keys.

Get Client ID / Client Secret

In the application keys section, copy:

• Client ID
• Client Secret

(Depending on the eBay UI, these may be shown as App ID / Cert ID.)

Generate a Refresh Token

ParcelPilot uses OAuth for API access. You’ll need a refresh token for a user account with access to the eBay store.

High-level steps:

1. Create/choose an OAuth application in the eBay developer tooling.
2. Complete the OAuth consent flow for the required scopes.
3. Capture the resulting refresh token.

Notes:

• Use Production credentials/tokens for real stores.
• Use Sandbox only when testing against eBay’s sandbox environment.

Where to enter it in ParcelPilot

ParcelPilot Admin → Integrations → Client Integrations → create/edit an integration with Platform = eBay.

Fill these fields:

• Environment → credentials.ebay.environment
• Site / marketplace (optional) → credentials.ebay.site_id
• Client ID → credentials.ebay.client_id
• Client Secret → credentials.ebay.client_secret
• Dev ID (optional) → credentials.ebay.dev_id
• Refresh Token → credentials.ebay.refresh_token

Operational settings:

• Enable stock sync / Stock master (if inventory sync is required) → E-commerce settings
• Push shipment confirmations (tracking) to channel (if tracking push is required) → E-commerce settings

Troubleshooting

401 / 403 errors

• Confirm you used the correct environment (Production vs Sandbox).
• Regenerate the refresh token with the required scopes.
• Confirm the token was generated for the correct eBay user/account.

Token stored but actions fail

• Check whether the refresh token has expired or been revoked.
• Re-authorize and generate a new refresh token.

Missing orders?

If orders are missing in ParcelPilot, you can manually backfill using Pull Orders on the integration:

• Pull Orders from eCommerce (manual backfill)

Security notes

• Treat Client Secret and Refresh Token as sensitive credentials.
• Rotate tokens if they’re exposed.