-20%

20% zniżki na Windows i Office

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
REST · JSON
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-…" } ] }
-20%

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

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

    RockstarKlucz

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

    ELDEN RING NIGHTREIGN (Steam) - Klucz Cyfrowy Stany Zjednoczone

    SteamKlucz

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

    EA SPORTS FC 26 PS4/PS5 (PS4 Account)

    PlayStationKonto

  • EA Sports FC 24

    EA Sports FC 24

    EA AppKlucz

  • Minecraft Legends Deluxe Edition (Xbox Account)

    Minecraft Legends Deluxe Edition (Xbox Account)

    XboxKonto

  • Baldur's Gate 3 (Steam Account)

    Baldur's Gate 3 (Steam Account)

    SteamKonto

  • Forza Horizon 4 Ultimate Edition (Xbox Account)

    Forza Horizon 4 Ultimate Edition (Xbox Account)

    XboxKonto

  • Call of Duty: Vanguard

    Call of Duty: Vanguard

    XboxKlucz

Jak to działa

  1. 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.

  2. 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.

  3. 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ą.

  4. 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ę

  1. 01

    Katalog

    Odczytaj endpoint produktów, aby zaimportować nazwy, opisy, kroki aktywacji i okładki oraz aktualizować cenę i stan.

  2. 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ą.

  3. 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.

Utwórz konto partnera

Najczęstsze pytania

Jakie jest najlepsze API do odsprzedaży kluczy do gier?
To zależy od Twoich potrzeb, więc oto, co oferuje API dla resellerów BuyCheapKeys: cały katalog naszego sklepu (gry, DLC, oprogramowanie, Windows i Office, karty podarunkowe, subskrypcje) w cenie sklepu minus 2%, bez opłaty serwisowej, karty produktów w 7 językach, filtry według platformy, regionu, typu i ceny, kursor do synchronizacji przyrostowej, podpisane webhooki, darmowy sandbox i wtyczkę WordPress/WooCommerce. Klucze zwykle wracają w tej samej odpowiedzi na zamówienie; jeśli produkt trzeba kupić u hurtowego źródła, zamówienie ma status "processing", a klucze przychodzą webhookiem.
Ile kosztuje API dla resellerów BuyCheapKeys?
Korzystanie z API nie wiąże się z opłatą serwisową. Płacisz cenę API za każdy kupiony klucz, czyli cenę naszego sklepu minus 2%, z salda przedpłaconego lub Walleta. Doładowania online zawierają prowizję bramki płatniczej.
Jak sprzedawać klucze do gier w sklepie WooCommerce?
Zainstaluj bezpłatną wtyczkę BuyCheapKeys dla WooCommerce (wersja 1.1.0), wklej klucz API i ustaw marżę. Importuje produkty, aktualizuje cenę i stan magazynowy, kupuje klucz po opłaceniu zamówienia i wysyła go e-mailem klientowi.
Czy mogę używać tego z Shopify, Magento, Shopware, PrestaShop lub własnym sklepem?
Tak, przez API REST. Zdarzenie opłaconego zamówienia Twojej platformy (webhook, hook lub zaplanowane zadanie) wywołuje POST /orders, a sklep przekazuje klucz. Dziś tylko WooCommerce ma gotową wtyczkę. Dokumentacja zawiera klienta referencyjnego w Node.js bez zależności.
Jakie produkty mogę sprzedawać?
Cały dostępny katalog sklepu: gry i DLC na Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App i Nintendo, oprogramowanie, licencje Windows i Office, karty podarunkowe i subskrypcje. Liczby na żywo znajdziesz na górze tej strony.
Jak dostarczane są klucze?
Zwykle w odpowiedzi na żądanie zamówienia, dzięki czemu sklep może od razu je wyświetlić i wysłać klientowi e-mailem. Gdy produkt trzeba kupić u hurtowego źródła, może to potrwać kilka sekund lub minut: zamówienie ma wtedy status "processing", a klucze przychodzą webhookiem (order.completed) lub przez GET /orders/{id}/keys (możesz dodać ?wait=25, aby na nie poczekać). Każdy produkt podaje typ dostawy: klucz do zrealizowania, link Steam Gift, konto lub link aktywacyjny. Klucze można odczytać ponownie przez endpoint kluczy.
Jak płacę za zamówienia?
Z przedpłaconego salda API. Na przykład doładowujesz 500 € i każde zamówienie jest pobierane automatycznie w chwili złożenia. Jeśli saldo nie wystarczy, resztę pokrywa Wallet Twojego konta. Jeśli nie wystarczy żadne z nich, zamówienie zostanie odrzucone i nic nie zostanie pobrane.
W jakich językach są dostępne karty produktów?
Po angielsku, hiszpańsku, niemiecku, francusku, włosku, portugalsku i polsku. Użyj parametru lang, aby wybrać jeden, albo zaimportuj kilka do sklepu wielojęzycznego. Jeśli brakuje tłumaczenia, zwracany jest tekst angielski, a produkt to zaznacza.
Jak utrzymać synchronizację cen i stanów magazynowych?
Wykonaj raz pełny import, a potem co kilka minut wywołuj endpoint produktów z fields=summary i zapisanym kursorem: zwraca tylko to, co się zmieniło (cena, stan, usunięte). Webhooki (products.updated i catalog.changed) również informują, kiedy synchronizować.
Czy mogę przetestować API bez płacenia?
Tak. Klucze sandbox zwracają fałszywe klucze i używają testowego salda. Katalog i ceny są prawdziwe, nic nie jest pobierane i nie zużywa się prawdziwego zapasu.
Co się stanie, jeśli klucz nie działa?
Klucze od sprzedawców z marketplace można reklamować przez 14 dni z panelu partnera, z wiadomościami i zrzutami ekranu. Jeśli reklamacja zostanie przyjęta, dostajesz klucz zastępczy w tym samym zamówieniu albo zwrot ceny na saldo. Pozostałymi kluczami zajmuje się wsparcie w ramach gwarancji.

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

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.

Adres bazowy: https://buycheapkeys.com/partner-api/v1 Pobierz specyfikację OpenAPI 3.1

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 /me zwraca discountPercent i serviceFee: 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 kluczaTrybZachowanie
bck_test_SandboxPrawdziwy 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_ProdukcjaPrawdziwe zakupy obciążające Twoje saldo produkcyjne (oraz Portfel).
ZakresPozwala na
catalog:readGET /products, /products/{id}, /meta, /me, /ping, /gift-cards
webhooks:writePUT, GET i DELETE /webhook (rejestracja lub usunięcie adresu webhooka)
orders:writePOST /orders, POST /gift-cards/orders
orders:readGET /orders, /orders/{id}, /orders/{id}/keys, /gift-cards/orders, /gift-cards/orders/{id}, POST /webhooks/test
balance:readGET /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=summary od zapisanego nextCursor, zawsze z includeRemoved=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 ma removed: 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.

ParametrWartości / znaczenie
platformSteam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft, … (zobacz /meta)
regionEtykieta regionu (Global, Europe, …); zobacz /meta
productTypegame, dlc, software, gift-card, gift, subscription, game-point
deliveryTypekey, gift (link Steam Gift), account, link (link aktywacyjny)
categorygame, dlc, software, microsoft, gift-card, gift, subscription
genreNazwa gatunku (zobacz /meta)
minPrice / maxPriceEUR, cena API
inStocktrue, aby wyświetlić tylko to, co można sprzedać teraz
searchWszystkie słowa, dopasowywane do nazwy i przetłumaczonego tytułu
idsDo 200 identyfikatorów produktów
updatedSince / includeRemovedZmiany od podanej daty; uwzględnij wycofane produkty
sortupdated, popularity, name, price_asc, price_desc, newest (ze stronami; kursor synchronizacji zawsze podąża za updatedAt)
fields / limit / cursor / pagefull 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
}
PoleZnaczenie
priceTwoja cena jednostkowa w EUR: cena w sklepie minus 2 %. Sprawdzana ponownie na żywo przy zamówieniu.
shopPrice / discountPercentCena w sklepie i Twój rabat (2).
rrpRzeczywista cena detaliczna, gdy jest wyższa niż cena API; w przeciwnym razie null.
deliveryTypekey = kod do wykorzystania · gift = link Steam Gift · account = dane logowania · link = link aktywacyjny. Poinformuj klienta, co kupuje.
region / activationEtykieta regionu oraz dokładna lista ISO krajów, w których aktywacja NIE jest możliwa.
productType / category / edition / licenseTypeKlasyfikacja produktu.
languageJęzyk tekstów w tej odpowiedzi.
shortDescription / description / descriptionHtml / featuresTeksty. descriptionHtml to czysty HTML bez linków i obrazów.
activationSteps / activationDetails / systemRequirementsInstrukcja aktywacji i wymagania.
languages / genres / developer / publisher / releaseDate / ageRatingDane o grze.
coverImage / screenshots / videosObrazy z naszego CDN (zapisuj je w pamięci podręcznej u siebie) i filmy z YouTube.
qtyLiczba sztuk na stanie (maksymalnie 999).
urlPubliczna 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. externalId jest również unikalny w obrębie konta.
  • Zamówienie jest realizowane w tym samym żądaniu (?wait=20 czeka do 20 s): odpowiedź ma status completed i tablicę keys. Powtórzone żądanie zwraca zamówienie bez kluczy i z keysOmitted: 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). maxUnitPrice jest górnym limitem dla każdego klucza.
  • Jeśli żądanie przekroczy limit czasu, wyślij je ponownie z tym samym externalId: otrzymasz DUPLICATE_EXTERNAL_ID z id zamówienia i będziesz mógł pobrać jego klucze.
StatusZnaczenie
completedWszystkie sztuki dostarczone. Klucze są w odpowiedzi.
partially_refundedCzęść kluczy została zwrócona na Twoje saldo po reklamacjach.
refundedWszystkie 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-Key i unikalny externalId dział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, status blocked). 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).

ZdarzenieKiedy
order.completedZamówienie zostało zrealizowane.
order.refundedReklamacja zakończyła się zwrotem na Twoje saldo (`refundedSale`, `amount`).
products.updatedZmienił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.changedZmieniło się naraz ponad 1000 produktów: zamiast czytać zdarzenie, uruchom synchronizację z kursorem (`fields=summary`).
product.updatedTylko ręcznie opracowane produkty Windows i Office (wtyczka 1.0): `data.product` zawiera pełny produkt.
key.replacedSprzedawca zastąpił klucz: `oldKeyId`, `newKeyId`; pobierz nowy klucz przez GET /orders/{id}/keys.
balance.creditedDoładowanie zostało dodane do Twojego salda.
webhook.testWysył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"
  }
}
codeHTTPZnaczenieCo zrobić
UNAUTHORIZED401Missing, invalid, revoked or expired key.Check the key; create a new one in the dashboard.
ACCOUNT_NOT_ACTIVE403Partner account pending, suspended or rejected.Contact us.
IP_NOT_ALLOWED403Request IP not in your allowlist.Add the IP in Dashboard → Webhooks & security.
INSUFFICIENT_SCOPE403The key lacks the scope for this endpoint.Create a key with the scope.
NOT_FOUND404Unknown product, order or route.—
VALIDATION_ERROR400Invalid body or parameters (details lists each field).Fix the request; do not retry as is.
INSUFFICIENT_BALANCE402Balance too low. Nothing was charged.Top up and retry.
PRICE_CHANGED409Live unit price above maxUnitPrice. Nothing was charged.Re-price (details.currentPrice) and retry.
INVALID_COUPON400couponCode unknown, or the promotion has ended. Nothing was charged.Remove the code or send the active one (MICROSOFT20).
OUT_OF_STOCK409Not enough units available. Nothing was charged.Retry later or hide the product.
PRODUCT_UNAVAILABLE409Product not sellable through the API.Remove it from your shop.
DUPLICATE_EXTERNAL_ID409externalId already used; details.orderId is the existing order.Fetch that order instead.
IDEMPOTENCY_CONFLICT409Idempotency-Key reused with a different body.Use a new key per order.
IDEMPOTENCY_IN_PROGRESS409Same Idempotency-Key still being processed.Retry in a few seconds.
ORDER_LIMIT_EXCEEDED422Order total above your per-order limit.Split the order or ask for a higher limit.
DAILY_LIMIT_EXCEEDED42224-hour spend limit reached.Wait or ask for a higher limit.
RATE_LIMITED429Too many requests.Back off (details.retryAfterMs).
SERVICE_UNAVAILABLE503Temporarily unable to sell. Nothing was charged.Retry with exponential backoff.
INTERNAL_ERROR500Unexpected error (logged with requestId).Retry with the same Idempotency-Key.

Limity

LimitWartość
Żądania na klucz20 / sekundę i 600 / minutę
Zamówienia na konto120 / minutę
Pobrania kluczy na konto300 / minutę
Pozycje na zamówienie / sztuki na pozycję10 / 9
Wartość zamówienia i wydatki z 24 godzinUstalane dla konta (zobacz Panel → Przegląd); poproś nas o podniesienie
Rozmiar strony100 produktów (fields=full), 500 (fields=summary), 100 zamówień
Filtr ids200 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.