Pour les boutiques en ligne et les développeurs
Vendez tout notre catalogue dans votre boutique. Nous livrons les clés.
Jeux, DLC, logiciels, Windows et Office, cartes cadeaux et abonnements, par API REST ou avec le plugin WordPress. Quand votre client paie, la clé est achetée et livrée automatiquement, puis débitée de votre solde prépayé (par exemple, vous rechargez 500 € et chaque commande est débitée toute seule) ou de votre Wallet.
2 % moins cher que notre site
Le prix de l'API est le prix de notre site moins 2 %, sur chaque produit du catalogue.
Sans frais de service
Le site ajoute des frais à la caisse. L'API non : vous payez le prix de l'API et rien d'autre.
Solde prépayé ou Wallet
Vous rechargez une fois, puis chaque commande est débitée automatiquement. Si le solde ne suffit pas, le Wallet de votre compte complète.
Compatible avec
- 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-…" } ] }Promotion en cours
20 % de réduction sur tous les produits Microsoft
Ajoute le code à tes commandes et paie 20 % de moins pour chaque licence Windows, Office, Visio, Project et SQL Server. Sans frais ni minimum.
Champ de l’API
"couponCode": "MICROSOFT20"En bref
BuyCheapKeys propose aux boutiques en ligne une API REST et un plugin WordPress/WooCommerce pour revendre tout son catalogue : jeux, DLC, logiciels, Windows et Office, cartes cadeaux et abonnements. Le prix de l'API est le prix du site moins 2 %, sans frais de service. La boutique importe les fiches produit dans une ou plusieurs des 7 langues, garde prix et stock synchronisés avec un curseur et commande une clé quand son propre client paie. La clé est en général renvoyée dans la réponse de commande (ou plus tard par webhook si la commande est encore en cours), payée avec le solde prépayé de la boutique ou son Wallet. Un sandbox gratuit est disponible.
Mis à jour:
Le catalogue que vous pouvez vendre, en direct
Ces chiffres viennent directement de l'API et se mettent à jour toutes les quelques minutes. Les prix ne sont pas publiés sur cette page : vous les voyez avec votre clé.
- 33 457
- produits en stock
- 19
- plateformes avec du stock
- 32 839
- jeux et DLC en stock
- 498
- logiciels en stock
- 120
- abonnements en stock
Plateformes avec le plus de produits
- Steam 25 960
- Xbox 4 579
- PlayStation 1 119
- GOG 426
- Epic Games 410
- Ubisoft Connect 330
- PC 305
- Microsoft 137
- EA App 120
- Rockstar 17
- Nintendo 13
- Mac 11
Une partie de ce que vous pouvez vendre aujourd'hui
Un échantillon de jaquettes du catalogue. Chaque produit vient avec sa fiche : description, étapes d'activation, configuration requise, captures et région.

Grand Theft Auto V Enhanced EU PC Rockstar Digital Download (Rockstar) - Clé Numérique Europe
RockstarClé

ELDEN RING NIGHTREIGN (Steam) - Clé Numérique États-Unis
SteamClé

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

EA Sports FC 24
EA AppClé

Minecraft Legends Deluxe Edition (Xbox Account)
XboxCompte

Baldur's Gate 3 (Steam Account)
SteamCompte

Forza Horizon 4 Ultimate Edition (Xbox Account)
XboxCompte

Call of Duty: Vanguard
XboxClé

Hogwarts Legacy
XboxClé

Hogwarts Legacy Digital Deluxe Edition (PS5 Account)
PlayStationCompte

Stardew Valley (Steam Gift) (Steam) - Clé Numérique Mondial
SteamLien cadeau

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

Microsoft Windows 11 Pro (PC) - Microsoft Key - GLOBAL (Microsoft) - Clé Numérique Mondial
MicrosoftClé

Microsoft Windows 10 / 11 Pro - 20 PC - Volume MAK
MicrosoftClé

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

Microsoft Windows 10 / 11 Pro - 1 PC - OEM
MicrosoftClé
Comment ça marche
- 01
Créez votre compte
Demandez l'accès partenaire et créez une clé sandbox pour tout essayer avec de fausses clés. Dans le sandbox, aucun argent ne bouge.
- 02
Importez le catalogue
Lisez l'endpoint des produits avec les filtres dont vous avez besoin (plateforme, région, type, prix) dans une ou plusieurs langues, puis gardez prix et stock à jour avec le curseur.
- 03
Votre client paie
La vente a lieu dans votre boutique, avec votre prix et vos moyens de paiement. Votre boutique envoie une seule requête : POST /orders avec le produit et le prix maximum que vous acceptez.
- 04
La clé est livrée
La clé revient en général dans la même réponse (si la commande est en "processing", elle arrive par webhook ou avec GET /orders/{id}/keys), est débitée de votre solde ou Wallet, et votre boutique l'envoie à votre client. Le plugin WordPress fait tout cela tout seul.
Filtres et formats
Ne vendez que ce qui convient à votre boutique. Tous les filtres fonctionnent sur l'endpoint des produits et se combinent.
Format de livraison
Clé à activer, lien cadeau (Steam Gift), compte ou lien d'activation. Chaque produit indique lequel c'est.
Plateforme
Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft et plus.
Région
La région de chaque clé et la liste exacte des pays où elle ne peut pas être activée.
Type de produit
Jeux, DLC, logiciels, Windows et Office, cartes cadeaux et abonnements.
Prix
Prix minimum et maximum, tri par prix, popularité, nom ou nouveauté.
Stock et changements
Seulement ce qui est en stock, ou seulement ce qui a changé depuis votre dernière synchronisation.
Fiches produit en 7 langues
Les noms, descriptions et étapes d'activation sont disponibles en anglais, espagnol, allemand, français, italien, portugais et polonais. Choisissez une langue ou importez-en plusieurs à la fois pour une boutique multilingue avec WPML ou Polylang. Chaque produit indique la langue réelle de son texte.
- en
- es
- de
- fr
- it
- pt
- pl
Payez avec un solde prépayé ou votre Wallet
Rechargez votre solde une fois, par exemple 500 €, et chaque commande est débitée automatiquement au moment où votre client paie. Si le solde ne suffit pas, le Wallet de votre compte couvre le reste. Chaque mouvement figure dans votre journal et un webhook vous prévient quand une recharge arrive.
Sandbox gratuit
Les clés sandbox (bck_test_) utilisent le vrai catalogue et les vrais prix, mais renvoient de fausses clés et un solde de test. Rien n'est débité et aucun vrai stock n'est utilisé : vous pouvez construire et tester tout le flux d'abord.
Webhooks signés
Soyez prévenu quand une commande est terminée ou remboursée, quand une clé est remplacée et quand les produits changent (products.updated et catalog.changed). Chaque événement est signé en HMAC-SHA256 et réessayé pendant environ une journée.
Plugin WordPress et WooCommerce
Si votre boutique tourne sous WordPress, vous n'avez pas besoin de coder. Installez le plugin, collez votre clé API et choisissez votre marge.
Version 1.1.0 · gratuit · WordPress + WooCommerce
Télécharger le plugin- Importe chaque produit avec sa fiche, ses étapes d'activation et sa configuration requise
- Met à jour prix et stock automatiquement, avec votre marge et votre arrondi
- Vérifie le panier avant le paiement et bloque les produits qui ne peuvent pas être livrés
- Achète la clé quand la commande est payée et l'envoie par e-mail à votre client
- Affiche la clé sur la page de la commande et dans Mon compte, stockée chiffrée
- Réessaie tout seul en cas d'échec et vous prévient par e-mail
Documentation de l'API
Tout ce qu'il faut pour intégrer : authentification, synchronisation du catalogue, filtres, commandes, livraison des clés, réclamations, webhooks, erreurs et limites.
Lire la documentation de l'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 } ] }'Plateformes
Compatible avec Shopify, Shopware, Magento, PrestaShop et toute autre plateforme de boutiques
Si votre plateforme peut envoyer une requête quand une commande est payée, elle peut vendre notre catalogue. Cela couvre la liste ci-dessous, avec plus de 120 noms, et toute boutique que vous avez codée vous-même. Le seul plugin que nous proposons aujourd'hui est celui de WooCommerce. Sur les autres, vous vous connectez via l'API REST.
Comment se connecter sur n'importe quelle plateforme
- 01
Catalogue
Lisez le point d'accès des produits pour importer noms, descriptions, étapes d'activation et visuels, et pour garder prix et stock à jour.
- 02
Commande payée
Votre plateforme déclenche son événement de commande payée : un webhook, un hook, un flux ou une tâche planifiée. Cet événement appelle POST /orders avec le produit et le prix maximum que vous acceptez.
- 03
Livraison
La réponse contient la clé. Votre boutique l'envoie par e-mail au client et l'affiche dans la commande. Si la clé n'est pas encore prête, le webhook order.completed vous prévient quand elle l'est.
Voies courantes selon la plateforme
Chaque plateforme réagit à sa manière à une commande payée. Voici celles qu'utilisent la plupart des boutiques. Votre développeur, ou un outil comme Zapier ou Make, peut mettre en place n'importe laquelle.
- 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
Toutes les plateformes par type
Créateurs de boutiques hébergées
- 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 et auto-hébergé
- 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 d'entreprise et 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
Logiciels de places de marché
- Dokan
- WCFM Marketplace
- WC Vendors
- CS-Cart Multi-Vendor
- Mirakl
- Sharetribe
- Arcadier
- Marketplacer
- Yo!Kart
Vente de produits numériques
- Easy Digital Downloads
- Gumroad
- Lemon Squeezy
- Paddle
- FastSpring
- Sellfy
- SendOwl
- Payhip
- Podia
- Sellix
ERP et suites de gestion
- Odoo eCommerce
- ERPNext
- NetSuite SuiteCommerce
- Microsoft Dynamics 365 Commerce
- plentymarkets
Plateformes régionales
- 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
Outils d'automatisation
- Zapier
- Make
- n8n
- Pipedream
- Microsoft Power Automate
Boutiques sur mesure
- Laravel
- Symfony
- Django
- Ruby on Rails
- Node.js
- Next.js
- Nuxt
- ASP.NET
- Spring Boot
- Go
Votre plateforme n'est pas dans la liste ?
Si elle peut appeler une URL quand un paiement est confirmé, elle fonctionne. Écrivez à partners@buycheapkeys.com et nous vous indiquerons le bon déclencheur.
Questions fréquentes
Quelle est la meilleure API pour revendre des clés de jeux ?
Combien coûte l'API revendeur de BuyCheapKeys ?
Comment vendre des clés de jeux dans ma boutique WooCommerce ?
Puis-je l'utiliser avec Shopify, Magento, Shopware, PrestaShop ou ma propre boutique ?
Quels produits puis-je vendre ?
Comment les clés sont-elles livrées ?
Comment payer les commandes ?
Dans quelles langues les fiches produit sont-elles disponibles ?
Comment garder prix et stock synchronisés ?
Puis-je tester l'API sans payer ?
Que se passe-t-il si une clé ne fonctionne pas ?
Commencez à vendre tout le catalogue
Créez un compte partenaire, testez dans le sandbox et passez en production quand vous voulez.
BuyCheapKeys est un revendeur indépendant. Les noms de plateformes et de marques appartiennent à leurs propriétaires et ne servent qu'à décrire la compatibilité. Vérifiez que le type de licence et la région conviennent à vos clients et à la loi de votre pays.
Documentation de l'API
Sommaire
- Vue d'ensemble
- Authentification et environnements
- Démarrage rapide
- Catalogue et synchronisation
- Filtres, tri et langues
- Champs du produit
- Commandes
- Livraison des clés
- Réclamations et remboursements
- Cartes cadeaux BuyCheapKeys en gros
- Webhooks
- Erreurs
- Limites
- Solde, Wallet et recharges
- Implémentation avec un assistant IA
- Liste de contrôle avant la mise en production
API REST/JSON pour vendre tout le catalogue BuyCheapKeys sur votre propre site. Le prix API correspond au prix du site moins 2 %, sans frais de service. Chaque commande est payée avec votre solde prépayé (ou votre Wallet) et les clés reviennent dans la même réponse.
Vue d'ensemble
URL de base : https://buycheapkeys.com/partner-api/v1. Toutes les requêtes et réponses sont en JSON (UTF-8). Les prix sont en EUR avec deux décimales, hors TVA. Les dates suivent la norme ISO 8601 en UTC.
- Catalogue : tout le catalogue du site (jeux, DLC, logiciels, Windows et Office, cartes cadeaux, abonnements) avec des fiches produit en 7 langues (en, es, de, fr, it, pt, pl).
- Prix : prix API = prix du site moins 2 %, et aucun frais de service (le site facture des frais au paiement ; l'API non).
GET /merenvoiediscountPercentetserviceFee: 0. - Commandes : achetez jusqu'à 10 lignes x 9 unités par requête ; le total est débité en une fois de votre solde prépayé et, s'il ne suffit pas, de votre Wallet.
- Livraison : les clés figurent dans la réponse de la commande et peuvent être relues avec GET /orders/{id}/keys.
- Réclamations : une clé défectueuse peut être réclamée pendant 14 jours depuis votre tableau de bord partenaire ; une clé de remplacement arrive automatiquement dans votre commande et un remboursement est crédité sur votre solde.
WordPress/WooCommerce ? Utilisez le plugin (voir la section Plugin ci-dessus) : il importe le catalogue, maintient prix et stock à jour et livre les clés sans écrire de code.
Authentification et environnements
Créez vos clés dans Tableau de bord → Partenaire → Clés API. Une clé n'est affichée qu'une seule fois ; nous ne conservons que son empreinte (hash). Envoyez-la dans l'en-tête Authorization (X-Api-Key est également accepté).
curl https://buycheapkeys.com/partner-api/v1/ping \
-H "Authorization: Bearer bck_test_xxxxxxxxxxxx_..."| Préfixe de clé | Mode | Comportement |
|---|---|---|
| bck_test_ | Sandbox | Catalogue et prix réels, solde de test distinct (réinitialisable), fausses clés du type TEST-AB12C-…, aucun mouvement d'argent. Les webhooks sont envoyés avec mode: test. |
| bck_live_ | Production | Achats réels débités de votre solde réel (et de votre Wallet). |
| Scope | Autorise |
|---|---|
| catalog:read | GET /products, /products/{id}, /meta, /me, /ping, /gift-cards |
| webhooks:write | PUT, GET et DELETE /webhook (enregistrer ou supprimer l'URL de votre 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 |
Liste d'autorisation d'IP facultative (IPv4/IPv6, CIDR) par compte. Les clés n'expirent jamais tant qu'elles ne sont pas révoquées ; effectuez la rotation en créant une nouvelle clé puis en révoquant l'ancienne. GET /public/catalog ne nécessite aucune clé.
Démarrage rapide
1) Créez une clé bck_test_. 2) Listez les produits. 3) Passez une commande : elle revient terminée, avec les clés. 4) Relisez les clés à tout moment avec GET /orders/{id}/keys. Les comptes dont la validation est en cours peuvent utiliser des clés sandbox.
curl "https://buycheapkeys.com/partner-api/v1/products?lang=en&limit=100&inStock=true" \n -H "Authorization: Bearer $BCK_API_KEY"Catalogue et synchronisation
GET /products renvoie les produits triés par updatedAt (puis par id). updatedAt ne change que lorsqu'un élément qui vous concerne change (prix, stock, nom, région, textes, images). Synchronisez avec le curseur : chaque réponse contient nextCursor et hasMore ; renvoyez nextCursor dans ?cursor= jusqu'à ce que hasMore soit false, puis conservez-le pour la prochaine exécution. Le curseur ne saute ni ne répète jamais de produits, même lorsque beaucoup partagent le même horodatage (il suit toujours updatedAt ; sort ne s'applique que lorsque vous parcourez par pages).
Deux formats : fields=full (par défaut, jusqu'à 100 produits par page) est la fiche complète ; fields=summary (jusqu'à 500 par page) ne renvoie que id, price, shopPrice, currency, inStock, qty, updatedAt et removed, idéal pour tenir prix et stock à jour chaque minute.
# 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"- Recommandé : une importation complète (fields=full, dans la ou les langues de votre boutique), puis toutes les 1 à 5 minutes
fields=summaryà partir dunextCursorenregistré, toujours avecincludeRemoved=true. - Disponibilité : si le site ne peut pas vendre un produit (plus de stock, stock désactivé, coût supérieur à notre plafond), il apparaît en
inStock: false, qty: 0en moins d'une minute ; un produit masqué ou supprimé aremoved: true. Ne les vendez jamais. - Les changements du catalogue sont annoncés par webhook (
products.updated,catalog.changed) : le polling peut donc être peu fréquent. GET /public/catalog?lang=(sans clé, en cache 10 minutes) renvoie des chiffres en direct et quelques visuels mis en avant pour votre propre page d'accueil.
Filtres, tri et langues
lang (en, es, de, fr, it, pt, pl ; en par défaut) choisit la langue des noms et des descriptions. Chaque produit a un champ language avec la langue réelle du texte (en lorsqu'une traduction manque). Une langue ou plusieurs : appelez l'API une fois par langue, ou importez les sept pour les boutiques multilingues WPML/Polylang. Les listes acceptent des valeurs séparées par des virgules.
| Paramètre | Valeurs / signification |
|---|---|
| platform | Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft, … (voir /meta) |
| region | Libellé de région (Global, Europe, …) ; voir /meta |
| productType | game, dlc, software, gift-card, gift, subscription, game-point |
| deliveryType | key, gift (lien Steam Gift), account, link (lien d'activation) |
| category | game, dlc, software, microsoft, gift-card, gift, subscription |
| genre | Nom du genre (voir /meta) |
| minPrice / maxPrice | EUR, prix API |
| inStock | true pour ne lister que ce qui peut être vendu maintenant |
| search | Tous les mots, recherchés dans le nom et le titre traduit |
| ids | Jusqu'à 200 ids de produits |
| updatedSince / includeRemoved | Modifications depuis une date ; inclure les produits retirés |
| sort | updated, popularity, name, price_asc, price_desc, newest (avec pages ; le curseur de synchronisation suit toujours updatedAt) |
| fields / limit / cursor / page | full ou summary ; jusqu'à 100 (full) ou 500 (summary) ; cursor pour la synchronisation ; page pour la navigation |
# 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 renvoie les facettes avec leurs compteurs et le stock (plateformes, régions, types de produit, genres, langues, fourchette de prix, valeurs de tri) pour que vous puissiez construire vos propres filtres.
Champs du produit
{
"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
}| Champ | Signification |
|---|---|
| price | Votre prix unitaire en EUR : prix du site moins 2 %. Revérifié en direct lors de la commande. |
| shopPrice / discountPercent | Prix du site et votre remise (2). |
| rrp | Prix public réel lorsqu'il est supérieur au prix API ; sinon null. |
| deliveryType | key = code à activer · gift = lien Steam Gift · account = identifiants de connexion · link = lien d'activation. Indiquez à votre client ce qu'il achète. |
| region / activation | Libellé de région et liste ISO exacte des pays où il NE peut PAS être activé. |
| productType / category / edition / licenseType | Classification du produit. |
| language | Langue des textes de cette réponse. |
| shortDescription / description / descriptionHtml / features | Textes. descriptionHtml est du HTML propre, sans liens ni images. |
| activationSteps / activationDetails / systemRequirements | Instructions d'activation et configuration requise. |
| languages / genres / developer / publisher / releaseDate / ageRating | Données du jeu. |
| coverImage / screenshots / videos | Images de notre CDN (mettez-les en cache de votre côté) et vidéos YouTube. |
| qty | Unités en stock (plafonné à 999). |
| url | Page produit publique sur le site. |
Commandes
POST /orders avec externalId (votre référence unique) et items (productId, qty 1–9, maxUnitPrice). Pour chaque ligne, nous vérifions le prix réel : s'il dépasse maxUnitPrice, toute la commande est rejetée avec PRICE_CHANGED et rien n'est débité. S'il est inférieur, vous payez le prix inférieur. La source la moins chère disposant de stock vend, comme sur le site.
Recommandé : envoyez storeUrl (l'URL de votre boutique où le produit est vendu) dans le corps de POST /orders, ou l'en-tête X-Store-Url sur n'importe quel appel. C'est facultatif ; le plugin WordPress envoie automatiquement l'URL de votre site.
Code promo : ajoutez couponCode: MICROSOFT20 pour payer 20 % de moins sur les produits Microsoft (Windows, Office, Visio, Project, SQL Server) tant que la promotion est active. Il ne s'applique qu'à ces lignes ; un code inconnu ou une promotion terminée renvoie INVALID_COUPON et rien n'est débité.
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
}- Envoyez un en-tête
Idempotency-Key(8 à 100 caractères) et réutilisez-le lors des nouvelles tentatives : vous obtenez la réponse d'origine et n'êtes jamais débité deux fois.externalIdest également unique par compte. - La commande est terminée dans la même requête (
?wait=20attend jusqu'à 20 s) : la réponse a le statutcompletedet un tableaukeys. Une requête rejouée renvoie la commande sans ses clés et aveckeysOmitted: true: lisez-les avec GET /orders/{id}/keys. - Pas de stock ou solde insuffisant : rien n'est débité et aucune clé n'est utilisée (
OUT_OF_STOCK,INSUFFICIENT_BALANCE).maxUnitPriceest un plafond pour chaque clé. - Si une requête expire (timeout), renvoyez-la avec le même externalId : vous obtenez
DUPLICATE_EXTERNAL_IDavec l'id de la commande et pouvez en lire les clés.
| Statut | Signification |
|---|---|
| completed | Toutes les unités sont livrées. Les clés figurent dans la réponse. |
| partially_refunded | Certaines clés ont été remboursées sur votre solde après des réclamations. |
| refunded | Toutes les clés de la commande ont été remboursées sur votre solde. |
Livraison des clés
GET /orders/{id}/keys renvoie chaque unité livrée : value contient le code, l'URL Steam Gift, les identifiants du compte ou le lien d'activation selon deliveryType. contentType vaut text/plain ou un type d'image (dans ce cas value est en base64).
Stockez les clés chiffrées et ne les montrez qu'à l'acheteur. Le premier téléchargement de chaque commande est consigné de notre côté comme preuve de livraison.
Réclamations et remboursements
Une clé défectueuse peut être réclamée pendant 14 jours. Ouvrez la commande dans Tableau de bord → Commandes (commandes API), choisissez la clé, écrivez au vendeur et joignez des captures d'écran de l'erreur d'activation. Le vendeur peut envoyer une clé de remplacement (elle apparaît dans votre commande et vous recevez le webhook key.replaced) ou rembourser la clé (le prix est recrédité une seule fois sur votre solde API et vous recevez order.refunded). Si vous n'êtes pas d'accord, escaladez : BuyCheapKeys tranche.
Vérifiez la région, excludedCountries et le type de licence avant de vendre, et présentez-les à votre client. Un remboursement sur votre solde ne rembourse pas votre propre client : c'est à vous d'en décider.
Cartes cadeaux BuyCheapKeys en gros
Outre les cartes cadeaux d'autres marques (ce sont des produits du catalogue, productType=gift-card), vous pouvez acheter nos propres cartes cadeaux pour les revendre : des codes BCK-XXXX-XXXX-XXXX-XXXX qui ajoutent leur valeur au Wallet BuyCheapKeys de la personne qui les utilise sur buycheapkeys.com/wallet. GET /gift-cards renvoie les valeurs en vente, les remises de volume, les maximums par commande et le solde de votre Wallet. POST /gift-cards/orders achète N cartes d'une même valeur et renvoie aussitôt les codes ; GET /gift-cards/orders/{id} les affiche à nouveau avec le statut de chaque code.
curl https://buycheapkeys.com/partner-api/v1/gift-cards \
-H "Authorization: Bearer $BCK_API_KEY"- Payé uniquement avec le Wallet BuyCheapKeys du compte de votre boutique (rechargez-le sur buycheapkeys.com/wallet), et non avec le solde API. Prix = valeur faciale moins la remise de volume correspondant à la quantité.
- Les valeurs, remises et maximums peuvent changer : envoyez
maxTotalpour refuser un total plus élevé (PRICE_CHANGED, rien n'est débité).Idempotency-Keyet l'externalIdunique fonctionnent comme pour les commandes. - Vente suspendue :
PRODUCT_UNAVAILABLE(409). Valeur non vendue ou quantité hors limites :VALIDATION_ERROR. Commande trop volumineuse :ORDER_LIMIT_EXCEEDED. Solde Wallet insuffisant :INSUFFICIENT_BALANCE(402). - Les clés sandbox renvoient de faux codes
BCK-TEST-…qui ne peuvent pas être utilisés et ne débitent rien. - Les codes vendus sont définitifs. Chaque code a une date d'expiration (
expiresAt) et des limites d'utilisation par compte. Un code que nous bloquons pour fraude n'est plus affiché (code: null, statutblocked). Stockez les codes chiffrés.
Webhooks
Définissez une URL https dans Tableau de bord → Webhooks (ou PUT /webhook) ; vous recevez un secret de signature (whsec_…). Chaque événement est un POST avec les en-têtes X-BCK-Event, X-BCK-Delivery (id unique : dédoublonnez dessus) et X-BCK-Signature: t=<unix>,v1=<hex> où v1 = HMAC-SHA256(secret, t + "." + rawBody).
| Événement | Quand |
|---|---|
| order.completed | Une commande a été terminée. |
| order.refunded | Une réclamation s'est soldée par un remboursement sur votre solde (`refundedSale`, `amount`). |
| products.updated | Le prix, le stock ou la disponibilité de produits ont changé : `data.products` contient jusqu'à 100 produits au format summary par événement (`removed: true` lorsqu'ils sont retirés). |
| catalog.changed | Plus de 1000 produits ont changé d'un coup : lancez la synchronisation par curseur (`fields=summary`) au lieu de lire l'événement. |
| product.updated | Uniquement pour les produits Windows et Office gérés manuellement (plugin 1.0) : `data.product` contient le produit complet. |
| key.replaced | Un vendeur a remplacé une clé : `oldKeyId`, `newKeyId` ; lisez la nouvelle clé avec GET /orders/{id}/keys. |
| balance.credited | Une recharge a été ajoutée à votre solde. |
| webhook.test | Envoyé par POST /webhooks/test ou par le bouton du tableau de bord. |
{
"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}" }
}- Répondez en 2xx en moins de 8 s et effectuez le traitement de manière asynchrone. Les redirections ne sont pas suivies.
- Les envois échoués sont retentés après 10 s, 30 s, 1 min, 5 min, 15 min, 30 min, 1 h, 2 h, 4 h, 6 h et 12 h (~26 h).
- Les événements peuvent arriver dans le désordre ou plusieurs fois : relisez toujours GET /orders/{id} ou le curseur en cas de doute.
Erreurs
Les erreurs utilisent les codes de statut HTTP et un code stable. Indiquez le requestId lorsque vous contactez le support.
{
"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 | Signification | Que faire |
|---|---|---|---|
| UNAUTHORIZED | 401 | Clé absente, invalide, révoquée ou expirée. | Vérifiez la clé ; créez-en une nouvelle dans le tableau de bord. |
| ACCOUNT_NOT_ACTIVE | 403 | Compte partenaire en attente, suspendu ou refusé. | Contactez-nous. |
| IP_NOT_ALLOWED | 403 | L'IP de la requête ne figure pas dans votre liste d'autorisation. | Ajoutez l'IP dans Tableau de bord → Webhooks et sécurité. |
| INSUFFICIENT_SCOPE | 403 | La clé n'a pas le scope requis pour ce endpoint. | Créez une clé avec ce scope. |
| NOT_FOUND | 404 | Produit, commande ou route inconnus. | — |
| VALIDATION_ERROR | 400 | Corps ou paramètres invalides (details liste chaque champ). | Corrigez la requête ; ne la renvoyez pas telle quelle. |
| INSUFFICIENT_BALANCE | 402 | Solde insuffisant. Rien n'a été débité. | Rechargez votre solde et réessayez. |
| PRICE_CHANGED | 409 | Le prix unitaire réel dépasse maxUnitPrice. Rien n'a été débité. | Mettez le prix à jour (details.currentPrice) et réessayez. |
| INVALID_COUPON | 400 | couponCode inconnu, ou promotion terminée. Rien n'a été débité. | Retirez le code ou envoyez celui qui est actif (MICROSOFT20). |
| OUT_OF_STOCK | 409 | Pas assez d'unités disponibles. Rien n'a été débité. | Réessayez plus tard ou masquez le produit. |
| PRODUCT_UNAVAILABLE | 409 | Produit non vendable via l'API. | Retirez-le de votre boutique. |
| DUPLICATE_EXTERNAL_ID | 409 | externalId déjà utilisé ; details.orderId est la commande existante. | Récupérez cette commande à la place. |
| IDEMPOTENCY_CONFLICT | 409 | Idempotency-Key réutilisée avec un corps différent. | Utilisez une nouvelle clé par commande. |
| IDEMPOTENCY_IN_PROGRESS | 409 | La même Idempotency-Key est encore en cours de traitement. | Réessayez dans quelques secondes. |
| ORDER_LIMIT_EXCEEDED | 422 | Total de la commande supérieur à votre limite par commande. | Scindez la commande ou demandez une limite plus élevée. |
| DAILY_LIMIT_EXCEEDED | 422 | Limite de dépenses sur 24 heures atteinte. | Patientez ou demandez une limite plus élevée. |
| RATE_LIMITED | 429 | Trop de requêtes. | Ralentissez (details.retryAfterMs). |
| SERVICE_UNAVAILABLE | 503 | Vente temporairement impossible. Rien n'a été débité. | Réessayez avec un backoff exponentiel. |
| INTERNAL_ERROR | 500 | Erreur inattendue (journalisée avec requestId). | Réessayez avec la même Idempotency-Key. |
Limites
| Limite | Valeur |
|---|---|
| Requêtes par clé | 20 / seconde et 600 / minute |
| Commandes par compte | 120 / minute |
| Téléchargements de clés par compte | 300 / minute |
| Lignes par commande / unités par ligne | 10 / 9 |
| Montant de la commande et dépenses sur 24 heures | Par compte (voir Tableau de bord → Vue d'ensemble) ; demandez-nous de les augmenter |
| Taille de page | 100 produits (fields=full), 500 (fields=summary), 100 commandes |
| Filtre ids | 200 ids |
Solde, Wallet et recharges
Les commandes sont débitées de votre solde API prépayé et, s'il ne suffit pas, du Wallet de votre compte. GET /balance renvoie le solde du mode de la clé ; GET /me indique aussi walletBalance et available. Rechargez depuis Tableau de bord → Solde (par exemple 500 EUR, puis chaque commande est débitée automatiquement) : vous recevez une référence unique pour le virement bancaire, ou vous pouvez payer en ligne ; le montant est crédité à son arrivée (e-mail + webhook balance.credited). Chaque mouvement apparaît dans le grand livre.
Implémentation avec un assistant IA
Documentation lisible par machine : https://buycheapkeys.com/reseller-api.md (cette page en Markdown ; /reseller-api.es.md en espagnol), la spécification OpenAPI 3.1 https://buycheapkeys.com/partner-api/v1/openapi.json et https://buycheapkeys.com/llms.txt. Donnez ces URL à votre assistant IA avec le prompt ci-dessous.
Intégration de référence complète (Node.js 18+, sans dépendances) : https://buycheapkeys.com/developers/bck-partner-client.mjs : synchronisation du catalogue avec curseur, commande sécurisée avec nouvelles tentatives et idempotence, téléchargement des clés et récepteur de webhook avec vérification de la signature.
curl -O https://buycheapkeys.com/developers/bck-partner-client.mjs
export BCK_API_KEY=bck_test_... # clé sandbox depuis Tableau de bord → Partenaire → Clés API
node bck-partner-client.mjs balance
node bck-partner-client.mjs sync
node bck-partner-client.mjs order <productId> 1 <maxUnitPrice>- Invariant 1 : ne vendez que des produits avec inStock=true et removed=false ; resynchronisez toutes les 1 à 5 min depuis le nextCursor enregistré.
- Invariant 2 : une commande client = un externalId = une Idempotency-Key ; réutilisez les deux à chaque nouvelle tentative.
- Invariant 3 : envoyez toujours maxUnitPrice ; les erreurs métier 4xx sont définitives et rien n'a été débité.
- Invariant 4 : ne réessayez que les erreurs réseau, 429, 5xx et IDEMPOTENCY_IN_PROGRESS, avec un backoff exponentiel.
- Invariant 5 : ne repassez jamais commande après un timeout : répétez le même externalId et lisez les clés de la commande existante.
- Invariant 6 : gardez la clé API côté serveur ; vérifiez les signatures des webhooks ; montrez aux clients le deliveryType, la région et les pays exclus.
Liste de contrôle avant la mise en production
- Conservez les clés API uniquement sur votre serveur (jamais dans les navigateurs ni les applications), dans un gestionnaire de secrets ou des variables d'environnement.
- Utilisez des clés distinctes par système, avec les scopes minimaux ; activez la liste d'autorisation d'IP.
- Envoyez toujours maxUnitPrice et une Idempotency-Key, ainsi que storeUrl (ou l'en-tête X-Store-Url) avec l'URL de votre boutique.
- Vérifiez la signature et l'horodatage de chaque webhook avant de lui faire confiance.
- Testez tout le flux avec une clé bck_test_, puis passez à bck_live_ et rechargez votre solde.
- Effectuez la rotation des clés et du secret de webhook en cas de soupçon de fuite, puis révoquez les anciens.
