Für Online-Shops und Entwickler
Verkaufe unseren ganzen Katalog in deinem Shop. Wir liefern die Keys.
Spiele, DLC, Software, Windows und Office, Geschenkkarten und Abos, per REST-API oder mit dem WordPress-Plugin. Zahlt dein Kunde, wird der Key automatisch gekauft und geliefert und von deinem Prepaid-Guthaben (zum Beispiel 500 € aufladen, danach wird jede Bestellung automatisch abgebucht) oder von deiner Wallet abgezogen.
2 % günstiger als unsere Website
Der API-Preis ist unser Website-Preis minus 2 % – bei jedem Produkt des Katalogs.
Keine Servicegebühr
Die Website berechnet an der Kasse eine Gebühr. Die API nicht: Du zahlst den API-Preis und sonst nichts.
Prepaid-Guthaben oder Wallet
Einmal aufladen, dann wird jede Bestellung automatisch abgebucht. Reicht das Guthaben nicht, deckt die Wallet deines Kontos den Rest.
Funktioniert mit
- Shopify
- WooCommerce
- Shopware
- Magento
- PrestaShop
- CS-Cart
- OpenCart
- BigCommerce
- + 120
POST /partner-api/v1/orders
Authorization: Bearer bck_live_…
{ "externalId": "shop-10045",
"items": [ {
"productId": "prod-17298",
"qty": 1,
"maxUnitPrice": 4.50 } ] }
→ 201 { "status": "completed",
"total": "…",
"keys": [ { "value": "XXXXX-…" } ] }Aktion läuft
20 % Rabatt auf alle Microsoft-Produkte
Gib den Code bei deinen Bestellungen an und zahle 20 % weniger für jede Lizenz von Windows, Office, Visio, Project und SQL Server. Ohne Gebühren, ohne Mindestmenge.
API-Feld
"couponCode": "MICROSOFT20"Kurz gesagt
BuyCheapKeys bietet Online-Shops eine REST-API und ein WordPress/WooCommerce-Plugin, um den gesamten Katalog weiterzuverkaufen: Spiele, DLC, Software, Windows und Office, Geschenkkarten und Abos. Der API-Preis ist der Website-Preis minus 2 %, ohne Servicegebühr. Ein Shop importiert die Produktseiten in einer oder mehreren von 7 Sprachen, hält Preis und Bestand per Cursor aktuell und bestellt einen Key, wenn sein eigener Kunde zahlt. Der Key kommt meist in der Bestellantwort (oder später per Webhook, falls die Bestellung noch läuft) und wird vom Prepaid-Guthaben des Shops oder seiner Wallet bezahlt. Eine kostenlose Sandbox ist verfügbar.
Aktualisiert:
Der Katalog, den du verkaufen kannst – live
Diese Zahlen stammen direkt aus der API und werden alle paar Minuten aktualisiert. Preise stehen nicht auf dieser Seite: Du siehst sie mit deinem Schlüssel.
- 33.457
- Produkte auf Lager
- 19
- Plattformen mit Bestand
- 32.839
- Spiele und DLC auf Lager
- 498
- Softwareprodukte auf Lager
- 120
- Abos auf Lager
Plattformen mit den meisten Produkten
- Steam 25.960
- Xbox 4.579
- PlayStation 1.119
- GOG 426
- Epic Games 410
- Ubisoft Connect 330
- PC 305
- Microsoft 137
- EA App 120
- Rockstar 17
- Nintendo 13
- Mac 11
Ein Teil dessen, was du heute verkaufen kannst
Eine Auswahl von Covern aus dem Katalog. Jedes Produkt kommt mit seiner Produktseite: Beschreibung, Aktivierungsschritte, Anforderungen, Screenshots und Region.

Grand Theft Auto V Enhanced EU PC Rockstar Digital Download (Rockstar) - Digitaler Key Europa
RockstarKey

ELDEN RING NIGHTREIGN (Steam) - Digitaler Key Vereinigte Staaten
SteamKey

EA SPORTS FC 26 PS4/PS5 (PS4 Account)
PlayStationKonto

EA Sports FC 24
EA AppKey

Minecraft Legends Deluxe Edition (Xbox Account)
XboxKonto

Baldur's Gate 3 (Steam Account)
SteamKonto

Forza Horizon 4 Ultimate Edition (Xbox Account)
XboxKonto

Call of Duty: Vanguard
XboxKey

Hogwarts Legacy
XboxKey

Hogwarts Legacy Digital Deluxe Edition (PS5 Account)
PlayStationKonto

Stardew Valley (Steam Gift) (Steam) - Digitaler Key Global
SteamGeschenklink

Black Myth: Wukong (Xbox Series X|S Account)
XboxKonto

Microsoft Windows 11 Pro (PC) - Microsoft Key - GLOBAL (Microsoft) - Digitaler Key Global
MicrosoftKey

Microsoft Windows 10 / 11 Pro - 20 PC - Volume MAK
MicrosoftKey

Microsoft Windows 10 / 11 Pro - 1 PC - Activate by Phone
MicrosoftKey

Microsoft Windows 10 / 11 Pro - 1 PC - OEM
MicrosoftKey
So funktioniert es
- 01
Konto erstellen
Bewirb dich als Partner und erstelle einen Sandbox-Schlüssel, um alles mit Fake-Keys zu testen. In der Sandbox fließt kein Geld.
- 02
Katalog importieren
Lies den Produkt-Endpunkt mit den Filtern, die du brauchst (Plattform, Region, Typ, Preis), in einer oder mehreren Sprachen und halte Preis und Bestand per Cursor aktuell.
- 03
Dein Kunde zahlt
Der Verkauf findet in deinem Shop statt, mit deinem Preis und deinen Zahlungsarten. Dein Shop sendet eine Anfrage: POST /orders mit dem Produkt und dem höchsten Preis, den du akzeptierst.
- 04
Der Key wird geliefert
Der Key kommt meist in derselben Antwort (steht die Bestellung auf "processing", kommt er per Webhook oder mit GET /orders/{id}/keys), wird von deinem Guthaben oder deiner Wallet abgebucht und dein Shop schickt ihn an deinen Kunden. Das WordPress-Plugin macht das alles selbst.
Filter und Formate
Verkaufe nur, was zu deinem Shop passt. Alle Filter funktionieren am Produkt-Endpunkt und lassen sich kombinieren.
Lieferformat
Key zum Einlösen, Geschenklink (Steam Gift), Konto oder Aktivierungslink. Jedes Produkt gibt an, welches es ist.
Plattform
Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft und mehr.
Region
Die Region jedes Keys und die genaue Liste der Länder, in denen er nicht aktiviert werden kann.
Produkttyp
Spiele, DLC, Software, Windows und Office, Geschenkkarten und Abos.
Preis
Mindest- und Höchstpreis, Sortierung nach Preis, Beliebtheit, Name oder Neuheit.
Bestand und Änderungen
Nur, was auf Lager ist, oder nur, was sich seit deiner letzten Synchronisierung geändert hat.
Produktseiten in 7 Sprachen
Namen, Beschreibungen und Aktivierungsschritte gibt es auf Englisch, Spanisch, Deutsch, Französisch, Italienisch, Portugiesisch und Polnisch. Wähle eine Sprache oder importiere mehrere auf einmal für einen mehrsprachigen Shop mit WPML oder Polylang. Jedes Produkt nennt die tatsächliche Sprache seines Textes.
- en
- es
- de
- fr
- it
- pt
- pl
Zahle mit Prepaid-Guthaben oder deiner Wallet
Lade dein Guthaben einmal auf, zum Beispiel 500 €, und jede Bestellung wird automatisch abgebucht, sobald dein Kunde zahlt. Reicht das Guthaben nicht, deckt die Wallet deines Kontos den Rest. Jede Buchung steht in deinem Kontoauszug und ein Webhook meldet dir, wenn eine Aufladung eintrifft.
Kostenlose Sandbox
Sandbox-Schlüssel (bck_test_) nutzen den echten Katalog und die echten Preise, liefern aber Fake-Keys und ein Testguthaben. Nichts wird abgebucht und kein echter Bestand verwendet, sodass du den ganzen Ablauf zuerst bauen und testen kannst.
Signierte Webhooks
Erhalte Benachrichtigungen, wenn eine Bestellung abgeschlossen oder erstattet wird, wenn ein Key ersetzt wird und wenn sich Produkte ändern (products.updated und catalog.changed). Jedes Ereignis ist mit HMAC-SHA256 signiert und wird etwa einen Tag lang wiederholt.
WordPress- und WooCommerce-Plugin
Läuft dein Shop auf WordPress, musst du nicht programmieren. Installiere das Plugin, füge deinen API-Schlüssel ein und wähle deine Marge.
Version 1.1.0 · kostenlos · WordPress + WooCommerce
Plugin herunterladen- Importiert jedes Produkt mit Produktseite, Aktivierungsschritten und Anforderungen
- Aktualisiert Preis und Bestand automatisch, mit deiner Marge und Rundung
- Prüft den Warenkorb vor der Kasse und sperrt Produkte, die nicht lieferbar sind
- Kauft den Key, sobald die Bestellung bezahlt ist, und schickt ihn per E-Mail an deinen Kunden
- Zeigt den Key auf der Bestellseite und in Mein Konto, verschlüsselt gespeichert
- Versucht es bei Fehlern selbst erneut und warnt dich per E-Mail
API-Dokumentation
Alles für die Integration: Authentifizierung, Katalog-Synchronisierung, Filter, Bestellungen, Key-Lieferung, Reklamationen, Webhooks, Fehler und Limits.
API-Dokumentation lesen# 1. Read the catalogue (sheets, price, stock) in your language
curl "https://buycheapkeys.com/partner-api/v1/products?lang=en&inStock=true&limit=100" \
-H "Authorization: Bearer $BCK_API_KEY"
# 2. Buy a key when your customer pays
curl -X POST "https://buycheapkeys.com/partner-api/v1/orders" \
-H "Authorization: Bearer $BCK_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: shop-10045" \
-d '{ "externalId": "shop-10045",
"items": [ { "productId": "prod-17298", "qty": 1, "maxUnitPrice": 4.50 } ] }'Plattformen
Funktioniert mit Shopify, Shopware, Magento, PrestaShop und jeder anderen Shop-Plattform
Kann deine Plattform eine Anfrage senden, wenn eine Bestellung bezahlt wird, kann sie unseren Katalog verkaufen. Das gilt für die Liste unten mit mehr als 120 Namen und für jeden selbst programmierten Shop. Das einzige Plugin, das wir heute anbieten, ist das für WooCommerce. Bei allen anderen verbindest du dich über die REST-API.
So verbindest du jede Plattform
- 01
Katalog
Lies den Produkt-Endpunkt, um Namen, Beschreibungen, Aktivierungsschritte und Titelbilder zu importieren und Preis und Bestand aktuell zu halten.
- 02
Bezahlte Bestellung
Deine Plattform löst ihr Ereignis für bezahlte Bestellungen aus: ein Webhook, ein Hook, ein Flow oder ein geplanter Job. Dieses Ereignis ruft POST /orders mit dem Produkt und dem höchsten akzeptierten Preis auf.
- 03
Lieferung
Die Antwort enthält den Key. Dein Shop schickt ihn per E-Mail an den Kunden und zeigt ihn in der Bestellung an. Ist der Key noch nicht bereit, meldet der Webhook order.completed, wann er es ist.
Übliche Wege je Plattform
Jede Plattform reagiert auf eine bezahlte Bestellung auf ihre eigene Art. Das sind die Wege, die die meisten Shops nutzen. Dein Entwickler oder ein Werkzeug wie Zapier oder Make kann jeden davon einrichten.
- WooCommercePlugin
BuyCheapKeys plugin - ShopifyAPI
orders/paid webhook - ShopwareAPI
Flow Builder + HTTP request - Magento / Adobe CommerceAPI
sales_order_invoice_pay observer - PrestaShopAPI
actionPaymentConfirmation hook - CS-CartAPI
change_order_status hook - OpenCartAPI
order history event - BigCommerceAPI
store/order/statusUpdated webhook - SaleorAPI
ORDER_FULLY_PAID webhook - MedusaAPI
order subscriber - SyliusAPI
state machine callback - nopCommerceAPI
OrderPaidEvent consumer - commercetoolsAPI
Subscriptions - WixAPI
Velo backend - SquarespaceAPI
Orders API webhook - EcwidAPI
order webhook
Alle Plattformen nach Art
Gehostete Shop-Baukästen
- Shopify
- Shopify Plus
- BigCommerce
- Wix
- Squarespace
- Ecwid
- Square Online
- Weebly
- GoDaddy Online Store
- Shift4Shop
- Volusion
- Big Cartel
- Webflow Ecommerce
- Jimdo
- Lightspeed eCom
- Zoho Commerce
- Storenvy
- Selz
Open Source und Selbsthosting
- WooCommerce
- Magento Open Source
- PrestaShop
- OpenCart
- CS-Cart
- Zen Cart
- osCommerce
- Sylius
- Bagisto
- Spree Commerce
- Solidus
- Saleor
- Medusa
- Vendure
- nopCommerce
- Shopware
- Drupal Commerce
- thirty bees
- Apache OFBiz
- Aimeos
- Lunar
- EverShop
- Craft Commerce
- VirtueMart
- HikaShop
- Pimcore
Enterprise- und Headless-Commerce
- Adobe Commerce
- Salesforce Commerce Cloud
- SAP Commerce Cloud
- Oracle Commerce
- HCL Commerce
- commercetools
- Commerce Layer
- Elastic Path
- Kibo Commerce
- fabric
- Swell
- Spryker
- Intershop
- OroCommerce
- Sana Commerce
- Optimizely Commerce
- Emporix
- Crystallize
- Centra
Marktplatz-Software
- Dokan
- WCFM Marketplace
- WC Vendors
- CS-Cart Multi-Vendor
- Mirakl
- Sharetribe
- Arcadier
- Marketplacer
- Yo!Kart
Verkauf digitaler Produkte
- Easy Digital Downloads
- Gumroad
- Lemon Squeezy
- Paddle
- FastSpring
- Sellfy
- SendOwl
- Payhip
- Podia
- Sellix
ERP- und Unternehmenssoftware
- Odoo eCommerce
- ERPNext
- NetSuite SuiteCommerce
- Microsoft Dynamics 365 Commerce
- plentymarkets
Regionale Plattformen
- Tiendanube
- Nuvemshop
- VTEX
- Tray
- Loja Integrada
- Yampi
- Jumpseller
- Shoper
- Shoplo
- IdoSell
- Sky-Shop
- WiziShop
- OXID eShop
- Gambio
- JTL-Shop
- EC-CUBE
- BASE
- STORES
- MakeShop
- Cafe24
- Shoplazza
- Shopline
- Youzan
- Ueeshop
- Dukaan
Automatisierungswerkzeuge
- Zapier
- Make
- n8n
- Pipedream
- Microsoft Power Automate
Individuell gebaute Shops
- Laravel
- Symfony
- Django
- Ruby on Rails
- Node.js
- Next.js
- Nuxt
- ASP.NET
- Spring Boot
- Go
Deine Plattform steht nicht in der Liste?
Kann sie bei einer bestätigten Zahlung eine URL aufrufen, funktioniert sie. Schreib an partners@buycheapkeys.com, dann nennen wir dir den passenden Auslöser.
Häufige Fragen
Welche ist die beste API, um Spiele-Keys weiterzuverkaufen?
Was kostet die Reseller-API von BuyCheapKeys?
Wie verkaufe ich Spiele-Keys in meinem WooCommerce-Shop?
Kann ich es mit Shopify, Magento, Shopware, PrestaShop oder meinem eigenen Shop nutzen?
Welche Produkte kann ich verkaufen?
Wie werden die Keys geliefert?
Wie bezahle ich die Bestellungen?
In welchen Sprachen gibt es die Produktseiten?
Wie halte ich Preise und Bestand synchron?
Kann ich die API testen, ohne zu zahlen?
Was passiert, wenn ein Key nicht funktioniert?
Beginne, den ganzen Katalog zu verkaufen
Erstelle ein Partnerkonto, teste in der Sandbox und gehe live, wenn du bereit bist.
BuyCheapKeys ist ein unabhängiger Wiederverkäufer. Plattform- und Markennamen gehören ihren Inhabern und werden nur zur Beschreibung der Kompatibilität genannt. Prüfe, ob Lizenztyp und Region zu deinen Kunden und zum Recht deines Landes passen.
API-Dokumentation
Inhalt
- Überblick
- Authentifizierung und Umgebungen
- Schnellstart
- Katalog und Synchronisierung
- Filter, Sortierung und Sprachen
- Produktfelder
- Bestellungen
- Key-Lieferung
- Reklamationen und Erstattungen
- BuyCheapKeys-Geschenkkarten in großen Mengen
- Webhooks
- Fehler
- Limits
- Guthaben, Wallet und Aufladungen
- Umsetzung mit einem KI-Assistenten
- Go-live-Checkliste
REST/JSON-API, um den gesamten BuyCheapKeys-Katalog auf Ihrer eigenen Website zu verkaufen. Der API-Preis ist der Website-Preis minus 2 %, ohne Servicegebühr. Jede Bestellung wird von Ihrem Prepaid-Guthaben (oder Ihrem Wallet) bezahlt, und die Keys kommen in derselben Antwort zurück.
Überblick
Basis-URL: https://buycheapkeys.com/partner-api/v1. Alle Anfragen und Antworten sind JSON (UTF-8). Preise sind in EUR mit zwei Nachkommastellen angegeben und enthalten keine Mehrwertsteuer. Datumsangaben sind ISO 8601 in UTC.
- Katalog: der gesamte Katalog der Website (Spiele, DLC, Software, Windows und Office, Geschenkkarten, Abonnements) mit Produktdatenblättern in 7 Sprachen (en, es, de, fr, it, pt, pl).
- Preis: API-Preis = Website-Preis minus 2 % und keine Servicegebühr (die Website erhebt an der Kasse eine Gebühr, die API nicht).
GET /meliefertdiscountPercentundserviceFee: 0. - Bestellungen: bis zu 10 Positionen x 9 Einheiten pro Anfrage; die Gesamtsumme wird auf einmal Ihrem Prepaid-Guthaben belastet und, falls dieses nicht reicht, Ihrem Wallet.
- Lieferung: Die Keys stehen in der Antwort der Bestellung und können mit GET /orders/{id}/keys erneut abgerufen werden.
- Reklamationen: Ein fehlerhafter Key kann 14 Tage lang über Ihr Partner-Dashboard reklamiert werden; ein Ersatz-Key erreicht Ihre Bestellung automatisch, und eine Erstattung geht zurück auf Ihr Guthaben.
WordPress/WooCommerce? Nutzen Sie das Plugin (siehe Abschnitt Plugin weiter oben): Es importiert den Katalog, hält Preis und Bestand synchron und liefert die Keys ohne Code aus.
Authentifizierung und Umgebungen
Erstellen Sie Schlüssel unter Dashboard → Partner → API-Schlüssel. Ein Schlüssel wird nur einmal angezeigt; wir speichern ausschließlich seinen Hash. Senden Sie ihn im Header Authorization (X-Api-Key wird ebenfalls akzeptiert).
curl https://buycheapkeys.com/partner-api/v1/ping \
-H "Authorization: Bearer bck_test_xxxxxxxxxxxx_..."| Schlüsselpräfix | Modus | Verhalten |
|---|---|---|
| bck_test_ | Sandbox | Echter Katalog und echte Preise, separates Testguthaben (zurücksetzbar), Fake-Keys wie TEST-AB12C-…, es fließt kein Geld. Webhooks werden mit mode: test gesendet. |
| bck_live_ | Produktion | Echte Käufe, die Ihrem Live-Guthaben (und Wallet) belastet werden. |
| Scope | Erlaubt |
|---|---|
| catalog:read | GET /products, /products/{id}, /meta, /me, /ping, /gift-cards |
| webhooks:write | PUT, GET und DELETE /webhook (Ihre Webhook-URL registrieren oder entfernen) |
| orders:write | POST /orders, POST /gift-cards/orders |
| orders:read | GET /orders, /orders/{id}, /orders/{id}/keys, /gift-cards/orders, /gift-cards/orders/{id}, POST /webhooks/test |
| balance:read | GET /balance |
Optionale IP-Allowlist (IPv4/IPv6, CIDR) pro Konto. Schlüssel laufen nie ab, es sei denn, sie werden widerrufen; rotieren Sie sie, indem Sie einen neuen Schlüssel erstellen und den alten widerrufen. GET /public/catalog benötigt keinen Schlüssel.
Schnellstart
1) Einen bck_test_-Schlüssel erstellen. 2) Produkte auflisten. 3) Eine Bestellung aufgeben: Sie kommt abgeschlossen und mit den Keys zurück. 4) Die Keys jederzeit mit GET /orders/{id}/keys erneut abrufen. Konten, die noch geprüft werden, können Sandbox-Schlüssel nutzen.
curl "https://buycheapkeys.com/partner-api/v1/products?lang=en&limit=100&inStock=true" \n -H "Authorization: Bearer $BCK_API_KEY"Katalog und Synchronisierung
GET /products liefert die Produkte sortiert nach updatedAt (dann nach ID). updatedAt ändert sich nur, wenn sich etwas für Sie Relevantes ändert (Preis, Bestand, Name, Region, Texte, Bilder). Synchronisieren Sie mit dem Cursor: Jede Antwort enthält nextCursor und hasMore; geben Sie nextCursor als ?cursor= zurück, bis hasMore false ist, und speichern Sie ihn für den nächsten Durchlauf. Er überspringt oder wiederholt nie Produkte, auch wenn viele denselben Zeitstempel haben (der Cursor folgt stets updatedAt; sort gilt nur beim seitenweisen Durchsuchen).
Zwei Formate: fields=full (Standard, bis zu 100 Produkte pro Seite) ist das vollständige Datenblatt; fields=summary (bis zu 500 pro Seite) liefert nur id, price, shopPrice, currency, inStock, qty, updatedAt und removed – ideal, um Preis und Bestand jede Minute aktuell zu halten.
# Light incremental sync: only id, price, stock and flags (up to 500 per page)
curl "https://buycheapkeys.com/partner-api/v1/products?fields=summary&limit=500&includeRemoved=true&cursor=$SAVED_NEXT_CURSOR" \n -H "Authorization: Bearer $BCK_API_KEY"- Empfohlen: einmal vollständig importieren (fields=full, in der/den Sprache(n) Ihres Shops), danach alle 1–5 Minuten
fields=summaryab dem gespeichertennextCursor, stets mitincludeRemoved=true. - Verfügbarkeit: Kann die Website ein Produkt nicht verkaufen (kein Bestand, Bestand deaktiviert, Einkaufspreis über unserer Obergrenze), erscheint es in weniger als einer Minute als
inStock: false, qty: 0; ein ausgeblendetes oder gelöschtes Produkt hatremoved: true. Verkaufen Sie diese niemals. - Katalogänderungen werden per Webhook angekündigt (
products.updated,catalog.changed), sodass Polling selten nötig ist. GET /public/catalog?lang=(ohne Schlüssel, 10 Minuten zwischengespeichert) liefert aktuelle Kennzahlen und einige ausgewählte Cover für Ihre eigene Landingpage.
Filter, Sortierung und Sprachen
lang (en, es, de, fr, it, pt, pl; Standard en) wählt die Sprache von Namen und Beschreibungen. Jedes Produkt hat language mit der tatsächlichen Sprache des Textes (en, wenn eine Übersetzung fehlt). Eine Sprache oder mehrere: einmal pro Sprache aufrufen oder für WPML/Polylang/mehrsprachige Shops alle sieben importieren. Listen akzeptieren kommagetrennte Werte.
| Parameter | Werte / Bedeutung |
|---|---|
| platform | Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft, … (siehe /meta) |
| region | Regionsbezeichnung (Global, Europe, …); siehe /meta |
| productType | game, dlc, software, gift-card, gift, subscription, game-point |
| deliveryType | key, gift (Steam-Gift-Link), account, link (Aktivierungslink) |
| category | game, dlc, software, microsoft, gift-card, gift, subscription |
| genre | Genrename (siehe /meta) |
| minPrice / maxPrice | EUR, API-Preis |
| inStock | true, um nur aufzulisten, was jetzt verkauft werden kann |
| search | Alle Wörter, abgeglichen mit dem Namen und dem übersetzten Titel |
| ids | Bis zu 200 Produkt-IDs |
| updatedSince / includeRemoved | Änderungen seit einem Datum; entfernte Produkte einbeziehen |
| sort | updated, popularity, name, price_asc, price_desc, newest (mit Seiten; der Sync-Cursor folgt stets updatedAt) |
| fields / limit / cursor / page | full oder summary; bis zu 100 (full) bzw. 500 (summary); cursor für die Synchronisierung; page zum Durchsuchen |
# Steam keys of games, Europe or Global, between 5 and 30 EUR, sorted by price, product sheets in Spanish
curl -G "https://buycheapkeys.com/partner-api/v1/products" -H "Authorization: Bearer $BCK_API_KEY" --data-urlencode "lang=es" --data-urlencode "platform=Steam" --data-urlencode "productType=game" --data-urlencode "deliveryType=key" --data-urlencode "minPrice=5" --data-urlencode "maxPrice=30" --data-urlencode "inStock=true" --data-urlencode "sort=price_asc" --data-urlencode "limit=50"
# Facets with counts (platforms, regions, product types, genres, price range)
curl "https://buycheapkeys.com/partner-api/v1/meta" -H "Authorization: Bearer $BCK_API_KEY"GET /meta liefert die Facetten mit Anzahl und Bestand (Plattformen, Regionen, Produkttypen, Genres, Sprachen, Preisspanne, Sortierwerte), damit Sie eigene Filter bauen können.
Produktfelder
{
"id": "prod-17298",
"name": "Terraria (Steam Gift)",
"language": "en",
"platform": "Steam",
"region": "Europe",
"productType": "game",
"deliveryType": "gift",
"category": "game",
"price": 3.71,
"shopPrice": 3.79,
"discountPercent": 2,
"rrp": 9.99,
"currency": "EUR",
"inStock": true,
"qty": 12,
"activation": { "excludedCountries": ["RU", "BY", "..."], "allowedCountryCount": 53 },
"shortDescription": "Dig, fight, explore, build.",
"description": "Plain-text description...",
"descriptionHtml": "<p>Clean HTML without links or images...</p>",
"features": ["Single player", "Co-op"],
"activationSteps": [],
"activationDetails": "You will receive a gift link...",
"systemRequirements": [ { "system": "Windows", "requirement": ["..."] } ],
"languages": ["English", "Spanish", "German"],
"genres": ["Action", "Adventure"],
"developer": "Re-Logic", "publisher": "Re-Logic", "releaseDate": "2011-05-16", "ageRating": "PEGI 12",
"coverImage": "https://buycheapkeys.com/...cover.webp",
"screenshots": ["https://buycheapkeys.com/..."],
"videos": ["https://www.youtube.com/watch?v=..."],
"url": "https://buycheapkeys.com/en/product/terraria-steam-europe-238023",
"updatedAt": "2026-11-19T10:05:12.881Z",
"removed": false
}| Feld | Bedeutung |
|---|---|
| price | Ihr Stückpreis in EUR: Website-Preis minus 2 %. Wird bei der Bestellung live neu geprüft. |
| shopPrice / discountPercent | Website-Preis und Ihr Rabatt (2). |
| rrp | Echter Verkaufspreis, wenn er höher als der API-Preis ist; sonst null. |
| deliveryType | key = einzulösender Code · gift = Steam-Gift-Link · account = Zugangsdaten · link = Aktivierungslink. Sagen Sie Ihrem Kunden, welche Art er kauft. |
| region / activation | Regionsbezeichnung sowie die genaue ISO-Liste der Länder, in denen er NICHT aktiviert werden kann. |
| productType / category / edition / licenseType | Klassifizierung des Produkts. |
| language | Sprache der Texte dieser Antwort. |
| shortDescription / description / descriptionHtml / features | Texte. descriptionHtml ist sauberes HTML ohne Links oder Bilder. |
| activationSteps / activationDetails / systemRequirements | Einlöseanleitung und Systemanforderungen. |
| languages / genres / developer / publisher / releaseDate / ageRating | Spieldaten. |
| coverImage / screenshots / videos | Bilder von unserem CDN (bitte bei sich zwischenspeichern) und YouTube-Videos. |
| qty | Einheiten auf Lager (auf 999 begrenzt). |
| url | Öffentliche Produktseite auf der Website. |
Bestellungen
POST /orders mit externalId (Ihre eindeutige Referenz) und items (productId, qty 1–9, maxUnitPrice). Für jede Position prüfen wir den aktuellen Preis: Liegt er über maxUnitPrice, wird die gesamte Bestellung mit PRICE_CHANGED abgelehnt und nichts abgebucht. Liegt er darunter, zahlen Sie den niedrigeren Preis. Verkauft wird aus der günstigsten Quelle mit Bestand, wie auf der Website.
Empfohlen: Senden Sie storeUrl (die URL Ihres Shops, in dem das Produkt verkauft wird) im Body von POST /orders oder den Header X-Store-Url bei jedem Aufruf. Optional; das WordPress-Plugin sendet die URL Ihrer Website automatisch.
Promo-Code: Fügen Sie couponCode: MICROSOFT20 hinzu, um bei Microsoft-Produkten (Windows, Office, Visio, Project, SQL Server) 20 % weniger zu zahlen, solange die Aktion läuft. Er wird nur auf diese Positionen angewendet; ein unbekannter Code oder eine beendete Aktion liefert INVALID_COUPON, und es wird nichts abgebucht.
const res = await fetch("https://buycheapkeys.com/partner-api/v1/orders?wait=20", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.BCK_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": `shop-order-${order.id}`, // same value on every retry
},
body: JSON.stringify({
externalId: String(order.id),
items: [{ productId: "prod-17298", qty: 1, maxUnitPrice: 4.5 }],
}),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);
if (data.status === "completed") {
const { keys } = await (await fetch(`https://buycheapkeys.com/partner-api/v1/orders/${data.id}/keys`, {
headers: { Authorization: `Bearer ${process.env.BCK_API_KEY}` },
})).json();
// deliver keys[].value to your customer
}- Senden Sie einen
Idempotency-Key-Header (8–100 Zeichen) und verwenden Sie ihn bei Wiederholungen erneut: Sie erhalten die ursprüngliche Antwort und werden nie doppelt belastet.externalIdist ebenfalls pro Konto eindeutig. - Die Bestellung wird in derselben Anfrage abgeschlossen (
?wait=20wartet bis zu 20 s): Die Antwort hat den Statuscompletedund einkeys-Array. Eine wiederholte Anfrage liefert die Bestellung ohne ihre Keys und mitkeysOmitted: true: Lesen Sie sie mit GET /orders/{id}/keys. - Kein Bestand oder zu wenig Guthaben: Es wird nichts abgebucht und kein Key verbraucht (
OUT_OF_STOCK,INSUFFICIENT_BALANCE).maxUnitPriceist eine Obergrenze für jeden Key. - Läuft eine Anfrage in ein Timeout, senden Sie sie mit derselben externalId erneut: Sie erhalten
DUPLICATE_EXTERNAL_IDmit der Bestell-ID und können deren Keys lesen.
| Status | Bedeutung |
|---|---|
| completed | Alle Einheiten geliefert. Die Keys stehen in der Antwort. |
| partially_refunded | Einige Keys wurden nach Reklamationen Ihrem Guthaben erstattet. |
| refunded | Alle Keys der Bestellung wurden Ihrem Guthaben erstattet. |
Key-Lieferung
GET /orders/{id}/keys liefert jede gelieferte Einheit: value enthält je nach deliveryType den Code, die Steam-Gift-URL, die Zugangsdaten oder den Aktivierungslink. contentType ist text/plain oder ein Bildtyp (dann ist value base64).
Speichern Sie Keys verschlüsselt und zeigen Sie sie nur dem Käufer. Der erste Abruf jeder Bestellung wird bei uns als Liefernachweis protokolliert.
Reklamationen und Erstattungen
Ein fehlerhafter Key kann 14 Tage lang reklamiert werden. Öffnen Sie die Bestellung unter Dashboard → Bestellungen (API-Bestellungen), wählen Sie den Key, schreiben Sie dem Verkäufer und fügen Sie Screenshots des Aktivierungsfehlers an. Der Verkäufer kann einen Ersatz-Key senden (er erscheint in Ihrer Bestellung, und Sie erhalten den Webhook key.replaced) oder den Key erstatten (der Preis geht einmalig auf Ihr API-Guthaben zurück, und Sie erhalten order.refunded). Sind Sie nicht einverstanden, eskalieren Sie, und BuyCheapKeys entscheidet.
Prüfen Sie vor dem Verkauf Region, excludedCountries und Lizenztyp und zeigen Sie diese Ihrem Kunden an. Eine Erstattung auf Ihr Guthaben erstattet nicht Ihrem eigenen Kunden: Das entscheiden Sie.
BuyCheapKeys-Geschenkkarten in großen Mengen
Neben Geschenkkarten anderer Marken (sie sind Produkte des Katalogs, productType=gift-card) können Sie unsere eigenen Geschenkkarten zum Weiterverkauf kaufen: Codes BCK-XXXX-XXXX-XXXX-XXXX, die ihren Wert dem BuyCheapKeys-Wallet desjenigen gutschreiben, der sie auf buycheapkeys.com/wallet einlöst. GET /gift-cards liefert die verkauften Werte, die Mengenrabatte, die Höchstmengen pro Bestellung und Ihr Wallet-Guthaben. POST /gift-cards/orders kauft N Karten eines Wertes und liefert die Codes sofort; GET /gift-cards/orders/{id} zeigt sie erneut mit dem Status jedes Codes.
curl https://buycheapkeys.com/partner-api/v1/gift-cards \
-H "Authorization: Bearer $BCK_API_KEY"- Bezahlt wird ausschließlich aus dem BuyCheapKeys-Wallet Ihres Shop-Kontos (aufladen unter buycheapkeys.com/wallet), nicht aus dem API-Guthaben. Preis = Nennwert minus Mengenrabatt für diese Anzahl.
- Werte, Rabatte und Höchstmengen können sich ändern: Senden Sie
maxTotal, um eine höhere Gesamtsumme abzulehnen (PRICE_CHANGED, nichts abgebucht).Idempotency-Keyund die eindeutigeexternalIdfunktionieren wie bei Bestellungen. - Verkauf pausiert:
PRODUCT_UNAVAILABLE(409). Wert nicht im Verkauf oder Menge außerhalb des Bereichs:VALIDATION_ERROR. Bestellung zu groß:ORDER_LIMIT_EXCEEDED. Wallet-Guthaben reicht nicht:INSUFFICIENT_BALANCE(402). - Sandbox-Schlüssel liefern Fake-Codes
BCK-TEST-…, die nicht eingelöst werden können und nichts abbuchen. - Verkaufte Codes sind endgültig. Jeder Code hat ein Ablaufdatum (
expiresAt) und Einlöselimits pro Konto. Ein wegen Betrugs gesperrter Code wird nicht mehr angezeigt (code: null, Statusblocked). Speichern Sie die Codes verschlüsselt.
Webhooks
Legen Sie unter Dashboard → Webhooks (oder per PUT /webhook) eine https-URL fest; Sie erhalten ein Signaturgeheimnis (whsec_…). Jedes Ereignis ist ein POST mit den Headern X-BCK-Event, X-BCK-Delivery (eindeutige ID: darauf deduplizieren) und X-BCK-Signature: t=<unix>,v1=<hex>, wobei v1 = HMAC-SHA256(secret, t + "." + rawBody).
| Ereignis | Wann |
|---|---|
| order.completed | Eine Bestellung wurde abgeschlossen. |
| order.refunded | Eine Reklamation endete mit einer Erstattung auf Ihr Guthaben (`refundedSale`, `amount`). |
| products.updated | Preis, Bestand oder Verfügbarkeit von Produkten haben sich geändert: `data.products` enthält pro Ereignis bis zu 100 Produkte im Summary-Format (`removed: true`, wenn entfernt). |
| catalog.changed | Mehr als 1000 Produkte haben sich auf einmal geändert: Führen Sie stattdessen den Cursor-Sync (`fields=summary`) aus, statt das Ereignis auszulesen. |
| product.updated | Nur manuell gepflegte Windows- und Office-Produkte (Plugin 1.0): `data.product` enthält das vollständige Produkt. |
| key.replaced | Ein Verkäufer hat einen Key ersetzt: `oldKeyId`, `newKeyId`; den neuen Key mit GET /orders/{id}/keys lesen. |
| balance.credited | Eine Aufladung wurde Ihrem Guthaben gutgeschrieben. |
| webhook.test | Wird von POST /webhooks/test oder der Dashboard-Schaltfläche gesendet. |
{
"id": "evt_4m2k9q7x1z8c3v5b6n0p",
"event": "order.completed",
"mode": "live",
"createdAt": "2026-10-01T16:20:31.512Z",
"data": { "id": "po_7f3k2m9q4x8z1c5v6b0n", "externalId": "shop-10045", "status": "completed", "total": 3.71, "...": "same object as GET /orders/{id}" }
}- Antworten Sie innerhalb von 8 s mit 2xx und erledigen Sie die Arbeit asynchron. Weiterleitungen werden nicht verfolgt.
- Fehlgeschlagene Zustellungen werden nach 10 s, 30 s, 1 Min., 5 Min., 15 Min., 30 Min., 1 Std., 2 Std., 4 Std., 6 Std. und 12 Std. wiederholt (~26 Std.).
- Ereignisse können in anderer Reihenfolge oder mehrfach eintreffen: Lesen Sie im Zweifel stets GET /orders/{id} oder den Cursor neu.
Fehler
Fehler verwenden HTTP-Statuscodes und einen stabilen code. Nennen Sie requestId, wenn Sie den Support kontaktieren.
{
"error": {
"code": "PRICE_CHANGED",
"message": "The price of prod-17298 is now 3.95 EUR, above your maxUnitPrice.",
"details": { "productId": "prod-17298", "currentPrice": 3.95 },
"requestId": "req_k3m9x2q8z7c1v4b6"
}
}| code | HTTP | Bedeutung | Was zu tun ist |
|---|---|---|---|
| UNAUTHORIZED | 401 | Schlüssel fehlt, ist ungültig, widerrufen oder abgelaufen. | Schlüssel prüfen oder im Dashboard einen neuen erstellen. |
| ACCOUNT_NOT_ACTIVE | 403 | Partnerkonto ausstehend, gesperrt oder abgelehnt. | Kontaktieren Sie uns. |
| IP_NOT_ALLOWED | 403 | Die IP-Adresse der Anfrage steht nicht auf Ihrer Allowlist. | IP unter Dashboard → Webhooks & Sicherheit hinzufügen. |
| INSUFFICIENT_SCOPE | 403 | Dem Schlüssel fehlt der Scope für diesen Endpunkt. | Einen Schlüssel mit dem passenden Scope erstellen. |
| NOT_FOUND | 404 | Unbekanntes Produkt, unbekannte Bestellung oder Route. | — |
| VALIDATION_ERROR | 400 | Ungültiger Body oder ungültige Parameter (details nennt jedes Feld). | Anfrage korrigieren; nicht unverändert wiederholen. |
| INSUFFICIENT_BALANCE | 402 | Guthaben zu niedrig. Es wurde nichts abgebucht. | Guthaben aufladen und erneut versuchen. |
| PRICE_CHANGED | 409 | Der aktuelle Stückpreis liegt über maxUnitPrice. Es wurde nichts abgebucht. | Preis aktualisieren (details.currentPrice) und erneut versuchen. |
| INVALID_COUPON | 400 | couponCode unbekannt oder Aktion beendet. Es wurde nichts abgebucht. | Code entfernen oder den aktuellen senden (MICROSOFT20). |
| OUT_OF_STOCK | 409 | Nicht genügend Einheiten verfügbar. Es wurde nichts abgebucht. | Später erneut versuchen oder das Produkt ausblenden. |
| PRODUCT_UNAVAILABLE | 409 | Produkt ist über die API nicht verkäuflich. | Aus Ihrem Shop entfernen. |
| DUPLICATE_EXTERNAL_ID | 409 | externalId bereits verwendet; details.orderId ist die bestehende Bestellung. | Stattdessen diese Bestellung abrufen. |
| IDEMPOTENCY_CONFLICT | 409 | Idempotency-Key mit anderem Body erneut verwendet. | Pro Bestellung einen neuen Schlüssel verwenden. |
| IDEMPOTENCY_IN_PROGRESS | 409 | Derselbe Idempotency-Key wird noch verarbeitet. | In einigen Sekunden erneut versuchen. |
| ORDER_LIMIT_EXCEEDED | 422 | Bestellsumme über Ihrem Limit pro Bestellung. | Bestellung aufteilen oder ein höheres Limit anfragen. |
| DAILY_LIMIT_EXCEEDED | 422 | Ausgabenlimit für 24 Stunden erreicht. | Warten oder ein höheres Limit anfragen. |
| RATE_LIMITED | 429 | Zu viele Anfragen. | Pausieren (details.retryAfterMs). |
| SERVICE_UNAVAILABLE | 503 | Verkauf vorübergehend nicht möglich. Es wurde nichts abgebucht. | Mit exponentiellem Backoff erneut versuchen. |
| INTERNAL_ERROR | 500 | Unerwarteter Fehler (mit requestId protokolliert). | Mit demselben Idempotency-Key erneut versuchen. |
Limits
| Limit | Wert |
|---|---|
| Anfragen pro Schlüssel | 20 / Sekunde und 600 / Minute |
| Bestellungen pro Konto | 120 / Minute |
| Key-Abrufe pro Konto | 300 / Minute |
| Positionen pro Bestellung / Einheiten pro Position | 10 / 9 |
| Bestellwert und Ausgaben in 24 Stunden | Pro Konto (siehe Dashboard → Übersicht); bitten Sie uns um Erhöhung |
| Seitengröße | 100 Produkte (fields=full), 500 (fields=summary), 100 Bestellungen |
| ids-Filter | 200 IDs |
Guthaben, Wallet und Aufladungen
Bestellungen werden Ihrem Prepaid-API-Guthaben und, falls dieses nicht reicht, dem Wallet Ihres Kontos belastet. GET /balance liefert das Guthaben des Schlüsselmodus; GET /me zeigt zusätzlich walletBalance und available. Laden Sie unter Dashboard → Guthaben auf (zum Beispiel 500 EUR, danach wird jede Bestellung automatisch belastet): Sie erhalten eine eindeutige Referenz für die Banküberweisung oder können online bezahlen; der Betrag wird gutgeschrieben, sobald er eintrifft (E-Mail + Webhook balance.credited). Jede Bewegung erscheint im Kontobuch.
Umsetzung mit einem KI-Assistenten
Maschinenlesbare Dokumentation: https://buycheapkeys.com/reseller-api.md (diese Seite als Markdown; /reseller-api.es.md auf Spanisch), die OpenAPI-3.1-Spezifikation https://buycheapkeys.com/partner-api/v1/openapi.json und https://buycheapkeys.com/llms.txt. Geben Sie diese URLs zusammen mit dem folgenden Prompt an Ihren KI-Assistenten.
Vollständige Referenzintegration (Node.js 18+, ohne Abhängigkeiten): https://buycheapkeys.com/developers/bck-partner-client.mjs: Katalog-Sync mit Cursor, sicheres Bestellen mit Wiederholungen und Idempotenz, Key-Abruf und ein Webhook-Empfänger mit Signaturprüfung.
curl -O https://buycheapkeys.com/developers/bck-partner-client.mjs
export BCK_API_KEY=bck_test_... # Sandbox-Schlüssel aus Dashboard → Partner → API-Schlüssel
node bck-partner-client.mjs balance
node bck-partner-client.mjs sync
node bck-partner-client.mjs order <productId> 1 <maxUnitPrice>- Invariante 1: Verkaufen Sie nur Produkte mit inStock=true und removed=false; synchronisieren Sie alle 1–5 Min. ab dem gespeicherten nextCursor neu.
- Invariante 2: eine Kundenbestellung = eine externalId = ein Idempotency-Key; verwenden Sie beide bei jeder Wiederholung erneut.
- Invariante 3: Senden Sie stets maxUnitPrice; fachliche 4xx-Fehler sind endgültig, und es wurde nichts abgebucht.
- Invariante 4: Wiederholen Sie nur Netzwerkfehler, 429, 5xx und IDEMPOTENCY_IN_PROGRESS, mit exponentiellem Backoff.
- Invariante 5: Bestellen Sie nach einem Timeout nie erneut: Wiederholen Sie dieselbe externalId und lesen Sie die Keys der bestehenden Bestellung.
- Invariante 6: Halten Sie den API-Schlüssel serverseitig; prüfen Sie Webhook-Signaturen; zeigen Sie Kunden deliveryType, Region und ausgeschlossene Länder an.
Go-live-Checkliste
- Halten Sie API-Schlüssel ausschließlich auf Ihrem Server (nie in Browsern oder Apps) und in einem Secret-Manager oder in Umgebungsvariablen.
- Verwenden Sie getrennte Schlüssel pro System und die minimal nötigen Scopes; aktivieren Sie die IP-Allowlist.
- Senden Sie stets maxUnitPrice und einen Idempotency-Key sowie storeUrl (oder den Header X-Store-Url) mit der URL Ihres Shops.
- Prüfen Sie bei jedem Webhook Signatur und Zeitstempel, bevor Sie ihm vertrauen.
- Testen Sie den gesamten Ablauf mit einem bck_test_-Schlüssel, wechseln Sie dann zu bck_live_ und laden Sie Ihr Guthaben auf.
- Rotieren Sie Schlüssel und Webhook-Secret bei Verdacht auf ein Leck und widerrufen Sie danach die alten.
