Dla sklepów internetowych i programistów
Sprzedawaj cały nasz katalog w swoim sklepie. Klucze dostarczamy my.
Gry, DLC, oprogramowanie, Windows i Office, karty podarunkowe i subskrypcje, przez API REST lub wtyczkę WordPress. Gdy klient zapłaci, klucz jest kupowany i dostarczany automatycznie, a koszt pobierany z Twojego salda przedpłaconego (np. doładowujesz 500 € i każde zamówienie jest pobierane samo) lub z Twojego Walleta.
2% taniej niż w naszym sklepie
Cena w API to cena z naszego sklepu minus 2%, dla każdego produktu w katalogu.
Bez opłaty serwisowej
Sklep dolicza opłatę przy kasie. API nie: płacisz cenę API i nic więcej.
Saldo przedpłacone lub Wallet
Doładowujesz raz, a każde zamówienie jest pobierane automatycznie. Jeśli saldo nie wystarczy, resztę pokrywa Wallet Twojego konta.
Działa z
- 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-…" } ] }Promocja trwa
20% zniżki na wszystkie produkty Microsoft
Dodaj kod do zamówień i płać 20% mniej za każdą licencję Windows, Office, Visio, Project i SQL Server. Bez opłat i minimum.
Pole API
"couponCode": "MICROSOFT20"W skrócie
BuyCheapKeys oferuje sklepom internetowym API REST i wtyczkę WordPress/WooCommerce do odsprzedaży całego katalogu: gier, DLC, oprogramowania, Windows i Office, kart podarunkowych i subskrypcji. Cena w API to cena ze sklepu minus 2%, bez opłaty serwisowej. Sklep importuje karty produktów w jednym lub kilku z 7 języków, utrzymuje cenę i stan magazynowy za pomocą kursora i zamawia klucz, gdy płaci jego własny klient. Klucz zwykle wraca w odpowiedzi na zamówienie (albo później webhookiem, jeśli zamówienie jest jeszcze w toku) i jest opłacany z salda przedpłaconego sklepu lub z jego Walleta. Dostępny jest darmowy sandbox.
Zaktualizowano:
Katalog, który możesz sprzedawać – na żywo
Te liczby pochodzą bezpośrednio z API i odświeżają się co kilka minut. Cen nie publikujemy na tej stronie: zobaczysz je ze swoim kluczem.
- 33 457
- produktów w magazynie
- 19
- platform z dostępnymi produktami
- 32 839
- gier i DLC w magazynie
- 498
- produktów programowych w magazynie
- 120
- subskrypcji w magazynie
Platformy z największą liczbą produktów
- Steam 25 960
- Xbox 4579
- PlayStation 1119
- GOG 426
- Epic Games 410
- Ubisoft Connect 330
- PC 305
- Microsoft 137
- EA App 120
- Rockstar 17
- Nintendo 13
- Mac 11
Część tego, co możesz dziś sprzedawać
Próbka okładek z katalogu. Każdy produkt ma swoją kartę: opis, kroki aktywacji, wymagania, zrzuty ekranu i region.

Grand Theft Auto V Enhanced EU PC Rockstar Digital Download (Rockstar) - Klucz Cyfrowy Europa
RockstarKlucz

ELDEN RING NIGHTREIGN (Steam) - Klucz Cyfrowy Stany Zjednoczone
SteamKlucz

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

EA Sports FC 24
EA AppKlucz

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
XboxKlucz

Hogwarts Legacy
XboxKlucz

Hogwarts Legacy Digital Deluxe Edition (PS5 Account)
PlayStationKonto

Stardew Valley (Steam Gift) (Steam) - Klucz Cyfrowy Globalny
SteamLink prezentowy

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

Microsoft Windows 11 Pro (PC) - Microsoft Key - GLOBAL (Microsoft) - Klucz Cyfrowy Globalny
MicrosoftKlucz

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

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

Microsoft Windows 10 / 11 Pro - 1 PC - OEM
MicrosoftKlucz
Jak to działa
- 01
Załóż konto
Złóż wniosek o konto partnera i utwórz klucz sandbox, aby wszystko wypróbować na fałszywych kluczach. W sandboxie nie przepływają żadne pieniądze.
- 02
Zaimportuj katalog
Odczytaj endpoint produktów z potrzebnymi filtrami (platforma, region, typ, cena) w jednym lub kilku językach, a cenę i stan magazynowy aktualizuj kursorem.
- 03
Klient płaci
Sprzedaż odbywa się w Twoim sklepie, po Twojej cenie i z Twoimi metodami płatności. Sklep wysyła jedno żądanie: POST /orders z produktem i najwyższą akceptowaną ceną.
- 04
Klucz zostaje dostarczony
Klucz zwykle wraca w tej samej odpowiedzi (jeśli zamówienie ma status "processing", przychodzi webhookiem lub przez GET /orders/{id}/keys), koszt jest pobierany z Twojego salda lub Walleta, a sklep wysyła go klientowi. Wtyczka WordPress robi to wszystko sama.
Filtry i formaty
Sprzedawaj tylko to, co pasuje do Twojego sklepu. Wszystkie filtry działają w endpoincie produktów i można je łączyć.
Format dostawy
Klucz do zrealizowania, link prezentowy (Steam Gift), konto lub link aktywacyjny. Każdy produkt podaje, który to rodzaj.
Platforma
Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft i inne.
Region
Region każdego klucza oraz dokładna lista krajów, w których nie można go aktywować.
Typ produktu
Gry, DLC, oprogramowanie, Windows i Office, karty podarunkowe i subskrypcje.
Cena
Cena minimalna i maksymalna, sortowanie według ceny, popularności, nazwy lub nowości.
Stan magazynowy i zmiany
Tylko to, co jest dostępne, albo tylko to, co zmieniło się od ostatniej synchronizacji.
Karty produktów w 7 językach
Nazwy, opisy i kroki aktywacji są dostępne po angielsku, hiszpańsku, niemiecku, francusku, włosku, portugalsku i polsku. Wybierz jeden język lub zaimportuj kilka naraz do wielojęzycznego sklepu z WPML lub Polylang. Każdy produkt podaje faktyczny język swojego tekstu.
- en
- es
- de
- fr
- it
- pt
- pl
Płać z salda przedpłaconego lub z Walleta
Doładuj saldo raz, na przykład 500 €, a każde zamówienie będzie pobierane automatycznie w chwili, gdy zapłaci klient. Jeśli saldo nie wystarczy, resztę pokrywa Wallet Twojego konta. Każda operacja trafia do Twojego rejestru, a webhook informuje o nadejściu doładowania.
Darmowy sandbox
Klucze sandbox (bck_test_) używają prawdziwego katalogu i cen, ale zwracają fałszywe klucze i testowe saldo. Nic nie jest pobierane i nie zużywa się prawdziwego zapasu, więc możesz najpierw zbudować i przetestować cały przepływ.
Podpisane webhooki
Otrzymuj powiadomienia, gdy zamówienie zostanie zrealizowane lub zwrócone, gdy klucz zostanie wymieniony i gdy zmienią się produkty (products.updated i catalog.changed). Każde zdarzenie jest podpisane HMAC-SHA256 i ponawiane przez około dobę.
Wtyczka WordPress i WooCommerce
Jeśli Twój sklep działa na WordPressie, nie musisz programować. Zainstaluj wtyczkę, wklej klucz API i wybierz marżę.
Wersja 1.1.0 · bezpłatna · WordPress + WooCommerce
Pobierz wtyczkę- Importuje każdy produkt z kartą, krokami aktywacji i wymaganiami
- Automatycznie aktualizuje cenę i stan magazynowy, z Twoją marżą i zaokrągleniem
- Sprawdza koszyk przed płatnością i blokuje produkty, których nie da się dostarczyć
- Kupuje klucz, gdy zamówienie jest opłacone, i wysyła go e-mailem klientowi
- Pokazuje klucz na stronie zamówienia i w Moim koncie, przechowywany w postaci zaszyfrowanej
- Sama ponawia próbę w razie błędu i ostrzega Cię e-mailem
Dokumentacja API
Wszystko, czego potrzebujesz do integracji: uwierzytelnianie, synchronizacja katalogu, filtry, zamówienia, dostawa kluczy, reklamacje, webhooki, błędy i limity.
Czytaj dokumentację API# 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 } ] }'Platformy
Działa z Shopify, Shopware, Magento, PrestaShop i każdą inną platformą sklepową
Jeśli Twoja platforma potrafi wysłać żądanie po opłaceniu zamówienia, może sprzedawać nasz katalog. Dotyczy to listy poniżej, na której jest ponad 120 nazw, oraz każdego sklepu napisanego przez Ciebie. Jedyna wtyczka, którą dziś oferujemy, jest do WooCommerce. W pozostałych przypadkach łączysz się przez API REST.
Jak połączyć dowolną platformę
- 01
Katalog
Odczytaj endpoint produktów, aby zaimportować nazwy, opisy, kroki aktywacji i okładki oraz aktualizować cenę i stan.
- 02
Opłacone zamówienie
Twoja platforma uruchamia zdarzenie opłaconego zamówienia: webhook, hook, przepływ albo zadanie cykliczne. To zdarzenie wywołuje POST /orders z produktem i najwyższą akceptowaną ceną.
- 03
Dostawa
Klucz jest w odpowiedzi. Sklep wysyła go klientowi e-mailem i pokazuje w zamówieniu. Jeśli klucz nie jest jeszcze gotowy, webhook order.completed powiadomi Cię, gdy będzie.
Najczęstsze drogi według platformy
Każda platforma reaguje na opłacone zamówienie na swój sposób. To drogi, z których korzysta większość sklepów. Twój programista albo narzędzie takie jak Zapier lub Make skonfiguruje każdą z nich.
- WooCommerceWtyczka
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
Wszystkie platformy według typu
Kreatory sklepów w chmurze
- 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 i własny hosting
- 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
Commerce dla firm i headless
- 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
Oprogramowanie dla marketplace'ów
- Dokan
- WCFM Marketplace
- WC Vendors
- CS-Cart Multi-Vendor
- Mirakl
- Sharetribe
- Arcadier
- Marketplacer
- Yo!Kart
Sprzedaż produktów cyfrowych
- Easy Digital Downloads
- Gumroad
- Lemon Squeezy
- Paddle
- FastSpring
- Sellfy
- SendOwl
- Payhip
- Podia
- Sellix
ERP i pakiety biznesowe
- Odoo eCommerce
- ERPNext
- NetSuite SuiteCommerce
- Microsoft Dynamics 365 Commerce
- plentymarkets
Platformy regionalne
- 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
Narzędzia do automatyzacji
- Zapier
- Make
- n8n
- Pipedream
- Microsoft Power Automate
Sklepy napisane na zamówienie
- Laravel
- Symfony
- Django
- Ruby on Rails
- Node.js
- Next.js
- Nuxt
- ASP.NET
- Spring Boot
- Go
Nie ma Twojej platformy na liście?
Jeśli potrafi wywołać adres URL po potwierdzeniu płatności, działa. Napisz na partners@buycheapkeys.com, a wskażemy Ci właściwy wyzwalacz.
Najczęstsze pytania
Jakie jest najlepsze API do odsprzedaży kluczy do gier?
Ile kosztuje API dla resellerów BuyCheapKeys?
Jak sprzedawać klucze do gier w sklepie WooCommerce?
Czy mogę używać tego z Shopify, Magento, Shopware, PrestaShop lub własnym sklepem?
Jakie produkty mogę sprzedawać?
Jak dostarczane są klucze?
Jak płacę za zamówienia?
W jakich językach są dostępne karty produktów?
Jak utrzymać synchronizację cen i stanów magazynowych?
Czy mogę przetestować API bez płacenia?
Co się stanie, jeśli klucz nie działa?
Zacznij sprzedawać cały katalog
Załóż konto partnera, przetestuj w sandboxie i przejdź na produkcję, kiedy będziesz gotów.
BuyCheapKeys jest niezależnym sprzedawcą. Nazwy platform i marek należą do ich właścicieli i służą wyłącznie do opisu zgodności. Sprawdź, czy typ licencji i region odpowiadają Twoim klientom i prawu Twojego kraju.
Dokumentacja API
Spis treści
- Przegląd
- Uwierzytelnianie i środowiska
- Szybki start
- Katalog i synchronizacja
- Filtry, sortowanie i języki
- Pola produktu
- Zamówienia
- Dostawa kluczy
- Reklamacje i zwroty
- Karty podarunkowe BuyCheapKeys hurtowo
- Webhooki
- Błędy
- Limity
- Saldo, Portfel i doładowania
- Wdrożenie z asystentem AI
- Lista kontrolna przed uruchomieniem
API REST/JSON do sprzedaży całego katalogu BuyCheapKeys na własnej stronie. Cena API to cena ze sklepu pomniejszona o 2 %, bez opłaty serwisowej. Każde zamówienie jest opłacane z Twojego przedpłaconego salda (lub Portfela), a klucze wracają w tej samej odpowiedzi.
Przegląd
Adres bazowy: https://buycheapkeys.com/partner-api/v1. Wszystkie żądania i odpowiedzi są w formacie JSON (UTF-8). Ceny podawane są w EUR z dwoma miejscami po przecinku i nie zawierają VAT. Daty mają format ISO 8601 w UTC.
- Katalog: cały katalog sklepu (gry, DLC, oprogramowanie, Windows i Office, karty podarunkowe, subskrypcje) z kartami produktów w 7 językach (en, es, de, fr, it, pt, pl).
- Cena: cena API = cena w sklepie minus 2 % i bez opłaty serwisowej (sklep pobiera opłatę przy kasie, API nie).
GET /mezwracadiscountPercentiserviceFee: 0. - Zamówienia: do 10 pozycji x 9 sztuk w jednym żądaniu; całość jest pobierana jednorazowo z przedpłaconego salda, a jeśli to nie wystarczy, z Portfela.
- Dostawa: klucze znajdują się w odpowiedzi na zamówienie i można je pobrać ponownie przez GET /orders/{id}/keys.
- Reklamacje: wadliwy klucz można reklamować przez 14 dni w panelu partnera; klucz zastępczy trafia do zamówienia automatycznie, a zwrot wraca na Twoje saldo.
WordPress/WooCommerce? Użyj wtyczki (zobacz sekcję Wtyczka powyżej): importuje katalog, utrzymuje cenę i stan magazynowy w synchronizacji i dostarcza klucze bez pisania kodu.
Uwierzytelnianie i środowiska
Klucze tworzysz w Panel → Partner → Klucze API. Klucz jest wyświetlany tylko raz; przechowujemy wyłącznie jego hash. Wysyłaj go w nagłówku Authorization (akceptowany jest też X-Api-Key).
curl https://buycheapkeys.com/partner-api/v1/ping \
-H "Authorization: Bearer bck_test_xxxxxxxxxxxx_..."| Prefiks klucza | Tryb | Zachowanie |
|---|---|---|
| bck_test_ | Sandbox | Prawdziwy katalog i ceny, osobne saldo testowe (można je zresetować), fałszywe klucze typu TEST-AB12C-…, żadne pieniądze nie są przesuwane. Webhooki są wysyłane z mode: test. |
| bck_live_ | Produkcja | Prawdziwe zakupy obciążające Twoje saldo produkcyjne (oraz Portfel). |
| Zakres | Pozwala na |
|---|---|
| catalog:read | GET /products, /products/{id}, /meta, /me, /ping, /gift-cards |
| webhooks:write | PUT, GET i DELETE /webhook (rejestracja lub usunięcie adresu webhooka) |
| 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 |
Opcjonalna lista dozwolonych adresów IP (IPv4/IPv6, CIDR) dla konta. Klucze nie wygasają, dopóki ich nie unieważnisz; aby je rotować, utwórz nowy klucz i unieważnij stary. GET /public/catalog nie wymaga klucza.
Szybki start
1) Utwórz klucz bck_test_. 2) Pobierz listę produktów. 3) Złóż zamówienie: wraca zrealizowane, razem z kluczami. 4) W dowolnym momencie pobierz klucze ponownie przez GET /orders/{id}/keys. Konta, które czekają jeszcze na akceptację, mogą korzystać z kluczy sandbox.
curl "https://buycheapkeys.com/partner-api/v1/products?lang=en&limit=100&inStock=true" \n -H "Authorization: Bearer $BCK_API_KEY"Katalog i synchronizacja
GET /products zwraca produkty posortowane według updatedAt (następnie id). updatedAt zmienia się tylko wtedy, gdy zmieni się coś istotnego (cena, stan, nazwa, region, teksty, obrazy). Synchronizuj z kursorem: każda odpowiedź zawiera nextCursor i hasMore; przekazuj nextCursor z powrotem jako ?cursor=, aż hasMore będzie false, i zachowaj go na następne uruchomienie. Kursor nigdy nie pomija ani nie powtarza produktów, nawet gdy wiele z nich ma ten sam znacznik czasu (kursor zawsze podąża za updatedAt; sort działa tylko przy przeglądaniu stronami).
Dwa formaty: fields=full (domyślny, do 100 produktów na stronę) to pełna karta produktu; fields=summary (do 500 na stronę) zwraca tylko id, price, shopPrice, currency, inStock, qty, updatedAt i removed, idealny do aktualizowania ceny i stanu co minutę.
# 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"- Zalecane: jeden pełny import (fields=full, w językach Twojego sklepu), a potem co 1–5 minut
fields=summaryod zapisanegonextCursor, zawsze zincludeRemoved=true. - Dostępność: jeśli sklep nie może sprzedać produktu (brak stanu, wyłączony stan, koszt powyżej naszego limitu), w mniej niż minutę pojawia się on jako
inStock: false, qty: 0; produkt ukryty lub usunięty maremoved: true. Nigdy ich nie sprzedawaj. - Zmiany w katalogu są ogłaszane webhookiem (
products.updated,catalog.changed), więc odpytywanie może być rzadkie. GET /public/catalog?lang=(bez klucza, cache 10 minut) zwraca aktualne liczby i kilka wyróżnionych okładek na Twoją własną stronę docelową.
Filtry, sortowanie i języki
lang (en, es, de, fr, it, pt, pl; domyślnie en) wybiera język nazw i opisów. Każdy produkt ma pole language z faktycznym językiem tekstu (en, gdy brakuje tłumaczenia). Jeden język lub kilka: wywołaj API raz dla każdego języka albo zaimportuj wszystkie siedem dla sklepów wielojęzycznych (WPML/Polylang). Listy przyjmują wartości oddzielone przecinkami.
| Parametr | Wartości / znaczenie |
|---|---|
| platform | Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft, … (zobacz /meta) |
| region | Etykieta regionu (Global, Europe, …); zobacz /meta |
| productType | game, dlc, software, gift-card, gift, subscription, game-point |
| deliveryType | key, gift (link Steam Gift), account, link (link aktywacyjny) |
| category | game, dlc, software, microsoft, gift-card, gift, subscription |
| genre | Nazwa gatunku (zobacz /meta) |
| minPrice / maxPrice | EUR, cena API |
| inStock | true, aby wyświetlić tylko to, co można sprzedać teraz |
| search | Wszystkie słowa, dopasowywane do nazwy i przetłumaczonego tytułu |
| ids | Do 200 identyfikatorów produktów |
| updatedSince / includeRemoved | Zmiany od podanej daty; uwzględnij wycofane produkty |
| sort | updated, popularity, name, price_asc, price_desc, newest (ze stronami; kursor synchronizacji zawsze podąża za updatedAt) |
| fields / limit / cursor / page | full lub summary; do 100 (full) albo 500 (summary); cursor do synchronizacji; page do przeglądania |
# 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 zwraca fasety wraz z liczbami i stanem magazynowym (platformy, regiony, typy produktów, gatunki, języki, zakres cen, wartości sortowania), dzięki czemu możesz zbudować własne filtry.
Pola produktu
{
"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
}| Pole | Znaczenie |
|---|---|
| price | Twoja cena jednostkowa w EUR: cena w sklepie minus 2 %. Sprawdzana ponownie na żywo przy zamówieniu. |
| shopPrice / discountPercent | Cena w sklepie i Twój rabat (2). |
| rrp | Rzeczywista cena detaliczna, gdy jest wyższa niż cena API; w przeciwnym razie null. |
| deliveryType | key = kod do wykorzystania · gift = link Steam Gift · account = dane logowania · link = link aktywacyjny. Poinformuj klienta, co kupuje. |
| region / activation | Etykieta regionu oraz dokładna lista ISO krajów, w których aktywacja NIE jest możliwa. |
| productType / category / edition / licenseType | Klasyfikacja produktu. |
| language | Język tekstów w tej odpowiedzi. |
| shortDescription / description / descriptionHtml / features | Teksty. descriptionHtml to czysty HTML bez linków i obrazów. |
| activationSteps / activationDetails / systemRequirements | Instrukcja aktywacji i wymagania. |
| languages / genres / developer / publisher / releaseDate / ageRating | Dane o grze. |
| coverImage / screenshots / videos | Obrazy z naszego CDN (zapisuj je w pamięci podręcznej u siebie) i filmy z YouTube. |
| qty | Liczba sztuk na stanie (maksymalnie 999). |
| url | Publiczna strona produktu w sklepie. |
Zamówienia
POST /orders z externalId (Twój unikalny identyfikator) i items (productId, qty 1–9, maxUnitPrice). Dla każdej pozycji sprawdzamy aktualną cenę: jeśli jest wyższa niż maxUnitPrice, całe zamówienie zostaje odrzucone z PRICE_CHANGED i nic nie jest pobierane. Jeśli jest niższa, płacisz niższą cenę. Sprzedaje najtańsze źródło z dostępnym stanem, tak jak w sklepie.
Zalecane: wysyłaj storeUrl (adres Twojego sklepu, w którym sprzedawany jest produkt) w treści POST /orders albo nagłówek X-Store-Url w dowolnym wywołaniu. Jest opcjonalny; wtyczka WordPress wysyła adres Twojej strony automatycznie.
Kod promocyjny: dodaj couponCode: MICROSOFT20, aby płacić 20 % mniej za produkty Microsoft (Windows, Office, Visio, Project, SQL Server) przez czas trwania promocji. Jest stosowany tylko do tych pozycji; nieznany kod lub zakończona promocja zwraca INVALID_COUPON i nic nie jest pobierane.
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
}- Wyślij nagłówek
Idempotency-Key(8–100 znaków) i użyj go ponownie przy ponowieniu: otrzymasz pierwotną odpowiedź i nigdy nie zostaniesz obciążony dwa razy.externalIdjest również unikalny w obrębie konta. - Zamówienie jest realizowane w tym samym żądaniu (
?wait=20czeka do 20 s): odpowiedź ma statuscompletedi tablicękeys. Powtórzone żądanie zwraca zamówienie bez kluczy i zkeysOmitted: true: pobierz je przez GET /orders/{id}/keys. - Brak stanu lub zbyt niskie saldo: nic nie jest pobierane i żaden klucz nie jest zużyty (
OUT_OF_STOCK,INSUFFICIENT_BALANCE).maxUnitPricejest górnym limitem dla każdego klucza. - Jeśli żądanie przekroczy limit czasu, wyślij je ponownie z tym samym externalId: otrzymasz
DUPLICATE_EXTERNAL_IDz id zamówienia i będziesz mógł pobrać jego klucze.
| Status | Znaczenie |
|---|---|
| completed | Wszystkie sztuki dostarczone. Klucze są w odpowiedzi. |
| partially_refunded | Część kluczy została zwrócona na Twoje saldo po reklamacjach. |
| refunded | Wszystkie klucze z zamówienia zostały zwrócone na Twoje saldo. |
Dostawa kluczy
GET /orders/{id}/keys zwraca każdą dostarczoną sztukę: value zawiera kod, adres Steam Gift, dane logowania do konta lub link aktywacyjny, zależnie od deliveryType. contentType to text/plain lub typ obrazu (wtedy value jest w base64).
Przechowuj klucze w postaci zaszyfrowanej i pokazuj je wyłącznie kupującemu. Pierwsze pobranie kluczy z każdego zamówienia jest rejestrowane po naszej stronie jako dowód dostawy.
Reklamacje i zwroty
Wadliwy klucz można reklamować przez 14 dni. Otwórz zamówienie w Panel → Zamówienia (zamówienia API), wybierz klucz, napisz do sprzedawcy i dołącz zrzuty ekranu z błędem aktywacji. Sprzedawca może przesłać klucz zastępczy (pojawia się w Twoim zamówieniu i otrzymujesz webhook key.replaced) albo zwrócić pieniądze za klucz (cena jednorazowo wraca na Twoje saldo API i otrzymujesz order.refunded). Jeśli się nie zgadzasz, eskaluj sprawę, a BuyCheapKeys podejmie decyzję.
Przed sprzedażą sprawdź region, excludedCountries i rodzaj licencji oraz pokaż je klientowi. Zwrot na Twoje saldo nie oznacza zwrotu dla Twojego klienta: to Twoja decyzja.
Karty podarunkowe BuyCheapKeys hurtowo
Oprócz kart podarunkowych innych marek (są to produkty katalogu, productType=gift-card) możesz kupować nasze własne karty podarunkowe do odsprzedaży: kody BCK-XXXX-XXXX-XXXX-XXXX, które dodają swoją wartość do Portfela BuyCheapKeys osoby, która zrealizuje je na buycheapkeys.com/wallet. GET /gift-cards zwraca dostępne nominały, rabaty ilościowe, maksima na zamówienie i saldo Twojego Portfela. POST /gift-cards/orders kupuje N kart o jednym nominale i od razu zwraca kody; GET /gift-cards/orders/{id} pokazuje je ponownie wraz ze statusem każdego kodu.
curl https://buycheapkeys.com/partner-api/v1/gift-cards \
-H "Authorization: Bearer $BCK_API_KEY"- Płatność wyłącznie z Portfela BuyCheapKeys konta Twojego sklepu (doładuj go na buycheapkeys.com/wallet), nie z salda API. Cena = wartość nominalna minus rabat ilościowy dla danej liczby sztuk.
- Nominały, rabaty i maksima mogą się zmieniać: wyślij
maxTotal, aby odrzucić wyższą kwotę (PRICE_CHANGED, nic nie jest pobierane).Idempotency-Keyi unikalnyexternalIddziałają tak samo jak przy zamówieniach. - Sprzedaż wstrzymana:
PRODUCT_UNAVAILABLE(409). Nominał nie jest sprzedawany lub ilość poza zakresem:VALIDATION_ERROR. Zamówienie zbyt duże:ORDER_LIMIT_EXCEEDED. Zbyt niskie saldo Portfela:INSUFFICIENT_BALANCE(402). - Klucze sandbox zwracają fałszywe kody
BCK-TEST-…, których nie można zrealizować i które nic nie kosztują. - Sprzedane kody są ostateczne. Każdy kod ma datę ważności (
expiresAt) i limity realizacji na konto. Kod zablokowany przez nas z powodu oszustwa nie jest już wyświetlany (code: null, statusblocked). Przechowuj kody w postaci zaszyfrowanej.
Webhooki
Ustaw adres https w Panel → Webhooki (lub przez PUT /webhook); otrzymasz sekret podpisu (whsec_…). Każde zdarzenie to POST z nagłówkami X-BCK-Event, X-BCK-Delivery (unikalny id: usuwaj duplikaty na jego podstawie) oraz X-BCK-Signature: t=<unix>,v1=<hex>, gdzie v1 = HMAC-SHA256(secret, t + "." + rawBody).
| Zdarzenie | Kiedy |
|---|---|
| order.completed | Zamówienie zostało zrealizowane. |
| order.refunded | Reklamacja zakończyła się zwrotem na Twoje saldo (`refundedSale`, `amount`). |
| products.updated | Zmieniła się cena, stan lub dostępność produktów: `data.products` zawiera do 100 produktów w formacie summary na zdarzenie (`removed: true` dla wycofanych). |
| catalog.changed | Zmieniło się naraz ponad 1000 produktów: zamiast czytać zdarzenie, uruchom synchronizację z kursorem (`fields=summary`). |
| product.updated | Tylko ręcznie opracowane produkty Windows i Office (wtyczka 1.0): `data.product` zawiera pełny produkt. |
| key.replaced | Sprzedawca zastąpił klucz: `oldKeyId`, `newKeyId`; pobierz nowy klucz przez GET /orders/{id}/keys. |
| balance.credited | Doładowanie zostało dodane do Twojego salda. |
| webhook.test | Wysyłane przez POST /webhooks/test lub przycisk w panelu. |
{
"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}" }
}- Odpowiedz kodem 2xx w ciągu 8 s, a resztę pracy wykonaj asynchronicznie. Przekierowania nie są śledzone.
- Nieudane dostawy są ponawiane po 10 s, 30 s, 1 min, 5 min, 15 min, 30 min, 1 h, 2 h, 4 h, 6 h i 12 h (~26 h).
- Zdarzenia mogą przychodzić w innej kolejności lub wielokrotnie: w razie wątpliwości zawsze pobierz ponownie GET /orders/{id} lub użyj kursora.
Błędy
Błędy korzystają z kodów statusu HTTP i stałego code. Przy kontakcie z pomocą techniczną podaj requestId.
{
"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 | Znaczenie | Co zrobić |
|---|---|---|---|
| UNAUTHORIZED | 401 | Missing, invalid, revoked or expired key. | Check the key; create a new one in the dashboard. |
| ACCOUNT_NOT_ACTIVE | 403 | Partner account pending, suspended or rejected. | Contact us. |
| IP_NOT_ALLOWED | 403 | Request IP not in your allowlist. | Add the IP in Dashboard → Webhooks & security. |
| INSUFFICIENT_SCOPE | 403 | The key lacks the scope for this endpoint. | Create a key with the scope. |
| NOT_FOUND | 404 | Unknown product, order or route. | — |
| VALIDATION_ERROR | 400 | Invalid body or parameters (details lists each field). | Fix the request; do not retry as is. |
| INSUFFICIENT_BALANCE | 402 | Balance too low. Nothing was charged. | Top up and retry. |
| PRICE_CHANGED | 409 | Live unit price above maxUnitPrice. Nothing was charged. | Re-price (details.currentPrice) and retry. |
| INVALID_COUPON | 400 | couponCode unknown, or the promotion has ended. Nothing was charged. | Remove the code or send the active one (MICROSOFT20). |
| OUT_OF_STOCK | 409 | Not enough units available. Nothing was charged. | Retry later or hide the product. |
| PRODUCT_UNAVAILABLE | 409 | Product not sellable through the API. | Remove it from your shop. |
| DUPLICATE_EXTERNAL_ID | 409 | externalId already used; details.orderId is the existing order. | Fetch that order instead. |
| IDEMPOTENCY_CONFLICT | 409 | Idempotency-Key reused with a different body. | Use a new key per order. |
| IDEMPOTENCY_IN_PROGRESS | 409 | Same Idempotency-Key still being processed. | Retry in a few seconds. |
| ORDER_LIMIT_EXCEEDED | 422 | Order total above your per-order limit. | Split the order or ask for a higher limit. |
| DAILY_LIMIT_EXCEEDED | 422 | 24-hour spend limit reached. | Wait or ask for a higher limit. |
| RATE_LIMITED | 429 | Too many requests. | Back off (details.retryAfterMs). |
| SERVICE_UNAVAILABLE | 503 | Temporarily unable to sell. Nothing was charged. | Retry with exponential backoff. |
| INTERNAL_ERROR | 500 | Unexpected error (logged with requestId). | Retry with the same Idempotency-Key. |
Limity
| Limit | Wartość |
|---|---|
| Żądania na klucz | 20 / sekundę i 600 / minutę |
| Zamówienia na konto | 120 / minutę |
| Pobrania kluczy na konto | 300 / minutę |
| Pozycje na zamówienie / sztuki na pozycję | 10 / 9 |
| Wartość zamówienia i wydatki z 24 godzin | Ustalane dla konta (zobacz Panel → Przegląd); poproś nas o podniesienie |
| Rozmiar strony | 100 produktów (fields=full), 500 (fields=summary), 100 zamówień |
| Filtr ids | 200 identyfikatorów |
Saldo, Portfel i doładowania
Zamówienia obciążają Twoje przedpłacone saldo API, a jeśli to nie wystarczy, Portfel Twojego konta. GET /balance zwraca saldo dla trybu danego klucza; GET /me pokazuje także walletBalance i available. Doładuj konto w Panel → Saldo (na przykład 500 EUR, a potem każde zamówienie jest pobierane automatycznie): otrzymasz unikalny numer referencyjny przelewu bankowego albo możesz zapłacić online; kwota zostaje zaksięgowana po wpłynięciu (e-mail + webhook balance.credited). Każda operacja widnieje w rejestrze.
Wdrożenie z asystentem AI
Dokumentacja do odczytu maszynowego: https://buycheapkeys.com/reseller-api.md (ta strona w Markdown; /reseller-api.es.md po hiszpańsku), specyfikacja OpenAPI 3.1 https://buycheapkeys.com/partner-api/v1/openapi.json oraz https://buycheapkeys.com/llms.txt. Podaj te adresy swojemu asystentowi AI razem z poniższym promptem.
Kompletna integracja referencyjna (Node.js 18+, bez zależności): https://buycheapkeys.com/developers/bck-partner-client.mjs: synchronizacja katalogu z kursorem, bezpieczne składanie zamówień z ponowieniami i idempotencją, pobieranie kluczy oraz odbiornik webhooków z weryfikacją podpisu.
curl -O https://buycheapkeys.com/developers/bck-partner-client.mjs
export BCK_API_KEY=bck_test_... # klucz sandbox z Panel → Partner → Klucze API
node bck-partner-client.mjs balance
node bck-partner-client.mjs sync
node bck-partner-client.mjs order <productId> 1 <maxUnitPrice>- Niezmiennik 1: sprzedawaj tylko produkty z inStock=true i removed=false; synchronizuj ponownie co 1–5 min od zapisanego nextCursor.
- Niezmiennik 2: jedno zamówienie klienta = jeden externalId = jeden Idempotency-Key; używaj ich ponownie przy każdym ponowieniu.
- Niezmiennik 3: zawsze wysyłaj maxUnitPrice; błędy biznesowe 4xx są ostateczne i nic nie zostało pobrane.
- Niezmiennik 4: ponawiaj tylko błędy sieci, 429, 5xx i IDEMPOTENCY_IN_PROGRESS, z wykładniczym backoffem.
- Niezmiennik 5: nigdy nie składaj zamówienia ponownie po przekroczeniu limitu czasu: powtórz ten sam externalId i pobierz klucze istniejącego zamówienia.
- Niezmiennik 6: trzymaj klucz API po stronie serwera; weryfikuj podpisy webhooków; pokazuj klientom deliveryType, region i wykluczone kraje.
Lista kontrolna przed uruchomieniem
- Trzymaj klucze API wyłącznie na swoim serwerze (nigdy w przeglądarkach ani aplikacjach) oraz w menedżerze sekretów lub zmiennych środowiskowych.
- Używaj osobnych kluczy dla każdego systemu i minimalnych zakresów; włącz listę dozwolonych adresów IP.
- Zawsze wysyłaj maxUnitPrice i Idempotency-Key oraz wysyłaj storeUrl (lub nagłówek X-Store-Url) z adresem swojego sklepu.
- Zweryfikuj podpis i znacznik czasu każdego webhooka, zanim mu zaufasz.
- Przetestuj cały przepływ kluczem bck_test_, następnie przełącz się na bck_live_ i doładuj saldo.
- Zrotuj klucze i sekret webhooka, jeśli podejrzewasz wyciek, a następnie unieważnij stare.
