Skip to main content
📊 See what this connector supports ↓

​
Introduction

eBay is a global online marketplace where sellers are paid through eBay’s managed payments. The connector reads the seller’s financial data from eBay’s Sell Finances API.

​
Activate eBay

​
Partner keys

You’ll need your own OAuth2 app, registered with eBay. No approval is needed: an eBay developer account and an application are enough. Sandbox and Production each have their own keys, RuName and signing key, so repeat the steps for each environment you use.
1

Create an eBay developer account

Sign up on the eBay Developers Program, then create an application under Application Keys. eBay gives it a Sandbox and a Production keyset.
2

Enable the Production keyset

eBay keeps the Production keyset disabled until you comply with its Marketplace Account Deletion notifications: subscribe an endpoint, or apply for the exemption.
3

Copy the App ID and Cert ID

On Application Keys, copy the keyset’s App ID (Client ID) and Cert ID (Client Secret).
4

Create a RuName

Next to the App ID, open User Tokens, then Get a Token from eBay via Your Application, and add a redirect URL. Set its Auth Accepted URL to the URL below. eBay generates a RuName, a name such as Your_Company-YourApp-PRD-…: copy it.
5

Create a signing key

eBay requires a digital signature on every Finances API call made for a seller domiciled in the EU or the UK. Chift signs every call, so the key is needed whatever your sellers’ country. Create the key with eBay’s Key Management API, cipher ED25519, using an application token of the same keyset.The response holds a privateKey and a jwe. eBay does not store the private key and returns it once: copy both values before closing the response. If it is lost, create a new signing key.A signing key expires 3 years after its creation. Before then, create a new one and replace both values in the connector settings.See eBay’s digital signatures guide.

Activate eBay in your Chift account

In Connectors, set Environment, then enter the matching App ID (Client ID), Cert ID (Client Secret), RuName, Digital signature private key and Digital signature key (JWE).

​
Connector settings

The Environment setting in the Chift eBay connector settings, with its options Production and Sandbox
Environment selects which eBay environment the connections of this connector talk to.
  • Production (default): the seller’s live eBay account.
  • Sandbox: eBay’s test environment.
Use Sandbox while you test the integration, then switch back to Production before your end users connect. The keys, RuName and signing key belong to one environment: enter the ones of the keyset that matches.

​
Test eBay

​
Vendor fees

No vendor fees, for you or your end users.

​
Connect eBay

eBay setup guide for end users

The full step-by-step, with screenshots.
Before they start, your end users need:
  • an eBay seller account that receives payouts through eBay’s managed payments
  • to sign in with the eBay account that receives the payouts: eBay does not give team members access to financial data
To connect, they:
  • select the eBay marketplace they sell on
  • sign in to eBay and agree to share their financial data

​
Rate limits

eBay applies a daily call limit per application: 15,000 calls per day for the Finances API, shared by all the connections of your app. eBay can raise it after an Application Growth Check. When the limit is exceeded, eBay returns HTTP 429 Too Many Requests. Chift automatically manages these limits to optimize performance and prevent interruptions. However, once the API rate limit is reached, Chift cannot bypass these limitations. eBay returns up to 1,000 transactions or 200 payouts per call, and Chift reads every page of a list. A large date range on a busy seller costs several calls. See eBay’s API call limits.

​
Limitations & specificities

  • Without dates, eBay returns the last 5 years.
  • eBay keeps 5 years of history: an older start date is moved to 5 years ago.
  • A date range wider than 36 months is refused. Split it into smaller ranges.
  • eBay reports a sale net of its fees. Chift adds the fees back, so the amount minus the fee is what the seller receives.
  • Fees eBay reports in another currency are converted with the transaction’s exchange rate.
  • Transactions that moved no money (failed at eBay) are not returned.
  • Every payout is also returned as a transaction with the payout accounting category. A payout eBay finally gives up on is returned a second time, with the payout_cancel category, on the date of its last attempt.
  • eBay’s withdrawal transactions are not returned: the payout transactions already cover them.
  • The starting_from filter is not supported and is refused.
  • The invoice accounting category has no equivalent at eBay and returns an empty list.
  • A payment is an eBay order: the order’s sales are grouped into one payment, identified by the order number.
  • A payment is pending until eBay pays it out, then completed. It is partially completed when only part of the order is paid out.
  • Each refund is one eBay refund transaction, linked to its order.
  • Status: in transit while eBay sends or retries it, paid once it succeeds, failed once eBay gives up.
  • The fee is eBay’s express payout fee, when there is one.
  • One balance, in the seller’s payout currency: the funds available for payout.
  • Locations do not exist at eBay: the location_id filter is refused on every endpoint.

​
Coverage