-20 %

20 % de réduction sur Windows et Office

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

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

    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

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

    SteamClé

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

    EA SPORTS FC 26 PS4/PS5 (PS4 Account)

    PlayStationCompte

  • EA Sports FC 24

    EA Sports FC 24

    EA AppClé

  • Minecraft Legends Deluxe Edition (Xbox Account)

    Minecraft Legends Deluxe Edition (Xbox Account)

    XboxCompte

  • Baldur's Gate 3 (Steam Account)

    Baldur's Gate 3 (Steam Account)

    SteamCompte

  • Forza Horizon 4 Ultimate Edition (Xbox Account)

    Forza Horizon 4 Ultimate Edition (Xbox Account)

    XboxCompte

  • Call of Duty: Vanguard

    Call of Duty: Vanguard

    XboxClé

Comment ça marche

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

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

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

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

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

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

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

Créer un compte partenaire

Questions fréquentes

Quelle est la meilleure API pour revendre des clés de jeux ?
Cela dépend de vos besoins ; voici donc ce que propose l'API revendeur de BuyCheapKeys : tout le catalogue de notre site (jeux, DLC, logiciels, Windows et Office, cartes cadeaux, abonnements) au prix du site moins 2 %, sans frais de service, des fiches en 7 langues, des filtres par plateforme, région, type et prix, un curseur pour la synchronisation incrémentale, des webhooks signés, un sandbox gratuit et un plugin WordPress/WooCommerce. Les clés reviennent en général dans la même réponse de commande ; si un produit doit être acheté auprès d'une source de gros, la commande passe en "processing" et les clés arrivent par webhook.
Combien coûte l'API revendeur de BuyCheapKeys ?
L'utilisation de l'API n'a pas de frais de service. Vous payez le prix API de chaque clé achetée, soit le prix de notre site moins 2 %, avec votre solde prépayé ou votre Wallet. Les recharges en ligne incluent les frais de la passerelle de paiement .
Comment vendre des clés de jeux dans ma boutique WooCommerce ?
Installez le plugin gratuit BuyCheapKeys pour WooCommerce (version 1.1.0), collez votre clé API et fixez votre marge. Il importe les produits, garde prix et stock à jour, achète la clé quand une commande est payée et l'envoie par e-mail à votre client.
Puis-je l'utiliser avec Shopify, Magento, Shopware, PrestaShop ou ma propre boutique ?
Oui, via l'API REST. L'événement de commande payée de votre plateforme (un webhook, un hook ou une tâche planifiée) appelle POST /orders et votre boutique remet la clé. Seul WooCommerce dispose aujourd'hui d'un plugin prêt à l'emploi. La documentation inclut un client de référence en Node.js sans dépendances.
Quels produits puis-je vendre ?
Tout le catalogue du site qui est en stock : jeux et DLC pour Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App et Nintendo, logiciels, licences Windows et Office, cartes cadeaux et abonnements. Les chiffres en direct sont en haut de cette page.
Comment les clés sont-elles livrées ?
En général dans la réponse à la requête de commande, ce qui permet à votre boutique de les afficher et de les envoyer par e-mail à votre client immédiatement. Quand un produit doit être acheté auprès d'une source de gros, cela peut prendre quelques secondes ou minutes : la commande est alors en "processing" et les clés arrivent par webhook (order.completed) ou avec GET /orders/{id}/keys (vous pouvez ajouter ?wait=25 pour les attendre). Chaque produit indique son type de livraison : clé à activer, lien Steam Gift, compte ou lien d'activation. Vous pouvez relire les clés avec l'endpoint des clés.
Comment payer les commandes ?
Avec un solde API prépayé. Par exemple, vous rechargez 500 € et chaque commande est débitée automatiquement quand elle est passée. Si le solde ne suffit pas, le Wallet de votre compte couvre la différence. Si ni l'un ni l'autre ne suffit, la commande est refusée et rien n'est débité.
Dans quelles langues les fiches produit sont-elles disponibles ?
Anglais, espagnol, allemand, français, italien, portugais et polonais. Utilisez le paramètre lang pour en choisir une ou importez-en plusieurs pour une boutique multilingue. Si une traduction manque, le texte anglais est renvoyé et le produit l'indique.
Comment garder prix et stock synchronisés ?
Faites une importation complète une fois, puis appelez l'endpoint des produits toutes les quelques minutes avec fields=summary et le curseur enregistré : il ne renvoie que ce qui a changé (prix, stock, retiré). Les webhooks (products.updated et catalog.changed) vous disent aussi quand synchroniser.
Puis-je tester l'API sans payer ?
Oui. Les clés sandbox renvoient de fausses clés et utilisent un solde de test. Le catalogue et les prix sont réels, rien n'est débité et aucun vrai stock n'est utilisé.
Que se passe-t-il si une clé ne fonctionne pas ?
Les clés des vendeurs de la marketplace peuvent être réclamées pendant 14 jours depuis votre panneau partenaire, avec messages et captures. Si la réclamation est acceptée, vous recevez une clé de remplacement dans la même commande ou le prix revient sur votre solde. Les autres clés sont traitées par le support dans le cadre de la garantie.

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

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.

URL de base: https://buycheapkeys.com/partner-api/v1 Télécharger la spécification OpenAPI 3.1

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 /me renvoie discountPercent et serviceFee: 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éModeComportement
bck_test_SandboxCatalogue 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_ProductionAchats réels débités de votre solde réel (et de votre Wallet).
ScopeAutorise
catalog:readGET /products, /products/{id}, /meta, /me, /ping, /gift-cards
webhooks:writePUT, GET et DELETE /webhook (enregistrer ou supprimer l'URL de votre 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

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 du nextCursor enregistré, toujours avec includeRemoved=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: 0 en moins d'une minute ; un produit masqué ou supprimé a removed: 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ètreValeurs / signification
platformSteam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft, … (voir /meta)
regionLibellé de région (Global, Europe, …) ; voir /meta
productTypegame, dlc, software, gift-card, gift, subscription, game-point
deliveryTypekey, gift (lien Steam Gift), account, link (lien d'activation)
categorygame, dlc, software, microsoft, gift-card, gift, subscription
genreNom du genre (voir /meta)
minPrice / maxPriceEUR, prix API
inStocktrue pour ne lister que ce qui peut être vendu maintenant
searchTous les mots, recherchés dans le nom et le titre traduit
idsJusqu'à 200 ids de produits
updatedSince / includeRemovedModifications depuis une date ; inclure les produits retirés
sortupdated, popularity, name, price_asc, price_desc, newest (avec pages ; le curseur de synchronisation suit toujours updatedAt)
fields / limit / cursor / pagefull 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
}
ChampSignification
priceVotre prix unitaire en EUR : prix du site moins 2 %. Revérifié en direct lors de la commande.
shopPrice / discountPercentPrix du site et votre remise (2).
rrpPrix public réel lorsqu'il est supérieur au prix API ; sinon null.
deliveryTypekey = code à activer · gift = lien Steam Gift · account = identifiants de connexion · link = lien d'activation. Indiquez à votre client ce qu'il achète.
region / activationLibellé de région et liste ISO exacte des pays où il NE peut PAS être activé.
productType / category / edition / licenseTypeClassification du produit.
languageLangue des textes de cette réponse.
shortDescription / description / descriptionHtml / featuresTextes. descriptionHtml est du HTML propre, sans liens ni images.
activationSteps / activationDetails / systemRequirementsInstructions d'activation et configuration requise.
languages / genres / developer / publisher / releaseDate / ageRatingDonnées du jeu.
coverImage / screenshots / videosImages de notre CDN (mettez-les en cache de votre côté) et vidéos YouTube.
qtyUnités en stock (plafonné à 999).
urlPage 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. externalId est également unique par compte.
  • La commande est terminée dans la même requête (?wait=20 attend jusqu'à 20 s) : la réponse a le statut completed et un tableau keys. Une requête rejouée renvoie la commande sans ses clés et avec keysOmitted: 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). maxUnitPrice est un plafond pour chaque clé.
  • Si une requête expire (timeout), renvoyez-la avec le même externalId : vous obtenez DUPLICATE_EXTERNAL_ID avec l'id de la commande et pouvez en lire les clés.
StatutSignification
completedToutes les unités sont livrées. Les clés figurent dans la réponse.
partially_refundedCertaines clés ont été remboursées sur votre solde après des réclamations.
refundedToutes 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 maxTotal pour refuser un total plus élevé (PRICE_CHANGED, rien n'est débité). Idempotency-Key et l'externalId unique 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, statut blocked). 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énementQuand
order.completedUne commande a été terminée.
order.refundedUne réclamation s'est soldée par un remboursement sur votre solde (`refundedSale`, `amount`).
products.updatedLe 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.changedPlus de 1000 produits ont changé d'un coup : lancez la synchronisation par curseur (`fields=summary`) au lieu de lire l'événement.
product.updatedUniquement pour les produits Windows et Office gérés manuellement (plugin 1.0) : `data.product` contient le produit complet.
key.replacedUn vendeur a remplacé une clé : `oldKeyId`, `newKeyId` ; lisez la nouvelle clé avec GET /orders/{id}/keys.
balance.creditedUne recharge a été ajoutée à votre solde.
webhook.testEnvoyé 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"
  }
}
codeHTTPSignificationQue faire
UNAUTHORIZED401Clé absente, invalide, révoquée ou expirée.Vérifiez la clé ; créez-en une nouvelle dans le tableau de bord.
ACCOUNT_NOT_ACTIVE403Compte partenaire en attente, suspendu ou refusé.Contactez-nous.
IP_NOT_ALLOWED403L'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_SCOPE403La clé n'a pas le scope requis pour ce endpoint.Créez une clé avec ce scope.
NOT_FOUND404Produit, commande ou route inconnus.—
VALIDATION_ERROR400Corps ou paramètres invalides (details liste chaque champ).Corrigez la requête ; ne la renvoyez pas telle quelle.
INSUFFICIENT_BALANCE402Solde insuffisant. Rien n'a été débité.Rechargez votre solde et réessayez.
PRICE_CHANGED409Le prix unitaire réel dépasse maxUnitPrice. Rien n'a été débité.Mettez le prix à jour (details.currentPrice) et réessayez.
INVALID_COUPON400couponCode inconnu, ou promotion terminée. Rien n'a été débité.Retirez le code ou envoyez celui qui est actif (MICROSOFT20).
OUT_OF_STOCK409Pas assez d'unités disponibles. Rien n'a été débité.Réessayez plus tard ou masquez le produit.
PRODUCT_UNAVAILABLE409Produit non vendable via l'API.Retirez-le de votre boutique.
DUPLICATE_EXTERNAL_ID409externalId déjà utilisé ; details.orderId est la commande existante.Récupérez cette commande à la place.
IDEMPOTENCY_CONFLICT409Idempotency-Key réutilisée avec un corps différent.Utilisez une nouvelle clé par commande.
IDEMPOTENCY_IN_PROGRESS409La même Idempotency-Key est encore en cours de traitement.Réessayez dans quelques secondes.
ORDER_LIMIT_EXCEEDED422Total de la commande supérieur à votre limite par commande.Scindez la commande ou demandez une limite plus élevée.
DAILY_LIMIT_EXCEEDED422Limite de dépenses sur 24 heures atteinte.Patientez ou demandez une limite plus élevée.
RATE_LIMITED429Trop de requêtes.Ralentissez (details.retryAfterMs).
SERVICE_UNAVAILABLE503Vente temporairement impossible. Rien n'a été débité.Réessayez avec un backoff exponentiel.
INTERNAL_ERROR500Erreur inattendue (journalisée avec requestId).Réessayez avec la même Idempotency-Key.

Limites

LimiteValeur
Requêtes par clé20 / seconde et 600 / minute
Commandes par compte120 / minute
Téléchargements de clés par compte300 / minute
Lignes par commande / unités par ligne10 / 9
Montant de la commande et dépenses sur 24 heuresPar compte (voir Tableau de bord → Vue d'ensemble) ; demandez-nous de les augmenter
Taille de page100 produits (fields=full), 500 (fields=summary), 100 commandes
Filtre ids200 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.