eBay Integration: Trading API, Promoted Listings & Unified Store Management

About eBay: Founding, Corporate Structure and Market Position

Founding and history (1995 – today)

eBay was founded on September 3, 1995 in San Jose, California by French-Iranian-American software developer Pierre Omidyar under the name AuctionWeb. The auction model — the highest bidder wins — revolutionized C2C online commerce. In 1998 eBay went public on the NASDAQ and expanded internationally from 1999 onwards. In June 1999, eBay acquired the Berlin-based auction platform Alando.de for around €43 million, thereby establishing eBay Germany.

Over the following decades, eBay evolved from a pure auction house into a hybrid marketplace with fixed-price listings (Buy It Now), multi-variation listings and a strong B2C share. The historical PayPal subsidiary was spun off in 2015; since 2018, eBay has processed payments through the Dutch payment provider Adyen (Managed Payments). In 2024, global gross merchandise value reached around 75 billion US dollars with 132 million active buyers worldwide.

Corporate structure and German location

• eBay Inc. — Parent company, publicly listed (NASDAQ: EBAY), headquartered in San Jose, California
• eBay GmbH — German subsidiary, based in Kleinmachnow near Berlin
• Pierre Omidyar — Founder, still a shareholder and active on the board of directors
• Adyen N.V. — Strategic payments partner since 2018 (Managed Payments)
• Kleinanzeigen — Spun off in June 2021 and sold to Adevinta (today an independent brand)

Market position in Germany

eBay consistently ranks second in German e-commerce after Amazon and is at the same time the oldest established online marketplace in the country. According to the German E-Commerce and Distance Selling Trade Association (bevh) and Statista, eBay.de holds a market share of around 10–12% of total online commerce. eBay is particularly strong in the categories auto and motorcycle parts, tools, industrial supplies, refurbished electronics, collectibles and fashion — areas where the combination of auctions, fixed prices and multi-variation listings provides a competitive advantage.

eBay Sales Figures and Reach (2024–2025)

eBay Germany generated a Gross Merchandise Value (GMV) of around €8 billion in 2024 with over 17 million active buyers. Even though growth no longer reaches marketplace-hyperscaler levels, eBay remains more profitable than Amazon for many commercial sellers thanks to repeat-buyer loyalty, B2B-friendly traffic and low commissions.

Year	GMV DE (EUR)	Active buyers DE	Active sellers DE	Global GMV
2020	~ €7.1B	17M	175,000	~ US$100B
2022	~ €7.6B	17M	178,000	~ US$74B
2024	~ €8.0B	17.2M	180,000+	~ US$75B
2025 (forecast)	~ €8.4B	17.5M	185,000	~ US$78B

The main growth drivers are the eBay Plus membership (premium buyer program with free shipping and 30-day returns), the expansion of Promoted Listings Standard and Advanced, and open buyer outreach with no marketplace restrictions for refurbished electronics and industrial supplies. Entering as a commercial seller on eBay Germany remains one of the most affordable ways to scale into German online commerce in 2026.

Opening a Seller Account on eBay Germany (2026 Requirements)

1. Legal and tax prerequisites

For commercial selling on eBay.de you need a registered business (sole proprietorship, GbR, UG, GmbH or freelancer), a valid VAT identification number and a complete imprint under § 5 TMG (German Telemedia Act). In addition, the requirements of GDPR, the Packaging Act (LUCID) and the Money Laundering Act (GwG) apply.

• Business registration with the local trade office
• Tax number and VAT ID from the tax office
• Commercial register extract (for UG, GmbH, AG)
• SEPA bank account (IBAN) — eBay pays out via Adyen Managed Payments directly to the business account
• LUCID registration with the Central Packaging Register Foundation (Packaging Act)
• WEEE number (Electrical Equipment Act, for electronics), Battery Act registration
• Brand or manufacturer authorization for trademark-protected products
• Terms and conditions, withdrawal policy, privacy policy — mandatory for commercial sellers

2. Registration on the eBay Seller Portal

Registration takes place at verkaufen.ebay.de. After identity verification (Adyen KYC), bank verification and activation, you receive access to the Seller Hub. For API integration, a developer account is additionally required at developer.ebay.com — there you create an app and receive App ID, Dev ID, Cert ID as well as the OAuth 2.0 User Token.

📥 Official eBay Seller Application verkaufen.ebay.de — free application, 1–3 business days approval →

3. Creating listings and listing quality

eBay scores every listing on an internal quality score that determines visibility in the Best Match algorithm:

• Title: up to 80 characters, with brand, product, model number and relevant keywords
• Images: at least 500 × 500 pixels (1600 px recommended), white background, up to 24 images, no watermark
• Item specifics: manufacturer, MPN, EAN/GTIN, color, size — mandatory fields per category
• Category: correct category ID and, where applicable, store category
• Shipping profile: shipping costs, delivery time, return conditions (14 days statutory, 30 days for eBay Plus status)
• Description: HTML description with a clear structure, no active scripts

eBay Final Value Fees and Charges (2026)

The eBay final value fee for commercial sellers in 2026 ranges between 5% and 14% of the total amount (item price + shipping), depending on the category. The first 250 listings per month are usually free of insertion fees; beyond that, €0.35 applies per additional listing. Additionally, 19% VAT applies on the fees (input-tax deductible). Calculating a gross-to-net margin without taking these fees into account is the most common mistake new merchants make.

Net margin in detail: Sale price − final value fee − optional Promoted Listings fee − payment processing share (already included in the final value fee) − shipping cost − packaging − cost of goods − 19% VAT = net profit. The Zunapro pricing module calculates this formula per item and category automatically and warns as soon as your minimum contribution margin is undercut.

eBay API Integration — Trading API and REST Sell APIs

The eBay API family allows sellers to programmatically synchronize listings, inventory, orders, prices, shipping and returns. eBay operates two API generations in parallel: the classic Trading API (XML/SOAP, since 2001) and the modern REST Sell APIs (JSON, OAuth 2.0). Both run on the base URL https://api.ebay.com/ and share the same authentication system.

OAuth 2.0 authentication

All eBay APIs use OAuth 2.0. You provide the App ID, Cert ID and Dev ID from your developer account and generate a User Token via the authorization-code flow. Tokens are valid for 2 hours (user token) or 18 months (refresh token). Zunapro handles token refresh, rotation and secure storage of the secrets on your behalf.

Key API areas

• Trading API (XML) — auctions, multi-variation listings, legacy categories (AddFixedPriceItem, ReviseItem, GetOrders)
• Inventory API (REST) — inventory, prices, SKU-based maintenance, locations (/sell/inventory/v1/)
• Fulfillment API (REST) — orders, shipping, tracking numbers (/sell/fulfillment/v1/)
• Marketing API (REST) — Promoted Listings, coupons, sales (/sell/marketing/v1/)
• Account API (REST) — shipping, return and payment profiles (/sell/account/v1/)
• Notification API — webhook-based real-time updates for orders, returns, inventory reconciliation
• Finances API (REST) — payouts, fee statements, Adyen statements

Rate limits and error handling

The standard rate limit is 5,000 API calls per day at the app level; individual endpoints (e.g. Inventory) have higher quotas after successful production approval. On exceeding the limit, the API responds with HTTP 429 Too Many Requests. Common errors: 400 (invalid item data), 401 (expired token), 403 (missing scope), 500 (eBay system error, retry recommended). Zunapro implements exponential-backoff retries, dead-letter queues and centralized monitoring with Slack/email alerting.

Bulk Import — CSV, XML and Data Feeds for eBay

In addition to the API, eBay supports structured data feeds for bulk imports. The Zunapro feed bridge reads XML or CSV catalogs from your wholesalers (e.g. ElectronicPartner, ZG-Mobile, EK Servicegroup, Würth, Conrad B2B) and transfers them to the eBay catalog via the Inventory API. This way, thousands of items can be updated per minute.

Required feed fields

• sku — unique stock-keeping unit, groups variants
• title, brand, mpn, ean / gtin
• categoryId (eBay category), aspects (color, size, material)
• availability.shipToLocationAvailability.quantity, price.value, price.currency (EUR)
• fulfillmentPolicyId, paymentPolicyId, returnPolicyId
• imageUrls[] (up to 24), description (HTML)

Automating wholesaler feeds to eBay

Most German wholesalers deliver product catalogs via BMEcat, CSV or their own XML schema. The Zunapro feed module:

1. Reads the wholesaler's feed URL (hourly/daily cron interval)
2. Learns category mapping (first mapping is manual, after that automatic)
3. Normalizes attributes such as brand, material, size and EAN
4. Calculates sale price from purchase price + margin + final value fee + VAT
5. Synchronizes inventory — sold-out items are deactivated automatically
6. Publishes listings via the Inventory API

Shipping Integration — DHL, Hermes, DPD and Other Carriers

Unlike Amazon and Trendyol, eBay does not operate its own fulfillment solution in Germany — the eBay Fulfillment EU program was discontinued for German sellers in mid-2023. Instead, shipping is done exclusively from your own warehouse or through 3PL providers (e.g. byrd, Bytrans, Salesupply, Logsta). Zunapro natively integrates the following carriers into the eBay shipping workflow:

• DHL Paket — standard, express, Warenpost, international shipments
• Hermes — affordable consumer parcels, ParcelShop shipping
• DPD — business shipments, Predict delivery
• GLS — B2B shipping, express
• UPS — international, express
• Deutsche Post Warenpost — envelope shipments up to 1 kg

The Zunapro multi-carrier module selects the optimal carrier based on weight, dimensions, destination region and customer preference, prints the label, stores the tracking number in the eBay order record and automatically sends the tracking information to the buyer.

Seller Performance and Defect Rate on eBay

eBay evaluates every seller monthly via the seller level (Top Rated Seller, Above Standard, Below Standard) as well as the defect rate. Anyone falling below the minimum requirements is downgraded in the Best Match ranking or loses privileges.

• Defect rate — share of transactions with a buyer complaint, eBay Buyer Protection case or late shipment (max. 2%)
• Late shipment rate — max. 3% of orders delivered later than promised
• Seller-initiated cancellations — max. 0.3% due to out-of-stock
• Cases without seller resolution — max. 0.3%
• Response time to buyer messages — within 24 hours recommended

Automatic inventory synchronization in Zunapro reduces seller-initiated cancellations by over 90%. As soon as an item is sold in your store, in the warehouse or on another marketplace, the eBay inventory is adjusted immediately — overselling becomes structurally impossible.

Promoted Listings, eBay Plus and Smart Pricing

eBay advertising platforms

• Promoted Listings Standard — percentage uplift (Ad Rate) on the sale price, fee only on an actual sale
• Promoted Listings Advanced — cost-per-click campaigns with keyword targeting and ROAS control
• Promoted Stores — display advertising in eBay search results for store categories
• Promoted Offer Sponsored Brands — brand campaigns in premium inventory

eBay Plus — the premium seller status

eBay Plus is the premium program for commercial sellers with a high service level. Plus-eligible items are marked with a blue-and-yellow badge, receive a higher Best Match ranking and are preferentially served to buyers of the paid eBay Plus membership. Requirements: free shipping, 30-day return policy, same-day or next-business-day dispatch and Top Rated status.

Smart Pricing (Repricer)

On eBay, 10 or more sellers often compete for the same product — especially in branded electronics, tools and auto parts. The Zunapro repricer module monitors the lowest competitor price every second and automatically adjusts your price within a defined min/max range, so you stay visible without dropping below your minimum margin.

XRechnung, GoBD and GDPR — the German Compliance Obligation

Since January 1, 2025, electronic invoicing in the B2B segment has been legally mandatory (Growth Opportunities Act). The German standard is XRechnung (UBL/CII XML) or ZUGFeRD 2.x (PDF/A-3 with embedded XML). Manual invoicing is not practical at eBay volumes.

The Zunapro XRechnung module:

• Automatic generation of an XRechnung-compliant invoice per eBay order
• VAT breakdown differentiated by 19% (standard rate) and 7% (books, food)
• Delivery as PDF/A-3 with embedded XML by email to the buyer
• GoBD-compliant archiving over 10 years with audit-proof retention
• OSS reporting for EU sales (One-Stop-Shop)
• Automatic credit notes for returns
• Interfaces to DATEV, Lexware, sevDesk and Buchhaltungsbutler

Returns and Customer Service Management

The statutory right of withdrawal in Germany is 14 days; sellers with eBay Plus status must offer a 30-day return window. Return rates vary by category: fashion 25–35%, electronics 5–8%, home and garden 8–12%.

Standard returns flow on eBay:

1. Buyer opens a return request in the eBay buyer portal within 14 (or 30) days
2. Seller accepts the request and provides a return label (mandatory in case of a defect, optional for withdrawal)
3. Buyer ships the item back; tracking appears in the eBay dashboard
4. Seller inspects the return and accepts or rejects it
5. Adyen automatically refunds the purchase price to the original payment method

The Zunapro returns module tracks every step automatically, generates the credit note in line with the XRechnung standard and — on request — instantly relists the returned item or moves it to the refurbished listing.

eBay Integration with Zunapro — Setup in 4 Steps (10 Minutes)

1. Enter eBay seller and developer credentials — In the Zunapro Panel under Marketplace → eBay, enter Seller ID, App ID, Dev ID and Cert ID. The OAuth 2.0 flow starts automatically.
2. Connect your existing store system — Preconfigured connectors for Shopify, WooCommerce, Shopware 6, JTL-Wawi, OXID, PrestaShop and Magento. API URL and access key are all you need.
3. Category mapping assistant — By drag-and-drop, you map your store categories to eBay categories. AI-powered suggestions complete the mapping in minutes.
4. First synchronization — Listings, inventory, prices, orders, shipping — all sync automatically. After 10 minutes, your eBay store is fully manageable from the Zunapro Panel.

Frequently Asked Questions on the eBay Integration (FAQ)