Verkäufer-Import-API

Verwalte deine Angebote und Bestände aus deinem eigenen System. Alle Anfragen nutzen HTTPS und JSON, Beträge sind in EUR.

https://buycheapkeys.com/partner-api/v1/seller

Verkäufer-Panel öffnen Als Verkäufer bewerben

Authentifizierung

Erstelle einen Schlüssel unter Verkäufer-Panel → API und sende ihn im Authorization-Header mit. Halte ihn geheim: Er gewährt vollen Zugriff auf deine Angebote und Keys.

Authorization: Bearer bcks_xxxxxxxxxxxx_…

Endpunkte

Methode	Pfad	Beschreibung
GET	/me	Dein Shop und die aktuellen Provisionsbedingungen.
GET	/products?search=&page=&limit=	Katalog durchsuchen. Gibt productId, Shop-Preis und besten Verkäuferpreis zurück.
GET	/offers?status=&page=&limit=	Deine Angebote mit Bestand, Kundenpreis und Information, ob du der Günstigste bist.
POST	/offers	Angebot für ein Produkt erstellen oder aktualisieren: { productId, price, status? }.
GET	/offers/{id}	Ein einzelnes Angebot.
PATCH	/offers/{id}	Preis und/oder Status ändern (active \| paused).
DELETE	/offers/{id}	Angebot ohne Bestand löschen (Angebote mit Verkäufen werden stattdessen pausiert).
POST	/offers/{id}/keys	Keys hochladen: { keys: ["…"] } (max. 1.000 pro Anfrage).
POST	/offers/{id}/withdraw	Unverkaufte Keys zurückziehen: { count? }. Gibt sie im Klartext zurück.
GET	/sales?page=&limit=	Deine Verkäufe, Einnahmen und Haltefristen.
GET	/balance	Ausstehendes und verfügbares Guthaben sowie anstehende Freigaben.
GET	/disputes?status=&page=&limit=	Kundenreklamationen zu deinen Verkäufen (open \| escalated \| resolved).
GET	/disputes/{id}	Eine Reklamation mit ihren Nachrichten.
POST	/disputes/{id}/messages	Dem Kunden antworten: { body }.
POST	/disputes/{id}/replace	Ersatz senden: { key } oder { fromStock: true }.
POST	/disputes/{id}/refund	Dem Kunden erstatten (der Verkauf wird storniert).

Preise

price ist der Betrag, den du pro Einheit erhältst. Der Kunde zahlt deinen Preis zuzüglich der Provision des Produkttyps (Keys, Konten und Geschenke, spezielle Abonnements), angegeben in /me und in jedem Angebot. Dein Angebot wird verkauft, wenn sein Kundenpreis der niedrigste verfügbare ist.

Beispiel: Produkt einstellen und Keys hochladen

# 1. Find the product
curl "https://buycheapkeys.com/partner-api/v1/seller/products?search=elden%20ring" \
  -H "Authorization: Bearer $BCK_SELLER_KEY"

# 2. Create (or update) your offer — price = what you receive per unit, EUR
curl -X POST "https://buycheapkeys.com/partner-api/v1/seller/offers" \
  -H "Authorization: Bearer $BCK_SELLER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"productId":"<productId>","price":24.90}'
# → { "created": true, "offer": { "id": "off_…", "customerPrice": 27.15, "stock": 0, … } }

# 3. Upload keys (max 1,000 per request; duplicates are skipped)
curl -X POST "https://buycheapkeys.com/partner-api/v1/seller/offers/off_…/keys" \
  -H "Authorization: Bearer $BCK_SELLER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["XXXXX-XXXXX-XXXXX","YYYYY-YYYYY-YYYYY"]}'
# → { "added": 2, "duplicates": 0, "stock": 2 }

# 4. Follow your sales and balance
curl "https://buycheapkeys.com/partner-api/v1/seller/sales" -H "Authorization: Bearer $BCK_SELLER_KEY"
curl "https://buycheapkeys.com/partner-api/v1/seller/balance" -H "Authorization: Bearer $BCK_SELLER_KEY"

Fehler und Limits

Fehler geben { error: { code, message, requestId } } mit einem 4xx/5xx-Status zurück. Limits: 20 Anfragen pro Sekunde und 600 pro Minute pro Schlüssel; 300 Key-Uploads pro Minute.