Ricardo Integration: API, Ricardo Shops & C2C+B2C Trade

About Ricardo: History, Ownership and Market Position

History (1999 – Today)

Ricardo was founded in 1999 in Zürich as Switzerland's first online auction house, modeled after eBay but localized for the Swiss market in German, French and Italian. While eBay dominated globally, Ricardo's local language coverage, CHF pricing, Die Post shipping integration and Swiss buyer protection (Käuferschutz) kept it the undisputed Swiss leader — which is why eBay never gained traction in Switzerland.

In 2008, Tamedia AG (now TX Group, SWX:TXGN) acquired Ricardo as part of its digital marketplace strategy, alongside sister platforms tutti.ch (classifieds) and a stake in Scout24 Switzerland (cars/jobs/real estate). Today Ricardo is operated as part of TX Group's "TX Markets" division and combines its legacy auction model with modern Buy Now fixed-price listings, making it both a C2C auction marketplace and a serious B2C channel via Ricardo Shops.

Ricardo Ownership Structure (2026)

• TX Group (SWX:TXGN) — 100% owner via TX Markets division (since 2008)
• Formerly Tamedia AG — Renamed to TX Group in 2020
• Sister platforms — tutti.ch (classifieds), Scout24 Switzerland (cars, real estate, jobs)
• HQ — Zürich, Switzerland
• Stock — Listed on SIX Swiss Exchange (SWX:TXGN)

Position in Swiss E-Commerce

Ricardo is the undisputed #1 auction and general marketplace in Switzerland, with roughly half of all Swiss adults registered as users. While Galaxus/Digitec dominate Swiss new-product retail and Amazon.de captures cross-border buyers, Ricardo owns the unique segments: second-hand, refurbished, vintage, watches, cars and collectibles. Swiss watches in particular — a huge specialty market — are heavily traded on Ricardo, often through Pro Shops with AML compliance.

Ricardo Sales Volume and Scale (2024–2025 Data)

Ricardo has remained Switzerland's top auction+marketplace destination for 25+ years. Listings volume, Pro Shop adoption and Buy Now share have all grown steadily since 2020 as the platform pivoted from pure auctions toward a hybrid C2C+B2C model.

Year	Active Users	Yearly Listings	Pro Shops	Buy Now Share
2020	3.2M	18M	2,800	~45%
2022	3.6M	21M	3,800	~58%
2024	4M+	25M+	5,000+	~68%
2025 (forecast)	4.2M	27M	5,600	~72%

The growth is driven by Pro Shop adoption, the Buy Now format gaining majority share, and the resurgence of refurbished electronics and vintage collectibles. Onboarding to Ricardo as a Pro merchant is the fastest route to Switzerland's largest second-hand and specialty online audience.

Opening a Ricardo Shop (2026 Requirements)

1. Legal and Tax Requirements

To operate a Ricardo Shop you must be a registered Swiss business. Einzelfirma (sole proprietor), GmbH or AG all qualify. You must be able to issue QR-Rechnung invoices (mandatory in Switzerland since 2022) and comply with nFADP (Swiss revised data protection act, EDÖB-supervised).

• Swiss commercial register entry (Handelsregister)
• UID number (Unternehmens-Identifikationsnummer)
• Swiss bank account (IBAN) — payouts route here
• VAT registration — mandatory if turnover exceeds CHF 100,000
• QR-Rechnung capability via ERP or e-invoicing provider
• nFADP-compliant privacy policy
• AML documentation for high-value items (Swiss watches, gold, art)

2. Ricardo Shops Application

You apply via ricardo.ch/en/business-shop. Approval typically takes 3–7 business days. After approval you receive your Shop ID, API key and API secret for the Ricardo Shops REST API — these credentials are critical for integration.

📥 Official Ricardo Shop Application ricardo.ch/uebersicht-shop — free application, 3–7 business days approval →

3. Listing Rules and Content Quality

Ricardo enforces clear listing standards, especially for Pro Shops:

• Title: 60–80 characters, brand + product + key attribute (DE/FR/IT recommended)
• Photos: Minimum 800×800px, white or neutral background, up to 10 photos, no watermarks
• Description: Plain text or limited HTML, condition clearly stated (new, refurbished, used, vintage)
• Category mapping: Ricardo category ID + attributes (brand, model, year, condition)
• EAN/GTIN: Required for new branded products; speeds up catalog matching
• Language: German primary; French and Italian recommended for full Swiss coverage
• Condition disclosure: Mandatory and audited — false claims trigger Käuferschutz disputes

Ricardo Commission Rates (2026)

Ricardo 2026 commission rates vary by listing type and category, ranging from roughly 5% to 17%. Auctions and small Buy Now items sit at the low end, while Pro Shop direct sales in Fashion and Beauty hit the high end. Swiss VAT (8.1% standard, 2.6% reduced, 3.8% accommodation) is added separately. Many sellers price without accounting for the full commission + VAT + shipping stack — the most common margin mistake on Ricardo.

Net margin formula: Sale price − Ricardo commission − Swiss VAT − Pro Shop subscription (amortized) − Die Post shipping − Cost of goods = Net profit. Zunapro's pricing module calculates this automatically per product and category, blocking listings that would fall below your minimum margin threshold.

Ricardo API Integration — Technical Details

The Ricardo Shops API is a RESTful interface that lets approved Pro merchants synchronize product, stock, order, price, shipping and dispute data programmatically. API base URL pattern: https://api.ricardo.ch/shops/v1/{shopId}/

API Authentication

The Ricardo Shops API uses OAuth 2.0 + API key authentication. The apiKey:apiSecret pair is exchanged for a bearer token, which is sent in the Authorization: Bearer header. Tokens are typically valid for 24 hours and auto-refresh on the integrator side.

Main Endpoint Categories

• Listings API — Create, update, end auctions and Buy Now listings; category mapping
• Inventory API — Stock and price synchronization (bulk endpoints up to 100 items/request)
• Orders API — List orders, update status, mark as shipped, generate packing slips
• Shipments API — Die Post / DPD Schweiz / Quickpac label generation, tracking number sync
• Disputes API — Käuferschutz claim handling, evidence upload, refund decisions
• Settlements API — Payout statements, monthly Pro Shop invoices, VAT breakdown
• Webhooks — Real-time callbacks on bid updates, order events and inventory changes

Rate Limits and Error Handling

Ricardo API rate limits are typically 5–10 requests per second per shop, with bulk endpoints recommended for catalog operations. When exceeded, the API returns 429 Too Many Requests. Common error codes: 400 (invalid listing data), 401 (auth failure), 404 (category/listing not found), 409 (auction already ended), 500 (system error — retry). The Zunapro integrator handles exponential backoff, idempotency keys and dead-letter queues automatically.

Auctions vs. Buy Now — Ricardo's Hybrid Model

Ricardo is unique among European marketplaces because it operates two parallel formats: legacy auctions (1–10 day duration) and modern Buy Now fixed-price listings. Pro Shops can use either or both, and the right mix depends on your category.

When to Use Auctions

• Unique or scarce items — vintage Swiss watches, used cars, antiques, collectibles
• Price discovery — when market price is unclear or volatile
• End-of-life inventory — clear surplus stock at market-driven prices
• Auction excitement effect — bidding wars often exceed Buy Now prices

When to Use Buy Now

• Standard catalog products — refurbished electronics, fashion, home goods
• Branded inventory with set MSRP
• High-volume SKUs needing predictable cash flow
• Cross-channel pricing parity with your own webshop

Zunapro auction module handles bid notifications, auto-end-time extensions and conversion of unsold auctions into Buy Now listings — all from the unified marketplace panel.

Ricardo Shops — Pro Merchant Subscription

Ricardo Shops is the B2B/Pro merchant program that gives Swiss businesses a branded storefront, bulk listing tools, the official REST API and access to over 4 million Swiss buyers. There are 5,000+ active Pro shops in Switzerland.

Ricardo Shop Tiers (Approximate)

• Basic Shop — CHF 49/month — up to ~500 active listings, basic API, standard support
• Plus Shop — CHF 99/month — higher listing cap, full API, priority support, branded shop page
• Premium / Enterprise Shop — CHF 149/month — unlimited listings, dedicated account manager, premium placement, advanced analytics

Note: Ricardo Shop subscription is on top of per-sale commissions. Most Pro merchants break even on the subscription within the first 10–20 sales per month thanks to the lower commission band Pro Shops receive vs. C2C sellers.

Ricardo Shop Rating, Käuferschutz and Reputation

Ricardo assigns every seller a 1–5 star rating based on buyer feedback, dispute outcomes and fulfillment quality. This rating directly affects search visibility and Pro Shop standing. Key factors:

• Käuferschutz disputes — buyer protection claims; resolving in buyer's favor hurts your rating
• Shipping speed — slow handoff to Die Post / DPD Schweiz lowers ratings
• Item-as-described — especially critical for used and refurbished goods (condition accuracy)
• Counterfeit risk — KIVE (Swiss anti-counterfeiting framework) violations end your shop immediately
• Response time — answering buyer messages within 24h is expected for Pro Shops
• Cancellation rate — out-of-stock cancellations are heavily penalized

Zunapro real-time stock sync reduces cancellations by ~90% — when stock drops on your webshop or another marketplace, Ricardo is updated within seconds, eliminating overselling and Käuferschutz claims for unavailable items.

Ricardo Promotion and Smart Pricing

Ricardo Promotional Tools

• Featured Listings — top placement in category search results (CHF per listing)
• Bold Title — visual prominence in result lists
• Gallery Plus — extra photo slots and homepage carousel chances
• Pro Shop Banner — branded storefront banner for Premium/Enterprise tier
• Newsletter inclusion — for seasonal Pro Shop campaigns

Smart Pricing (Repricer)

On Buy Now listings, multiple Pro Shops often compete for the same SKU. The lowest competitive price with high shop rating wins the visibility race. Zunapro's Repricer module auto-adjusts your Ricardo prices against competitors in real time — without ever crossing your minimum margin floor.

QR-Rechnung, VAT and Swiss Compliance

Every Pro Shop selling to Swiss customers must issue compliant invoices. Since 2022, QR-Rechnung (QR-bill) is the mandatory invoice format in Switzerland, replacing the old orange/red payment slips. B2C and B2B both require it. Manual invoice issuance is impossible at 100+ orders/day.

Zunapro QR-Rechnung module:

• Generates compliant QR-Rechnung PDF as soon as the Ricardo order webhook fires
• ESTV-compliant Swiss VAT calculation (8.1% standard / 2.6% reduced / 3.8% accommodation)
• Automatic refund/credit-note QR-bills for returns and Käuferschutz refunds
• Monthly VAT reporting export ready for ESTV submission
• nFADP-compliant customer data handling (EDÖB requirements)
• Automatic PDF delivery to buyer via email after order confirmation

Ricardo Shipping Integration — Die Post, DPD, Quickpac, Planzer

Ricardo does not operate its own logistics — unlike Trendyol or Amazon, there is no Ricardo fulfillment. Sellers ship from their own warehouse or via Swiss carriers. The default and most-used carrier is Die Post (Swiss Post / La Poste / La Posta), used by an estimated 80%+ of Ricardo Pro Shops. Other supported carriers integrated by Zunapro:

• Die Post — primary; PostPac Priority and Economy; nationwide next-day coverage
• DPD Schweiz — strong for B2B parcels and parcels above 30kg
• Quickpac — fast and cost-competitive Swiss-domestic carrier
• Planzer — heavy goods, pallets, furniture and large car parts

The Zunapro multi-carrier module picks the best carrier per order based on weight, destination canton and buyer preference; prints the label automatically and pushes the tracking number back to Ricardo so the buyer is notified.

Returns and Käuferschutz Dispute Handling

Switzerland has no statutory cooling-off period for online purchases by default, but Ricardo enforces a buyer-friendly 7-day return window for new and refurbished items sold by Pro Shops, and provides Käuferschutz coverage. The Swiss Code of Obligations (OR) also enforces a 2-year statutory warranty for new goods.

Standard Ricardo Return Flow:

1. Buyer opens a return or Käuferschutz claim through the Ricardo panel
2. Pro Shop has 24–48h to respond and provide a return label (typically Die Post)
3. Buyer ships item back; carrier scan triggers next status
4. Pro Shop inspects the item and approves or rejects within 1–3 business days
5. If approved, refund is issued through Ricardo's wallet/payout system and credit-note QR-Rechnung is sent

Zunapro returns module automates every step: notification, label generation, refund issuance, credit-note QR-bill and the Käuferschutz evidence package if the case escalates.

Zunapro Ricardo Integration — 4-Step Setup (10 Minutes)

1. Enter your Ricardo Shop credentials — In the Zunapro panel, go to Marketplace → Ricardo and enter your Shop ID, API key and API secret.
2. Connect your existing webshop — Ready connectors for Shopify, WooCommerce, Magento, Shopware, PrestaShop, and custom platforms. Just provide API URL + access token.
3. Category mapping wizard — Drag-and-drop your shop categories onto Ricardo categories. AI suggestions complete the mapping in minutes, including DE/FR/IT title translation.
4. Initial sync — Products, stock, prices, orders, shipping — everything starts syncing automatically. Within 10 minutes your Ricardo Shop is fully managed from the Zunapro panel.

Ricardo Integration FAQ