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
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-…" } ] }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
RockstarChiave

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

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

EA Sports FC 24
EA AppChiave

Minecraft Legends Deluxe Edition (Xbox Account)
XboxAccount

Baldur's Gate 3 (Steam Account)
SteamAccount

Forza Horizon 4 Ultimate Edition (Xbox Account)
XboxAccount

Call of Duty: Vanguard
XboxChiave

Hogwarts Legacy
XboxChiave

Hogwarts Legacy Digital Deluxe Edition (PS5 Account)
PlayStationAccount

Stardew Valley (Steam Gift) (Steam) - Chiave Digitale Globale
SteamLink regalo

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

Microsoft Windows 11 Pro (PC) - Microsoft Key - GLOBAL (Microsoft) - Chiave Digitale Globale
MicrosoftChiave

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

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

Microsoft Windows 10 / 11 Pro - 1 PC - OEM
MicrosoftChiave
Come funziona
- 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.
- 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.
- 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.
- 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
- 01
Catalogo
Leggi l'endpoint dei prodotti per importare nomi, descrizioni, passaggi di attivazione e immagini, e per tenere aggiornati prezzo e disponibilità.
- 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.
- 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.
Domande frequenti
Qual è la migliore API per rivendere chiavi di giochi?
Quanto costa l'API per rivenditori di BuyCheapKeys?
Come vendo chiavi di giochi nel mio negozio WooCommerce?
Posso usarla con Shopify, Magento, Shopware, PrestaShop o con il mio negozio?
Quali prodotti posso vendere?
Come vengono consegnate le chiavi?
Come pago gli ordini?
In quali lingue sono disponibili le schede prodotto?
Come mantengo sincronizzati prezzi e disponibilità?
Posso provare l'API senza pagare?
Cosa succede se una chiave non funziona?
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
- Panoramica
- Autenticazione e ambienti
- Guida rapida
- Catalogo e sincronizzazione
- Filtri, ordinamento e lingue
- Campi del prodotto
- Ordini
- Consegna delle chiavi
- Reclami e rimborsi
- Gift Card BuyCheapKeys all'ingrosso
- Webhook
- Errori
- Limiti
- Saldo, Wallet e ricariche
- Implementazione con un assistente IA
- Checklist per andare in produzione
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.
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 /merestituiscediscountPercenteserviceFee: 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 chiave | Modalità | Comportamento |
|---|---|---|
| bck_test_ | Sandbox | Catalogo 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_ | Produzione | Acquisti reali addebitati sul tuo saldo live (e sul Wallet). |
| Scope | Consente |
|---|---|
| catalog:read | GET /products, /products/{id}, /meta, /me, /ping, /gift-cards |
| webhooks:write | PUT, GET e DELETE /webhook (registrare o rimuovere l'URL del tuo webhook) |
| 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 |
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=summarydalnextCursorsalvato, sempre conincludeRemoved=true. - Disponibilità: se il sito non può vendere un prodotto (nessuna disponibilità, stock disattivato, costo oltre il nostro limite) compare come
inStock: false, qty: 0in meno di un minuto; un prodotto nascosto o eliminato haremoved: 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.
| Parametro | Valori / significato |
|---|---|
| platform | Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft, … (vedi /meta) |
| region | Etichetta della regione (Global, Europe, …); vedi /meta |
| productType | game, dlc, software, gift-card, gift, subscription, game-point |
| deliveryType | key, gift (link Steam Gift), account, link (link di attivazione) |
| category | game, dlc, software, microsoft, gift-card, gift, subscription |
| genre | Nome del genere (vedi /meta) |
| minPrice / maxPrice | EUR, prezzo API |
| inStock | true per elencare solo ciò che si può vendere ora |
| search | Tutte le parole, confrontate con il nome e il titolo tradotto |
| ids | Fino a 200 id di prodotto |
| updatedSince / includeRemoved | Modifiche da una data; includi i prodotti ritirati |
| sort | updated, popularity, name, price_asc, price_desc, newest (con le pagine; il cursore di sincronizzazione segue sempre updatedAt) |
| fields / limit / cursor / page | full 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
}| Campo | Significato |
|---|---|
| price | Il tuo prezzo unitario in EUR: prezzo del sito meno 2 %. Ricontrollato in tempo reale quando ordini. |
| shopPrice / discountPercent | Prezzo del sito e il tuo sconto (2). |
| rrp | Prezzo al pubblico reale quando è più alto del prezzo API; altrimenti null. |
| deliveryType | key = codice da riscattare · gift = link Steam Gift · account = credenziali di accesso · link = link di attivazione. Indica al tuo cliente quale sta acquistando. |
| region / activation | Etichetta della regione più l'elenco ISO esatto dei paesi in cui NON può essere attivato. |
| productType / category / edition / licenseType | Classificazione del prodotto. |
| language | Lingua dei testi di questa risposta. |
| shortDescription / description / descriptionHtml / features | Testi. descriptionHtml è HTML pulito, senza link né immagini. |
| activationSteps / activationDetails / systemRequirements | Istruzioni di riscatto e requisiti. |
| languages / genres / developer / publisher / releaseDate / ageRating | Dati del gioco. |
| coverImage / screenshots / videos | Immagini dal nostro CDN (mettile in cache dalla tua parte) e video di YouTube. |
| qty | Unità disponibili (limitate a 999). |
| url | Pagina 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. AncheexternalIdè univoco per account. - L'ordine viene completato nella stessa richiesta (
?wait=20attende fino a 20 s): la risposta ha statocompletede un arraykeys. Una richiesta ripetuta restituisce l'ordine senza le chiavi e conkeysOmitted: 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_IDcon l'id dell'ordine e puoi leggerne le chiavi.
| Stato | Significato |
|---|---|
| completed | Tutte le unità sono state consegnate. Le chiavi sono nella risposta. |
| partially_refunded | Alcune chiavi sono state rimborsate sul tuo saldo dopo dei reclami. |
| refunded | Tutte 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
maxTotalper rifiutare un totale più alto (PRICE_CHANGED, nessun addebito).Idempotency-KeyeexternalIdunivoco 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, statoblocked). 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).
| Evento | Quando |
|---|---|
| order.completed | Un ordine è stato completato. |
| order.refunded | Un reclamo si è concluso con un rimborso sul tuo saldo (`refundedSale`, `amount`). |
| products.updated | Sono cambiati prezzo, disponibilità o stato dei prodotti: `data.products` contiene fino a 100 prodotti in formato summary per evento (`removed: true` quando ritirati). |
| catalog.changed | Più di 1000 prodotti sono cambiati insieme: esegui la sincronizzazione con il cursore (`fields=summary`) invece di leggere l'evento. |
| product.updated | Solo prodotti Windows e Office curati a mano (plugin 1.0): `data.product` contiene il prodotto completo. |
| key.replaced | Un venditore ha sostituito una chiave: `oldKeyId`, `newKeyId`; leggi la nuova chiave con GET /orders/{id}/keys. |
| balance.credited | Una ricarica è stata accreditata sul tuo saldo. |
| webhook.test | Inviato 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"
}
}| code | HTTP | Significato | Cosa fare |
|---|---|---|---|
| UNAUTHORIZED | 401 | Chiave assente, non valida, revocata o scaduta. | Controlla la chiave o creane una nuova nel pannello. |
| ACCOUNT_NOT_ACTIVE | 403 | Account partner in attesa, sospeso o rifiutato. | Contattaci. |
| IP_NOT_ALLOWED | 403 | L'IP della richiesta non è nella tua allowlist. | Aggiungi l'IP in Dashboard → Webhooks e sicurezza. |
| INSUFFICIENT_SCOPE | 403 | La chiave non ha lo scope necessario per questo endpoint. | Crea una chiave con lo scope richiesto. |
| NOT_FOUND | 404 | Prodotto, ordine o rotta sconosciuti. | — |
| VALIDATION_ERROR | 400 | Corpo o parametri non validi (details elenca ogni campo). | Correggi la richiesta; non ripeterla così com'è. |
| INSUFFICIENT_BALANCE | 402 | Saldo insufficiente. Non è stato addebitato nulla. | Ricarica e riprova. |
| PRICE_CHANGED | 409 | Il prezzo unitario reale supera maxUnitPrice. Non è stato addebitato nulla. | Aggiorna il prezzo (details.currentPrice) e riprova. |
| INVALID_COUPON | 400 | couponCode sconosciuto o promozione terminata. Non è stato addebitato nulla. | Rimuovi il codice o invia quello attivo (MICROSOFT20). |
| OUT_OF_STOCK | 409 | Unità disponibili insufficienti. Non è stato addebitato nulla. | Riprova più tardi o nascondi il prodotto. |
| PRODUCT_UNAVAILABLE | 409 | Prodotto non vendibile tramite API. | Rimuovilo dal tuo negozio. |
| DUPLICATE_EXTERNAL_ID | 409 | externalId già usato; details.orderId è l'ordine esistente. | Recupera quell'ordine. |
| IDEMPOTENCY_CONFLICT | 409 | Idempotency-Key riutilizzata con un corpo diverso. | Usa una nuova chiave per ogni ordine. |
| IDEMPOTENCY_IN_PROGRESS | 409 | La stessa Idempotency-Key è ancora in elaborazione. | Riprova tra qualche secondo. |
| ORDER_LIMIT_EXCEEDED | 422 | Totale dell'ordine superiore al tuo limite per ordine. | Dividi l'ordine o chiedi un limite più alto. |
| DAILY_LIMIT_EXCEEDED | 422 | Limite di spesa nelle 24 ore raggiunto. | Attendi o chiedi un limite più alto. |
| RATE_LIMITED | 429 | Troppe richieste. | Rallenta (details.retryAfterMs). |
| SERVICE_UNAVAILABLE | 503 | Vendita temporaneamente non disponibile. Non è stato addebitato nulla. | Riprova con backoff esponenziale. |
| INTERNAL_ERROR | 500 | Errore imprevisto (registrato con requestId). | Riprova con la stessa Idempotency-Key. |
Limiti
| Limite | Valore |
|---|---|
| Richieste per chiave | 20 / secondo e 600 / minuto |
| Ordini per account | 120 / minuto |
| Download di chiavi per account | 300 / minuto |
| Righe per ordine / unità per riga | 10 / 9 |
| Valore dell'ordine e spesa nelle 24 ore | Per account (vedi Dashboard → Panoramica); chiedici di aumentarli |
| Dimensione della pagina | 100 prodotti (fields=full), 500 (fields=summary), 100 ordini |
| Filtro ids | 200 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.
