-20%

20% di sconto su Windows e Office

Per negozi online e sviluppatori

Vendi tutto il nostro catalogo nel tuo negozio. Le chiavi le consegniamo noi.

Giochi, DLC, software, Windows e Office, gift card e abbonamenti, con API REST o con il plugin WordPress. Quando il tuo cliente paga, la chiave viene acquistata e consegnata in automatico e addebitata sul tuo saldo prepagato (per esempio, ricarichi 500 € e ogni ordine viene addebitato da solo) o sul tuo Wallet.

  • 2% più economico del nostro sito

    Il prezzo dell'API è il prezzo del nostro sito meno il 2%, su ogni prodotto del catalogo.

  • Nessuna commissione di servizio

    Il sito aggiunge una commissione alla cassa. L'API no: paghi il prezzo dell'API e nient'altro.

  • Saldo prepagato o Wallet

    Ricarichi una volta e ogni ordine viene addebitato in automatico. Se il saldo non basta, lo copre il Wallet del tuo account.

Funziona con

  • 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%

Promozione attiva

20% di sconto su tutti i prodotti Microsoft

Aggiungi il codice ai tuoi ordini e paghi il 20% in meno per ogni licenza di Windows, Office, Visio, Project e SQL Server. Senza costi né minimi.

Campo dell’API

"couponCode": "MICROSOFT20"

In breve

BuyCheapKeys offre ai negozi online un'API REST e un plugin WordPress/WooCommerce per rivendere tutto il suo catalogo: giochi, DLC, software, Windows e Office, gift card e abbonamenti. Il prezzo dell'API è il prezzo del sito meno il 2%, senza commissioni di servizio. Il negozio importa le schede prodotto in una o più delle 7 lingue, mantiene prezzo e disponibilità sincronizzati con un cursore e ordina una chiave quando paga il suo cliente. La chiave di solito arriva nella risposta dell'ordine (o più tardi via webhook se l'ordine è ancora in corso) ed è pagata con il saldo prepagato del negozio o con il suo Wallet. È disponibile una sandbox gratuita.

Aggiornato:

Il catalogo che puoi vendere, in tempo reale

Questi numeri arrivano direttamente dall'API e si aggiornano ogni pochi minuti. I prezzi non sono pubblicati in questa pagina: li vedi con la tua chiave.

33.457
prodotti disponibili
19
piattaforme con disponibilità
32.839
giochi e DLC disponibili
498
prodotti software disponibili
120
abbonamenti disponibili

Piattaforme con più prodotti

  • 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

Una parte di ciò che puoi vendere oggi

Una selezione di copertine del catalogo. Ogni prodotto ha la sua scheda: descrizione, passaggi di attivazione, requisiti, screenshot e regione.

  • Grand Theft Auto V Enhanced EU PC Rockstar Digital Download (Rockstar) - Chiave Digitale Europa

    Grand Theft Auto V Enhanced EU PC Rockstar Digital Download (Rockstar) - Chiave Digitale Europa

    RockstarChiave

  • ELDEN RING NIGHTREIGN (Steam) - Chiave Digitale Stati Uniti

    ELDEN RING NIGHTREIGN (Steam) - Chiave Digitale Stati Uniti

    SteamChiave

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

    EA SPORTS FC 26 PS4/PS5 (PS4 Account)

    PlayStationAccount

  • EA Sports FC 24

    EA Sports FC 24

    EA AppChiave

  • Minecraft Legends Deluxe Edition (Xbox Account)

    Minecraft Legends Deluxe Edition (Xbox Account)

    XboxAccount

  • Baldur's Gate 3 (Steam Account)

    Baldur's Gate 3 (Steam Account)

    SteamAccount

  • Forza Horizon 4 Ultimate Edition (Xbox Account)

    Forza Horizon 4 Ultimate Edition (Xbox Account)

    XboxAccount

  • Call of Duty: Vanguard

    Call of Duty: Vanguard

    XboxChiave

Come funziona

  1. 01

    Crea il tuo account

    Richiedi l'accesso come partner e crea una chiave sandbox per provare tutto con chiavi false. Nella sandbox non si muove denaro.

  2. 02

    Importa il catalogo

    Leggi l'endpoint dei prodotti con i filtri che ti servono (piattaforma, regione, tipo, prezzo) in una o più lingue e tieni prezzo e disponibilità aggiornati con il cursore.

  3. 03

    Il tuo cliente paga

    La vendita avviene nel tuo negozio, con il tuo prezzo e i tuoi metodi di pagamento. Il tuo negozio invia una sola richiesta: POST /orders con il prodotto e il prezzo massimo che accetti.

  4. 04

    La chiave viene consegnata

    La chiave di solito torna nella stessa risposta (se l'ordine è in "processing", arriva via webhook o con GET /orders/{id}/keys), viene addebitata sul tuo saldo o Wallet e il tuo negozio la invia al cliente. Il plugin WordPress fa tutto da solo.

Filtri e formati

Vendi solo ciò che si adatta al tuo negozio. Tutti i filtri funzionano sull'endpoint dei prodotti e si possono combinare.

  • Formato di consegna

    Chiave da riscattare, link regalo (Steam Gift), account o link di attivazione. Ogni prodotto indica quale è.

  • Piattaforma

    Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft e altre.

  • Regione

    La regione di ogni chiave e l'elenco esatto dei paesi in cui non può essere attivata.

  • Tipo di prodotto

    Giochi, DLC, software, Windows e Office, gift card e abbonamenti.

  • Prezzo

    Prezzo minimo e massimo, ordinamento per prezzo, popolarità, nome o novità.

  • Disponibilità e modifiche

    Solo ciò che è disponibile, o solo ciò che è cambiato dall'ultima sincronizzazione.

Schede prodotto in 7 lingue

Nomi, descrizioni e passaggi di attivazione sono disponibili in inglese, spagnolo, tedesco, francese, italiano, portoghese e polacco. Scegli una lingua o importane più di una insieme per un negozio multilingue con WPML o Polylang. Ogni prodotto indica la lingua reale del suo testo.

  • en
  • es
  • de
  • fr
  • it
  • pt
  • pl

Paga con saldo prepagato o con il tuo Wallet

Ricarica il saldo una volta, per esempio 500 €, e ogni ordine viene addebitato automaticamente nel momento in cui il tuo cliente paga. Se il saldo non basta, il Wallet del tuo account copre il resto. Ogni movimento è nel tuo registro e un webhook ti avvisa quando arriva una ricarica.

Sandbox gratuita

Le chiavi sandbox (bck_test_) usano il catalogo e i prezzi reali, ma restituiscono chiavi false e un saldo di prova. Non si addebita nulla e non si usa disponibilità reale, così puoi costruire e testare tutto il flusso prima.

Webhook firmati

Ricevi avvisi quando un ordine viene completato o rimborsato, quando una chiave viene sostituita e quando cambiano i prodotti (products.updated e catalog.changed). Ogni evento è firmato con HMAC-SHA256 e ritentato per circa un giorno.

Plugin per WordPress e WooCommerce

Se il tuo negozio usa WordPress non devi scrivere codice. Installa il plugin, incolla la tua chiave API e scegli il tuo margine.

Versione 1.1.0 · gratuito · WordPress + WooCommerce

Scarica il plugin
  • Importa ogni prodotto con scheda, passaggi di attivazione e requisiti
  • Aggiorna prezzo e disponibilità in automatico, con il tuo margine e arrotondamento
  • Controlla il carrello prima del pagamento e blocca i prodotti che non si possono consegnare
  • Acquista la chiave quando l'ordine è pagato e la invia per email al cliente
  • Mostra la chiave nella pagina dell'ordine e in Il mio account, salvata cifrata
  • Riprova da solo se qualcosa va storto e ti avvisa per email

Documentazione dell'API

Tutto ciò che serve per integrare: autenticazione, sincronizzazione del catalogo, filtri, ordini, consegna delle chiavi, reclami, webhook, errori e limiti.

Leggi la documentazione dell'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 } ] }'

Piattaforme

Funziona con Shopify, Shopware, Magento, PrestaShop e qualsiasi altra piattaforma di negozi

Se la tua piattaforma può inviare una richiesta quando un ordine viene pagato, può vendere il nostro catalogo. Questo comprende l'elenco qui sotto, con più di 120 nomi, e qualsiasi negozio programmato da te. L'unico plugin che offriamo oggi è quello per WooCommerce. Su tutte le altre ti colleghi con l'API REST.

Come si collega qualsiasi piattaforma

  1. 01

    Catalogo

    Leggi l'endpoint dei prodotti per importare nomi, descrizioni, passaggi di attivazione e immagini, e per tenere aggiornati prezzo e disponibilità.

  2. 02

    Ordine pagato

    La tua piattaforma lancia il suo evento di ordine pagato: un webhook, un hook, un flusso o un'attività pianificata. Quell'evento chiama POST /orders con il prodotto e il prezzo massimo che accetti.

  3. 03

    Consegna

    La risposta contiene la chiave. Il tuo negozio la invia via email al cliente e la mostra nell'ordine. Se la chiave non è ancora pronta, il webhook order.completed ti avvisa quando lo è.

Vie più comuni per piattaforma

Ogni piattaforma ha il suo modo di reagire a un ordine pagato. Queste sono le vie che usano quasi tutti i negozi. Il tuo sviluppatore, o uno strumento come Zapier o Make, può configurare ognuna.

  • 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

Tutte le piattaforme per tipo

Creatori di negozi in hosting

  • 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 e self-hosted

  • 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 enterprise e 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

Software per marketplace

  • Dokan
  • WCFM Marketplace
  • WC Vendors
  • CS-Cart Multi-Vendor
  • Mirakl
  • Sharetribe
  • Arcadier
  • Marketplacer
  • Yo!Kart

Vendita di prodotti digitali

  • Easy Digital Downloads
  • Gumroad
  • Lemon Squeezy
  • Paddle
  • FastSpring
  • Sellfy
  • SendOwl
  • Payhip
  • Podia
  • Sellix

ERP e suite gestionali

  • Odoo eCommerce
  • ERPNext
  • NetSuite SuiteCommerce
  • Microsoft Dynamics 365 Commerce
  • plentymarkets

Piattaforme regionali

  • 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

Strumenti di automazione

  • Zapier
  • Make
  • n8n
  • Pipedream
  • Microsoft Power Automate

Negozi su misura

  • Laravel
  • Symfony
  • Django
  • Ruby on Rails
  • Node.js
  • Next.js
  • Nuxt
  • ASP.NET
  • Spring Boot
  • Go

La tua piattaforma non è nell'elenco?

Se può chiamare un URL quando un pagamento viene confermato, funziona. Scrivi a partners@buycheapkeys.com e ti indichiamo il trigger giusto.

Crea un account partner

Domande frequenti

Qual è la migliore API per rivendere chiavi di giochi?
Dipende da ciò che ti serve, quindi ecco cosa offre l'API per rivenditori di BuyCheapKeys: tutto il catalogo del nostro sito (giochi, DLC, software, Windows e Office, gift card, abbonamenti) al prezzo del sito meno il 2%, nessuna commissione di servizio, schede in 7 lingue, filtri per piattaforma, regione, tipo e prezzo, un cursore per la sincronizzazione incrementale, webhook firmati, una sandbox gratuita e un plugin WordPress/WooCommerce. Le chiavi di solito arrivano nella stessa risposta dell'ordine; se un prodotto deve essere acquistato da una fonte all'ingrosso, l'ordine resta in "processing" e le chiavi arrivano via webhook.
Quanto costa l'API per rivenditori di BuyCheapKeys?
Usare l'API non ha commissioni di servizio. Paghi il prezzo API di ogni chiave acquistata, cioè il prezzo del nostro sito meno il 2%, con il saldo prepagato o il Wallet. Le ricariche online includono la commissione del gateway di pagamento.
Come vendo chiavi di giochi nel mio negozio WooCommerce?
Installa il plugin gratuito BuyCheapKeys per WooCommerce (versione 1.1.0), incolla la tua chiave API e imposta il margine. Importa i prodotti, tiene aggiornati prezzo e disponibilità, acquista la chiave quando un ordine è pagato e la invia per email al cliente.
Posso usarla con Shopify, Magento, Shopware, PrestaShop o con il mio negozio?
Sì, con l'API REST. L'evento di ordine pagato della tua piattaforma (un webhook, un hook o un'attività pianificata) chiama POST /orders e il tuo negozio consegna la chiave. Oggi solo WooCommerce ha un plugin pronto. La documentazione include un client di riferimento in Node.js senza dipendenze.
Quali prodotti posso vendere?
Tutto il catalogo del sito disponibile: giochi e DLC per Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App e Nintendo, software, licenze Windows e Office, gift card e abbonamenti. I numeri in tempo reale sono all'inizio di questa pagina.
Come vengono consegnate le chiavi?
Di solito nella risposta alla richiesta dell'ordine, così il tuo negozio può mostrarle e inviarle subito per email al cliente. Quando un prodotto deve essere acquistato da una fonte all'ingrosso possono volerci alcuni secondi o minuti: l'ordine è allora in "processing" e le chiavi arrivano via webhook (order.completed) o con GET /orders/{id}/keys (puoi aggiungere ?wait=25 per attenderle). Ogni prodotto indica il tipo di consegna: chiave da riscattare, link Steam Gift, account o link di attivazione. Puoi rileggere le chiavi con l'endpoint delle chiavi.
Come pago gli ordini?
Con un saldo API prepagato. Per esempio, ricarichi 500 € e ogni ordine viene addebitato automaticamente quando viene effettuato. Se il saldo non basta, lo copre il Wallet del tuo account. Se nessuno dei due basta, l'ordine viene rifiutato e non si addebita nulla.
In quali lingue sono disponibili le schede prodotto?
Inglese, spagnolo, tedesco, francese, italiano, portoghese e polacco. Usa il parametro lang per sceglierne una o importane più di una per un negozio multilingue. Se manca una traduzione, viene restituito il testo inglese e il prodotto lo segnala.
Come mantengo sincronizzati prezzi e disponibilità?
Fai una volta un'importazione completa, poi chiama l'endpoint dei prodotti ogni pochi minuti con fields=summary e il cursore salvato: restituisce solo ciò che è cambiato (prezzo, disponibilità, rimossi). Anche i webhook (products.updated e catalog.changed) ti dicono quando sincronizzare.
Posso provare l'API senza pagare?
Sì. Le chiavi sandbox restituiscono chiavi false e usano un saldo di prova. Catalogo e prezzi sono reali, non si addebita nulla e non si usa disponibilità reale.
Cosa succede se una chiave non funziona?
Le chiavi dei venditori del marketplace si possono contestare per 14 giorni dal tuo pannello partner, con messaggi e screenshot. Se il reclamo viene accettato, ricevi una chiave sostitutiva nello stesso ordine oppure il prezzo torna sul tuo saldo. Le altre chiavi sono gestite dal supporto in base alla garanzia.

Inizia a vendere tutto il catalogo

Crea un account partner, prova nella sandbox e passa alla produzione quando vuoi.

BuyCheapKeys è un rivenditore indipendente. I nomi di piattaforme e marchi appartengono ai rispettivi proprietari e sono usati solo per descrivere la compatibilità. Verifica che il tipo di licenza e la regione siano adatti ai tuoi clienti e alla legge del tuo paese.

Documentazione dell'API

Indice

API REST/JSON per vendere l'intero catalogo di BuyCheapKeys sul tuo sito. Il prezzo API è il prezzo del sito meno il 2 %, senza commissioni di servizio. Ogni ordine viene pagato con il tuo saldo prepagato (o il tuo Wallet) e le chiavi arrivano nella stessa risposta.

URL di base: https://buycheapkeys.com/partner-api/v1 Scarica la specifica OpenAPI 3.1

Panoramica

URL di base: https://buycheapkeys.com/partner-api/v1. Tutte le richieste e le risposte sono in JSON (UTF-8). I prezzi sono in EUR con due decimali e IVA esclusa. Le date sono in formato ISO 8601 in UTC.

  • Catalogo: l'intero catalogo del sito (giochi, DLC, software, Windows e Office, gift card, abbonamenti) con schede prodotto in 7 lingue (en, es, de, fr, it, pt, pl).
  • Prezzo: prezzo API = prezzo del sito meno 2 %, e nessuna commissione di servizio (il sito applica una commissione al checkout; l'API no). GET /me restituisce discountPercent e serviceFee: 0.
  • Ordini: acquista fino a 10 righe x 9 unità per richiesta; il totale viene addebitato in una sola volta sul tuo saldo prepagato e, se non basta, sul tuo Wallet.
  • Consegna: le chiavi sono nella risposta dell'ordine e si possono rileggere con GET /orders/{id}/keys.
  • Reclami: una chiave difettosa può essere contestata entro 14 giorni dalla tua dashboard partner; una chiave sostitutiva arriva automaticamente nel tuo ordine e un rimborso torna sul tuo saldo.

Usi WordPress/WooCommerce? Usa il plugin (vedi la sezione Plugin qui sopra): importa il catalogo, mantiene sincronizzati prezzo e disponibilità e consegna le chiavi senza scrivere codice.

Autenticazione e ambienti

Crea le chiavi in Dashboard → Partner → Chiavi API. Una chiave viene mostrata una sola volta; ne conserviamo solo l'hash. Inviala nell'header Authorization (è accettato anche X-Api-Key).

curl https://buycheapkeys.com/partner-api/v1/ping \
  -H "Authorization: Bearer bck_test_xxxxxxxxxxxx_..."
Prefisso della chiaveModalitàComportamento
bck_test_SandboxCatalogo e prezzi reali, saldo di prova separato (azzerabile), chiavi fittizie come TEST-AB12C-…, nessun movimento di denaro. I webhook vengono inviati con mode: test.
bck_live_ProduzioneAcquisti reali addebitati sul tuo saldo live (e sul Wallet).
ScopeConsente
catalog:readGET /products, /products/{id}, /meta, /me, /ping, /gift-cards
webhooks:writePUT, GET e DELETE /webhook (registrare o rimuovere l'URL del tuo webhook)
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

Allowlist di IP opzionale (IPv4/IPv6, CIDR) per account. Le chiavi non scadono mai se non vengono revocate; per ruotarle crea una nuova chiave e revoca la vecchia. GET /public/catalog non richiede chiave.

Guida rapida

1) Crea una chiave bck_test_. 2) Elenca i prodotti. 3) Effettua un ordine: torna completato, con le chiavi. 4) Rileggi le chiavi in qualsiasi momento con GET /orders/{id}/keys. Gli account ancora in fase di approvazione possono usare le chiavi sandbox.

curl "https://buycheapkeys.com/partner-api/v1/products?lang=en&limit=100&inStock=true" \n  -H "Authorization: Bearer $BCK_API_KEY"

Catalogo e sincronizzazione

GET /products restituisce i prodotti ordinati per updatedAt (poi per id). updatedAt cambia solo quando cambia qualcosa che ti riguarda (prezzo, disponibilità, nome, regione, testi, immagini). Sincronizza con il cursore: ogni risposta contiene nextCursor e hasMore; passa nextCursor come ?cursor= finché hasMore è false e conservalo per l'esecuzione successiva. Non salta né ripete mai prodotti, nemmeno quando molti condividono lo stesso timestamp (il cursore segue sempre updatedAt; sort si applica solo quando navighi per pagine).

Due formati: fields=full (predefinito, fino a 100 prodotti per pagina) è la scheda completa; fields=summary (fino a 500 per pagina) restituisce solo id, price, shopPrice, currency, inStock, qty, updatedAt e removed, ideale per mantenere prezzo e disponibilità aggiornati ogni minuto.

# 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"
  • Consigliato: importazione completa una volta (fields=full, nelle lingue del tuo negozio), poi ogni 1–5 minuti fields=summary dal nextCursor salvato, sempre con includeRemoved=true.
  • Disponibilità: se il sito non può vendere un prodotto (nessuna disponibilità, stock disattivato, costo oltre il nostro limite) compare come inStock: false, qty: 0 in meno di un minuto; un prodotto nascosto o eliminato ha removed: true. Non venderli mai.
  • Le modifiche al catalogo vengono comunicate via webhook (products.updated, catalog.changed), quindi il polling può essere poco frequente.
  • GET /public/catalog?lang= (senza chiave, in cache per 10 minuti) restituisce dati aggiornati e alcune copertine in evidenza per la tua landing page.

Filtri, ordinamento e lingue

lang (en, es, de, fr, it, pt, pl; predefinito en) sceglie la lingua di nomi e descrizioni. Ogni prodotto ha language con la lingua reale del testo (en quando manca una traduzione). Una lingua o più lingue: chiama una volta per lingua, oppure importale tutte e sette per negozi multilingua con WPML/Polylang. Le liste accettano valori separati da virgola.

ParametroValori / significato
platformSteam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft, … (vedi /meta)
regionEtichetta della regione (Global, Europe, …); vedi /meta
productTypegame, dlc, software, gift-card, gift, subscription, game-point
deliveryTypekey, gift (link Steam Gift), account, link (link di attivazione)
categorygame, dlc, software, microsoft, gift-card, gift, subscription
genreNome del genere (vedi /meta)
minPrice / maxPriceEUR, prezzo API
inStocktrue per elencare solo ciò che si può vendere ora
searchTutte le parole, confrontate con il nome e il titolo tradotto
idsFino a 200 id di prodotto
updatedSince / includeRemovedModifiche da una data; includi i prodotti ritirati
sortupdated, popularity, name, price_asc, price_desc, newest (con le pagine; il cursore di sincronizzazione segue sempre updatedAt)
fields / limit / cursor / pagefull o summary; fino a 100 (full) o 500 (summary); cursor per la sincronizzazione; page per la navigazione
# 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 restituisce le faccette con conteggi e disponibilità (piattaforme, regioni, tipi di prodotto, generi, lingue, fascia di prezzo, valori di ordinamento) per costruire i tuoi filtri.

Campi del prodotto

{
  "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
}
CampoSignificato
priceIl tuo prezzo unitario in EUR: prezzo del sito meno 2 %. Ricontrollato in tempo reale quando ordini.
shopPrice / discountPercentPrezzo del sito e il tuo sconto (2).
rrpPrezzo al pubblico reale quando è più alto del prezzo API; altrimenti null.
deliveryTypekey = codice da riscattare · gift = link Steam Gift · account = credenziali di accesso · link = link di attivazione. Indica al tuo cliente quale sta acquistando.
region / activationEtichetta della regione più l'elenco ISO esatto dei paesi in cui NON può essere attivato.
productType / category / edition / licenseTypeClassificazione del prodotto.
languageLingua dei testi di questa risposta.
shortDescription / description / descriptionHtml / featuresTesti. descriptionHtml è HTML pulito, senza link né immagini.
activationSteps / activationDetails / systemRequirementsIstruzioni di riscatto e requisiti.
languages / genres / developer / publisher / releaseDate / ageRatingDati del gioco.
coverImage / screenshots / videosImmagini dal nostro CDN (mettile in cache dalla tua parte) e video di YouTube.
qtyUnità disponibili (limitate a 999).
urlPagina pubblica del prodotto sul sito.

Ordini

POST /orders con externalId (il tuo riferimento univoco) e items (productId, qty 1–9, maxUnitPrice). Per ogni riga verifichiamo il prezzo reale: se supera maxUnitPrice, l'intero ordine viene rifiutato con PRICE_CHANGED e non viene addebitato nulla. Se è inferiore, paghi il prezzo più basso. Vende la fonte più economica con disponibilità, come sul sito.

Consigliato: invia storeUrl (l'URL del tuo negozio in cui il prodotto viene venduto) nel corpo di POST /orders, oppure l'header X-Store-Url in qualsiasi chiamata. È facoltativo; il plugin per WordPress invia automaticamente l'URL del tuo sito.

Codice promozionale: aggiungi couponCode: MICROSOFT20 per pagare il 20 % in meno sui prodotti Microsoft (Windows, Office, Visio, Project, SQL Server) finché la promozione è attiva. Viene applicato solo a quelle righe; un codice sconosciuto o una promozione terminata restituisce INVALID_COUPON e non viene addebitato nulla.

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
}
  • Invia un header Idempotency-Key (8–100 caratteri) e riutilizzalo quando riprovi: ricevi la risposta originale e non vieni mai addebitato due volte. Anche externalId è univoco per account.
  • L'ordine viene completato nella stessa richiesta (?wait=20 attende fino a 20 s): la risposta ha stato completed e un array keys. Una richiesta ripetuta restituisce l'ordine senza le chiavi e con keysOmitted: true: leggile con GET /orders/{id}/keys.
  • Nessuna disponibilità o saldo insufficiente: non viene addebitato nulla e nessuna chiave viene usata (OUT_OF_STOCK, INSUFFICIENT_BALANCE). maxUnitPrice è un tetto per ogni chiave.
  • Se una richiesta va in timeout, inviala di nuovo con lo stesso externalId: ricevi DUPLICATE_EXTERNAL_ID con l'id dell'ordine e puoi leggerne le chiavi.
StatoSignificato
completedTutte le unità sono state consegnate. Le chiavi sono nella risposta.
partially_refundedAlcune chiavi sono state rimborsate sul tuo saldo dopo dei reclami.
refundedTutte le chiavi dell'ordine sono state rimborsate sul tuo saldo.

Consegna delle chiavi

GET /orders/{id}/keys restituisce ogni unità consegnata: value contiene il codice, l'URL Steam Gift, le credenziali dell'account o il link di attivazione a seconda di deliveryType. contentType è text/plain o un tipo di immagine (in tal caso value è in base64).

Conserva le chiavi cifrate e mostrale solo all'acquirente. Il primo download di ogni ordine viene registrato da noi come prova di consegna.

Reclami e rimborsi

Una chiave difettosa può essere contestata entro 14 giorni. Apri l'ordine in Dashboard → Ordini (ordini API), scegli la chiave, scrivi al venditore e allega gli screenshot dell'errore di attivazione. Il venditore può inviare una chiave sostitutiva (compare nel tuo ordine e ricevi il webhook key.replaced) oppure rimborsare la chiave (il prezzo torna una sola volta sul tuo saldo API e ricevi order.refunded). Se non sei d'accordo, puoi escalare e BuyCheapKeys decide.

Controlla la regione, excludedCountries e il tipo di licenza prima di vendere, e mostrali al tuo cliente. Un rimborso sul tuo saldo non rimborsa il tuo cliente: quella è una tua decisione.

Gift Card BuyCheapKeys all'ingrosso

Oltre alle gift card di altri marchi (sono prodotti del catalogo, productType=gift-card), puoi acquistare le nostre gift card da rivendere: codici BCK-XXXX-XXXX-XXXX-XXXX che aggiungono il loro valore al Wallet BuyCheapKeys di chi li riscatta su buycheapkeys.com/wallet. GET /gift-cards restituisce i tagli in vendita, gli sconti per volume, i massimi per ordine e il saldo del tuo Wallet. POST /gift-cards/orders acquista N carte di un taglio e restituisce subito i codici; GET /gift-cards/orders/{id} li mostra di nuovo con lo stato di ciascun codice.

curl https://buycheapkeys.com/partner-api/v1/gift-cards \
  -H "Authorization: Bearer $BCK_API_KEY"
  • Si paga solo dal Wallet BuyCheapKeys del tuo account negozio (ricaricalo su buycheapkeys.com/wallet), non dal saldo API. Prezzo = valore nominale meno lo sconto per volume di quella quantità.
  • Tagli, sconti e massimi possono cambiare: invia maxTotal per rifiutare un totale più alto (PRICE_CHANGED, nessun addebito). Idempotency-Key e externalId univoco funzionano come per gli ordini.
  • Vendita in pausa: PRODUCT_UNAVAILABLE (409). Taglio non in vendita o quantità fuori intervallo: VALIDATION_ERROR. Ordine troppo grande: ORDER_LIMIT_EXCEEDED. Saldo Wallet insufficiente: INSUFFICIENT_BALANCE (402).
  • Le chiavi sandbox restituiscono codici fittizi BCK-TEST-… che non si possono riscattare e non addebitano nulla.
  • I codici venduti sono definitivi. Ogni codice ha una data di scadenza (expiresAt) e limiti di riscatto per account. Un codice bloccato da noi per frode non viene più mostrato (code: null, stato blocked). Conserva i codici cifrati.

Webhook

Imposta un URL https in Dashboard → Webhooks (oppure PUT /webhook); ricevi un segreto di firma (whsec_…). Ogni evento è un POST con gli header X-BCK-Event, X-BCK-Delivery (id univoco: deduplica su di esso) e X-BCK-Signature: t=<unix>,v1=<hex> dove v1 = HMAC-SHA256(secret, t + "." + rawBody).

EventoQuando
order.completedUn ordine è stato completato.
order.refundedUn reclamo si è concluso con un rimborso sul tuo saldo (`refundedSale`, `amount`).
products.updatedSono cambiati prezzo, disponibilità o stato dei prodotti: `data.products` contiene fino a 100 prodotti in formato summary per evento (`removed: true` quando ritirati).
catalog.changedPiù di 1000 prodotti sono cambiati insieme: esegui la sincronizzazione con il cursore (`fields=summary`) invece di leggere l'evento.
product.updatedSolo prodotti Windows e Office curati a mano (plugin 1.0): `data.product` contiene il prodotto completo.
key.replacedUn venditore ha sostituito una chiave: `oldKeyId`, `newKeyId`; leggi la nuova chiave con GET /orders/{id}/keys.
balance.creditedUna ricarica è stata accreditata sul tuo saldo.
webhook.testInviato da POST /webhooks/test o dal pulsante della dashboard.
{
  "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}" }
}
  • Rispondi con 2xx entro 8 s ed esegui il lavoro in modo asincrono. I redirect non vengono seguiti.
  • Le consegne non riuscite vengono ritentate dopo 10 s, 30 s, 1 min, 5 min, 15 min, 30 min, 1 h, 2 h, 4 h, 6 h e 12 h (~26 h).
  • Gli eventi possono arrivare fuori ordine o più di una volta: in caso di dubbio rileggi sempre GET /orders/{id} o il cursore.

Errori

Gli errori usano i codici di stato HTTP e un code stabile. Cita requestId quando contatti l'assistenza.

{
  "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"
  }
}
codeHTTPSignificatoCosa fare
UNAUTHORIZED401Chiave assente, non valida, revocata o scaduta.Controlla la chiave o creane una nuova nel pannello.
ACCOUNT_NOT_ACTIVE403Account partner in attesa, sospeso o rifiutato.Contattaci.
IP_NOT_ALLOWED403L'IP della richiesta non è nella tua allowlist.Aggiungi l'IP in Dashboard → Webhooks e sicurezza.
INSUFFICIENT_SCOPE403La chiave non ha lo scope necessario per questo endpoint.Crea una chiave con lo scope richiesto.
NOT_FOUND404Prodotto, ordine o rotta sconosciuti.—
VALIDATION_ERROR400Corpo o parametri non validi (details elenca ogni campo).Correggi la richiesta; non ripeterla così com'è.
INSUFFICIENT_BALANCE402Saldo insufficiente. Non è stato addebitato nulla.Ricarica e riprova.
PRICE_CHANGED409Il prezzo unitario reale supera maxUnitPrice. Non è stato addebitato nulla.Aggiorna il prezzo (details.currentPrice) e riprova.
INVALID_COUPON400couponCode sconosciuto o promozione terminata. Non è stato addebitato nulla.Rimuovi il codice o invia quello attivo (MICROSOFT20).
OUT_OF_STOCK409Unità disponibili insufficienti. Non è stato addebitato nulla.Riprova più tardi o nascondi il prodotto.
PRODUCT_UNAVAILABLE409Prodotto non vendibile tramite API.Rimuovilo dal tuo negozio.
DUPLICATE_EXTERNAL_ID409externalId già usato; details.orderId è l'ordine esistente.Recupera quell'ordine.
IDEMPOTENCY_CONFLICT409Idempotency-Key riutilizzata con un corpo diverso.Usa una nuova chiave per ogni ordine.
IDEMPOTENCY_IN_PROGRESS409La stessa Idempotency-Key è ancora in elaborazione.Riprova tra qualche secondo.
ORDER_LIMIT_EXCEEDED422Totale dell'ordine superiore al tuo limite per ordine.Dividi l'ordine o chiedi un limite più alto.
DAILY_LIMIT_EXCEEDED422Limite di spesa nelle 24 ore raggiunto.Attendi o chiedi un limite più alto.
RATE_LIMITED429Troppe richieste.Rallenta (details.retryAfterMs).
SERVICE_UNAVAILABLE503Vendita temporaneamente non disponibile. Non è stato addebitato nulla.Riprova con backoff esponenziale.
INTERNAL_ERROR500Errore imprevisto (registrato con requestId).Riprova con la stessa Idempotency-Key.

Limiti

LimiteValore
Richieste per chiave20 / secondo e 600 / minuto
Ordini per account120 / minuto
Download di chiavi per account300 / minuto
Righe per ordine / unità per riga10 / 9
Valore dell'ordine e spesa nelle 24 orePer account (vedi Dashboard → Panoramica); chiedici di aumentarli
Dimensione della pagina100 prodotti (fields=full), 500 (fields=summary), 100 ordini
Filtro ids200 id

Saldo, Wallet e ricariche

Gli ordini vengono addebitati sul tuo saldo API prepagato e, se non basta, sul Wallet del tuo account. GET /balance restituisce il saldo della modalità della chiave; GET /me mostra anche walletBalance e available. Ricarica da Dashboard → Saldo (ad esempio 500 EUR, poi ogni ordine viene addebitato automaticamente): ricevi un riferimento univoco per il bonifico bancario, oppure puoi pagare online; l'importo viene accreditato al suo arrivo (e-mail + webhook balance.credited). Ogni movimento compare nel registro.

Implementazione con un assistente IA

Documentazione leggibile dalle macchine: https://buycheapkeys.com/reseller-api.md (questa pagina in Markdown; /reseller-api.es.md in spagnolo), la specifica OpenAPI 3.1 https://buycheapkeys.com/partner-api/v1/openapi.json e https://buycheapkeys.com/llms.txt. Fornisci questi URL al tuo assistente IA insieme al prompt qui sotto.

Integrazione di riferimento completa (Node.js 18+, senza dipendenze): https://buycheapkeys.com/developers/bck-partner-client.mjs: sincronizzazione del catalogo con cursore, ordini sicuri con tentativi e idempotenza, download delle chiavi e ricevitore di webhook con verifica della firma.

curl -O https://buycheapkeys.com/developers/bck-partner-client.mjs
export BCK_API_KEY=bck_test_...   # chiave sandbox da Dashboard → Partner → Chiavi API
node bck-partner-client.mjs balance
node bck-partner-client.mjs sync
node bck-partner-client.mjs order <productId> 1 <maxUnitPrice>
  • Invariante 1: vendi solo prodotti con inStock=true e removed=false; risincronizza ogni 1–5 min dal nextCursor salvato.
  • Invariante 2: un ordine cliente = un externalId = una Idempotency-Key; riutilizza entrambi a ogni nuovo tentativo.
  • Invariante 3: invia sempre maxUnitPrice; gli errori di business 4xx sono definitivi e non è stato addebitato nulla.
  • Invariante 4: riprova solo con errori di rete, 429, 5xx e IDEMPOTENCY_IN_PROGRESS, con backoff esponenziale.
  • Invariante 5: non riordinare mai dopo un timeout: ripeti lo stesso externalId e leggi le chiavi dell'ordine esistente.
  • Invariante 6: tieni la chiave API lato server; verifica le firme dei webhook; mostra ai clienti deliveryType, regione e paesi esclusi.

Checklist per andare in produzione

  • Tieni le chiavi API solo sul tuo server (mai nei browser o nelle app) e in un gestore di segreti o in variabili d'ambiente.
  • Usa chiavi separate per ogni sistema e gli scope minimi; attiva l'allowlist di IP.
  • Invia sempre maxUnitPrice e una Idempotency-Key, e invia storeUrl (o l'header X-Store-Url) con l'URL del tuo negozio.
  • Verifica la firma e il timestamp di ogni webhook prima di fidarti.
  • Testa l'intero flusso con una chiave bck_test_, poi passa a bck_live_ e ricarica il saldo.
  • Ruota le chiavi e il segreto del webhook se sospetti una fuga, poi revoca quelle vecchie.