-20%

20% off Windows and Office

For online stores and developers

Sell our whole catalogue in your shop. We deliver the keys.

Games, DLC, software, Windows and Office, gift cards and subscriptions, by REST API or with the WordPress plugin. When your customer pays, the key is bought and delivered automatically, and charged to your prepaid balance (for example, top up 500 € and each order is charged by itself) or to your Wallet.

  • 2% cheaper than our website

    The API price is our own website price minus 2%, on every product of the catalogue.

  • No service fee

    The website adds a fee at checkout. The API does not: you pay the API price and nothing else.

  • Prepaid balance or Wallet

    Top up once, then every order is charged automatically. If the balance is not enough, the Wallet of your account covers it.

Works with

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

Active promotion

20% off every Microsoft product

Add the code to your orders and pay 20% less for every Windows, Office, Visio, Project and SQL Server licence. No fees, no minimum.

API field

"couponCode": "MICROSOFT20"

In short

BuyCheapKeys offers online stores a REST API and a WordPress/WooCommerce plugin to resell its whole catalogue: games, DLC, software, Windows and Office, gift cards and subscriptions. The API price is the website price minus 2%, with no service fee. A store imports the product sheets in one or several of 7 languages, keeps price and stock in sync with a cursor, and orders a key when its own customer pays. The key usually comes back in the order response (or later by webhook if the order is still processing), paid from the store's prepaid balance or its Wallet. A free sandbox is available.

Updated:

The catalogue you can sell, live

These figures come straight from the API and refresh every few minutes. Prices are not published on this page: you see them with your key.

33,456
products in stock
19
platforms with stock
32,838
games and DLC in stock
498
software products in stock
120
subscriptions in stock

Platforms with the most products

  • Steam 25,960
  • Xbox 4,578
  • PlayStation 1,119
  • GOG 426
  • Epic Games 410
  • Ubisoft Connect 330
  • PC 305
  • Microsoft 137
  • EA App 120
  • Rockstar 17
  • Nintendo 13
  • Mac 11

Some of what you can sell today

A sample of covers from the catalogue. Every product comes with its sheet: description, activation steps, requirements, screenshots and region.

  • Grand Theft Auto V Enhanced EU PC Rockstar Digital Download

    Grand Theft Auto V Enhanced EU PC Rockstar Digital Download

    RockstarKey

  • ELDEN RING NIGHTREIGN

    ELDEN RING NIGHTREIGN

    SteamKey

  • EA SPORTS FC 26 (PS4/PS5 Account)

    EA SPORTS FC 26 (PS4/PS5 Account)

    PlayStationAccount

  • EA Sports FC 24

    EA Sports FC 24

    EA AppKey

  • Minecraft Legends Deluxe Edition (Xbox Account)

    Minecraft Legends Deluxe Edition (Xbox Account)

    XboxAccount

  • Baldur's Gate 3 (Steam Account)

    Baldur's Gate 3 (Steam Account)

    SteamAccount

  • Forza Horizon 4 Ultimate Edition (Xbox Account)

    Forza Horizon 4 Ultimate Edition (Xbox Account)

    XboxAccount

  • Call of Duty: Vanguard

    Call of Duty: Vanguard

    XboxKey

How it works

  1. 01

    Create your account

    Apply as a partner and create a sandbox key to try everything with fake keys. No money moves in the sandbox.

  2. 02

    Import the catalogue

    Read the products endpoint with the filters you need (platform, region, type, price) in one or several languages, then keep price and stock in sync with the cursor.

  3. 03

    Your customer pays

    The sale happens in your shop, with your price and your payment methods. Your shop sends one request: POST /orders with the product and the highest price you accept.

  4. 04

    The key is delivered

    The key usually comes back in the same response (if the order is "processing", it arrives by webhook or with GET /orders/{id}/keys), is charged to your balance or Wallet, and your shop sends it to your customer. The WordPress plugin does all of this by itself.

Filters and formats

Sell only what fits your shop. Every filter works on the products endpoint and you can combine them.

  • Delivery format

    Key to redeem, gift link (Steam Gift), account or activation link. Each product says which one it is.

  • Platform

    Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft and more.

  • Region

    The region of each key and the exact list of countries where it cannot be activated.

  • Product type

    Games, DLC, software, Windows and Office, gift cards and subscriptions.

  • Price

    Minimum and maximum price, sort by price, popularity, name or novelty.

  • Stock and changes

    Only what is in stock, or only what changed since your last sync.

Product sheets in 7 languages

Names, descriptions and activation steps are available in English, Spanish, German, French, Italian, Portuguese and Polish. Choose one language, or import several at once for a multilingual shop with WPML or Polylang. Each product tells you the real language of its text.

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

Pay from a prepaid balance or your Wallet

Top up your balance once, for example 500 €, and every order is charged automatically at the moment your customer pays. If the balance is not enough, the Wallet of your account covers the rest. Every movement is in your ledger, and a webhook tells you when a top-up arrives.

Free sandbox

Sandbox keys (bck_test_) use the real catalogue and prices but return fake keys and a test balance. Nothing is charged and no real stock is used, so you can build and test the whole flow first.

Signed webhooks

Get notified when an order is completed or refunded, when a key is replaced, and when products change (products.updated and catalog.changed). Every event is signed with HMAC-SHA256 and retried for about a day.

WordPress and WooCommerce plugin

If your shop runs on WordPress you do not need to write code. Install the plugin, paste your API key and choose your margin.

Version 1.1.0 · free · WordPress + WooCommerce

Download the plugin
  • Imports each product with its sheet, activation steps and requirements
  • Updates price and stock automatically, with your margin and rounding
  • Checks the cart before checkout and blocks products that cannot be delivered
  • Buys the key when the order is paid and emails it to your customer
  • Shows the key in the order page and in My Account, stored encrypted
  • Retries by itself if something fails and warns you by email

API documentation

Everything you need to integrate: authentication, catalogue sync, filters, orders, key delivery, claims, webhooks, errors and limits.

Read the API documentation
# 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 } ] }'

Platforms

Works with Shopify, Shopware, Magento, PrestaShop and any other store platform

If your platform can send a request when an order is paid, it can sell our catalogue. That covers the list below, which has more than 120 names, and any shop you coded yourself. The only plugin we ship today is for WooCommerce. On everything else you connect through the REST API.

How it connects on any platform

  1. 01

    Catalogue

    Read the products endpoint to import names, descriptions, activation steps and cover images, and to keep price and stock current.

  2. 02

    Paid order

    Your platform fires its paid-order event: a webhook, a hook, a flow or a scheduled job. That event calls POST /orders with the product and the highest price you accept.

  3. 03

    Delivery

    The response carries the key. Your store emails it to the customer and shows it in the order. If the key is not ready yet, the order.completed webhook tells you when it is.

Common routes by platform

Every platform has its own way to react to a paid order. These are the ones most stores use. Your developer, or a tool like Zapier or Make, can set up any of them.

  • 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

All platforms by type

Hosted store builders

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

Enterprise and headless commerce

  • 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

Marketplace software

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

Digital product sellers

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

ERP and business suites

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

Regional platforms

  • 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

Automation tools

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

Stores built from scratch

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

Your platform is not on the list?

If it can call a URL when a payment is confirmed, it works. Write to partners@buycheapkeys.com and we will point you to the right trigger.

Create a partner account

Frequently asked questions

What is the best API to resell game keys?
It depends on what you need, so here is what the BuyCheapKeys reseller API offers: the whole catalogue of our website (games, DLC, software, Windows and Office, gift cards, subscriptions) at the website price minus 2%, no service fee, product sheets in 7 languages, filters by platform, region, type and price, a cursor for incremental sync, signed webhooks, a free sandbox and a WordPress/WooCommerce plugin. Keys usually come back in the same order response; if a product has to be bought from a wholesale source, the order is "processing" and the keys arrive by webhook.
How much does the BuyCheapKeys reseller API cost?
Using the API has no service fee. You pay the API price of each key you buy, which is our website price minus 2%, from your prepaid balance or your Wallet. Online top-ups carry the payment gateway fee.
How do I sell game keys in my WooCommerce store?
Install the free BuyCheapKeys plugin for WooCommerce (version 1.1.0), paste your API key and set your margin. It imports the products, keeps price and stock up to date, buys the key when an order is paid and emails it to your customer.
Can I use it with Shopify, Magento, Shopware, PrestaShop or my own shop?
Yes, through the REST API. The paid-order event of your platform (a webhook, a hook or a scheduled job) calls POST /orders and your shop hands over the key. Only WooCommerce has a ready-made plugin today. The documentation includes a reference client in Node.js with no dependencies.
Which products can I sell?
The whole catalogue of the website that is in stock: games and DLC for Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App and Nintendo, software, Windows and Office licences, gift cards and subscriptions. The live figures are at the top of this page.
How are the keys delivered?
Usually in the response of the order request, so your shop can show them and email them to your customer at once. When a product has to be bought from a wholesale source it can take a few seconds or minutes: the order is then "processing" and the keys arrive by webhook (order.completed) or with GET /orders/{id}/keys (you can add ?wait=25 to wait for them). Each product states its delivery type: a key to redeem, a Steam Gift link, an account or an activation link. You can read the keys again with the keys endpoint.
How do I pay for the orders?
From a prepaid API balance. For example, top up 500 € and each order is charged automatically when it is placed. If the balance is not enough, the Wallet of your account covers it. If neither has enough, the order is refused and nothing is charged.
Which languages are the product sheets available in?
English, Spanish, German, French, Italian, Portuguese and Polish. Use the lang parameter to choose one, or import several for a multilingual shop. If a translation is missing, the English text is returned and the product says so.
How do I keep prices and stock in sync?
Do a full import once, then call the products endpoint every few minutes with fields=summary and the saved cursor: it returns only what changed (price, stock, removed). Webhooks (products.updated and catalog.changed) also tell you when to sync.
Can I test the API without paying?
Yes. Sandbox keys return fake keys and use a test balance. The catalogue and prices are real, nothing is charged and no real stock is used.
What happens if a key does not work?
Keys from marketplace sellers can be claimed for 14 days from your partner panel, with messages and screenshots. If the claim is accepted, you get a replacement in the same order or the price back to your balance. Other keys are handled by our support under the warranty.

Start selling the whole catalogue

Create a partner account, test in the sandbox and go live when you are ready.

BuyCheapKeys is an independent reseller. Platform and brand names belong to their owners and are used only to describe compatibility. Check that the licence type and region suit your customers and the law of your country.

API documentation

Contents

REST/JSON API to sell the whole BuyCheapKeys catalogue on your own site. The API price is the website price minus 2 %, with no service fee. Each order is paid from your prepaid balance (or your Wallet) and the keys come back in the same response.

Base URL: https://buycheapkeys.com/partner-api/v1 Download the OpenAPI 3.1 specification

Overview

Base URL: https://buycheapkeys.com/partner-api/v1. All requests and responses are JSON (UTF-8). Prices are in EUR with two decimals and do not include VAT. Dates are ISO 8601 in UTC.

  • Catalogue: the whole catalogue of the website (games, DLC, software, Windows and Office, gift cards, subscriptions) with product sheets in 7 languages (en, es, de, fr, it, pt, pl).
  • Price: API price = website price minus 2 %, and no service fee (the website charges a fee at checkout; the API does not). GET /me returns discountPercent and serviceFee: 0.
  • Orders: buy up to 10 lines x 9 units per request; the total is charged at once to your prepaid balance and, if that is not enough, to your Wallet.
  • Delivery: the keys are in the response of the order and can be read again with GET /orders/{id}/keys.
  • Claims: a faulty key can be claimed for 14 days from your partner dashboard; a replacement key reaches your order automatically and a refund goes back to your balance.

WordPress/WooCommerce? Use the plugin (see the Plugin section above): it imports the catalogue, keeps price and stock in sync and delivers the keys without code.

Authentication and environments

Create keys in Dashboard → Partner → API keys. A key is shown once; we only store its hash. Send it in the Authorization header (X-Api-Key is accepted too).

curl https://buycheapkeys.com/partner-api/v1/ping \
  -H "Authorization: Bearer bck_test_xxxxxxxxxxxx_..."
Key prefixModeBehaviour
bck_test_SandboxReal catalogue and prices, separate test balance (resettable), fake keys like TEST-AB12C-…, no money moves. Webhooks are sent with mode: test.
bck_live_ProductionReal purchases charged to your live balance (and Wallet).
ScopeAllows
catalog:readGET /products, /products/{id}, /meta, /me, /ping, /gift-cards
webhooks:writePUT, GET and DELETE /webhook (register or remove your webhook URL)
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

Optional IP allowlist (IPv4/IPv6, CIDR) per account. Keys never expire unless revoked; rotate them by creating a new key and revoking the old one. GET /public/catalog needs no key.

Quick start

1) Create a bck_test_ key. 2) List products. 3) Place an order: it comes back completed, with the keys. 4) Read the keys again at any time with GET /orders/{id}/keys. Accounts still being approved can use sandbox keys.

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

Catalogue and synchronisation

GET /products returns the products ordered by updatedAt (then id). updatedAt only changes when something you care about changes (price, stock, name, region, texts, images). Sync with the cursor: every response has nextCursor and hasMore; pass nextCursor back as ?cursor= until hasMore is false and keep it for the next run. It never skips or repeats products, even when many share the same timestamp (the cursor always follows updatedAt; sort only applies when you browse by pages).

Two formats: fields=full (default, up to 100 products per page) is the whole sheet; fields=summary (up to 500 per page) returns only id, price, shopPrice, currency, inStock, qty, updatedAt and removed, perfect for keeping price and stock up to date every 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"
  • Recommended: full import once (fields=full, in the language(s) of your shop), then every 1–5 minutes fields=summary from the stored nextCursor, always with includeRemoved=true.
  • Availability: if the website cannot sell a product (no stock, stock disabled, cost above our cap) it appears as inStock: false, qty: 0 in less than a minute; a hidden or deleted product has removed: true. Never sell those.
  • Catalogue changes are announced by webhook (products.updated, catalog.changed), so polling can be rare.
  • GET /public/catalog?lang= (no key, cached 10 minutes) returns live figures and a few featured covers for your own landing page.

Filters, sorting and languages

lang (en, es, de, fr, it, pt, pl; default en) chooses the language of names and descriptions. Each product has language with the real language of the text (en when a translation is missing). One language or several: call once per language, or import all seven for WPML/Polylang/multilingual stores. Lists accept comma-separated values.

ParameterValues / meaning
platformSteam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft, … (see /meta)
regionRegion label (Global, Europe, …); see /meta
productTypegame, dlc, software, gift-card, gift, subscription, game-point
deliveryTypekey, gift (Steam Gift link), account, link (activation link)
categorygame, dlc, software, microsoft, gift-card, gift, subscription
genreGenre name (see /meta)
minPrice / maxPriceEUR, API price
inStocktrue to list only what can be sold now
searchAll words, matched against the name and the translated title
idsUp to 200 product ids
updatedSince / includeRemovedChanges since a date; include retired products
sortupdated, popularity, name, price_asc, price_desc, newest (with pages; the sync cursor always follows updatedAt)
fields / limit / cursor / pagefull or summary; up to 100 (full) or 500 (summary); cursor for sync; page for browsing
# 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 returns the facets with counts and stock (platforms, regions, product types, genres, languages, price range, sort values) so you can build your own filters.

Product fields

{
  "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
}
FieldMeaning
priceYour unit price in EUR: website price minus 2 %. Re-checked live when you order.
shopPrice / discountPercentWebsite price and your discount (2).
rrpReal retail price when it is higher than the API price; otherwise null.
deliveryTypekey = code to redeem · gift = Steam Gift link · account = login credentials · link = activation link. Tell your customer which one they buy.
region / activationRegion label plus the exact ISO list of countries where it can NOT be activated.
productType / category / edition / licenseTypeClassification of the product.
languageLanguage of the texts of this response.
shortDescription / description / descriptionHtml / featuresTexts. descriptionHtml is clean HTML without links or images.
activationSteps / activationDetails / systemRequirementsRedemption instructions and requirements.
languages / genres / developer / publisher / releaseDate / ageRatingGame data.
coverImage / screenshots / videosImages from our CDN (cache them on your side) and YouTube videos.
qtyUnits in stock (capped at 999).
urlPublic product page on the website.

Orders

POST /orders with externalId (your unique reference) and items (productId, qty 1–9, maxUnitPrice). For each line we check the live price: if it is above maxUnitPrice the whole order is rejected with PRICE_CHANGED and nothing is charged. If it is lower, you pay the lower price. The cheapest source with stock sells, like on the website.

Recommended: send storeUrl (the URL of your shop where the product is sold) in the body of POST /orders, or the header X-Store-Url on any call. It is optional; the WordPress plugin sends your site URL automatically.

Promo code: add couponCode: MICROSOFT20 to pay 20 % less on Microsoft products (Windows, Office, Visio, Project, SQL Server) while the promotion is active. It is only applied to those lines; an unknown code or an ended promotion returns INVALID_COUPON and nothing is charged.

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
}
  • Send an Idempotency-Key header (8–100 chars) and reuse it when you retry: you get the original response and are never charged twice. externalId is also unique per account.
  • The order is completed in the same request (?wait=20 waits up to 20 s): the response has status completed and a keys array. A replayed request returns the order without its keys and keysOmitted: true: read them with GET /orders/{id}/keys.
  • No stock or low balance: nothing is charged and no key is used (OUT_OF_STOCK, INSUFFICIENT_BALANCE). maxUnitPrice is a ceiling for every key.
  • If a request times out, send it again with the same externalId: you get DUPLICATE_EXTERNAL_ID with the order id and can read its keys.
StatusMeaning
completedAll units delivered. The keys are in the response.
partially_refundedSome keys were refunded to your balance after claims.
refundedEvery key of the order was refunded to your balance.

Key delivery

GET /orders/{id}/keys returns every delivered unit: value holds the code, the Steam Gift URL, the account credentials or the activation link depending on deliveryType. contentType is text/plain or an image type (then value is base64).

Store keys encrypted and show them only to the buyer. The first download of each order is logged on our side as delivery evidence.

Claims and refunds

A faulty key can be claimed for 14 days. Open the order in Dashboard → Orders (API orders), pick the key, write to the seller and attach screenshots of the activation error. The seller can send a replacement key (it appears in your order and you get the key.replaced webhook) or refund the key (the price returns to your API balance once and you get order.refunded). If you do not agree, escalate and BuyCheapKeys decides.

Check the region, excludedCountries and the licence type before selling, and show them to your customer. A refund to your balance does not refund your own customer: that is your decision.

BuyCheapKeys Gift Cards in bulk

Besides gift cards from other brands (they are products of the catalogue, productType=gift-card), you can buy our own gift cards to resell: codes BCK-XXXX-XXXX-XXXX-XXXX that add their value to the BuyCheapKeys Wallet of whoever redeems them at buycheapkeys.com/wallet. GET /gift-cards returns the values on sale, the volume discounts, the maximums per order and your Wallet balance. POST /gift-cards/orders buys N cards of one value and returns the codes at once; GET /gift-cards/orders/{id} shows them again with the status of each code.

curl https://buycheapkeys.com/partner-api/v1/gift-cards \
  -H "Authorization: Bearer $BCK_API_KEY"
  • Paid only from the BuyCheapKeys Wallet of your shop account (top it up at buycheapkeys.com/wallet), not from the API balance. Price = face value minus the volume discount for that quantity.
  • Values, discounts and maximums can change: send maxTotal to refuse a higher total (PRICE_CHANGED, nothing charged). Idempotency-Key and the unique externalId work as for orders.
  • Sale paused: PRODUCT_UNAVAILABLE (409). Value not sold or quantity out of range: VALIDATION_ERROR. Order too large: ORDER_LIMIT_EXCEEDED. Not enough Wallet balance: INSUFFICIENT_BALANCE (402).
  • Sandbox keys return fake BCK-TEST-… codes that cannot be redeemed and charge nothing.
  • Sold codes are final. Each code has an expiry date (expiresAt) and redemption limits per account. A code we block for fraud is no longer shown (code: null, status blocked). Store the codes encrypted.

Webhooks

Set an https URL in Dashboard → Webhooks (or PUT /webhook); you get a signing secret (whsec_…). Every event is a POST with headers X-BCK-Event, X-BCK-Delivery (unique id: de-duplicate on it) and X-BCK-Signature: t=<unix>,v1=<hex> where v1 = HMAC-SHA256(secret, t + "." + rawBody).

EventWhen
order.completedAn order was completed.
order.refundedA claim ended in a refund to your balance (`refundedSale`, `amount`).
products.updatedPrice, stock or availability of products changed: `data.products` holds up to 100 products in summary format per event (`removed: true` when retired).
catalog.changedMore than 1000 products changed at once: run the cursor sync (`fields=summary`) instead of reading the event.
product.updatedHand-curated Windows and Office products only (plugin 1.0): `data.product` has the full product.
key.replacedA seller replaced a key: `oldKeyId`, `newKeyId`; read the new key with GET /orders/{id}/keys.
balance.creditedA top-up was added to your balance.
webhook.testSent by POST /webhooks/test or the dashboard button.
{
  "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}" }
}
  • Answer 2xx within 8 s and do the work asynchronously. Redirects are not followed.
  • Failed deliveries are retried after 10 s, 30 s, 1 min, 5 min, 15 min, 30 min, 1 h, 2 h, 4 h, 6 h and 12 h (~26 h).
  • Events may arrive out of order or more than once: always re-read GET /orders/{id} or the cursor when in doubt.

Errors

Errors use HTTP status codes and a stable code. Quote requestId when contacting 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"
  }
}
codeHTTPMeaningWhat to do
UNAUTHORIZED401Missing, invalid, revoked or expired key.Check the key; create a new one in the dashboard.
ACCOUNT_NOT_ACTIVE403Partner account pending, suspended or rejected.Contact us.
IP_NOT_ALLOWED403Request IP not in your allowlist.Add the IP in Dashboard → Webhooks & security.
INSUFFICIENT_SCOPE403The key lacks the scope for this endpoint.Create a key with the scope.
NOT_FOUND404Unknown product, order or route.—
VALIDATION_ERROR400Invalid body or parameters (details lists each field).Fix the request; do not retry as is.
INSUFFICIENT_BALANCE402Balance too low. Nothing was charged.Top up and retry.
PRICE_CHANGED409Live unit price above maxUnitPrice. Nothing was charged.Re-price (details.currentPrice) and retry.
INVALID_COUPON400couponCode unknown, or the promotion has ended. Nothing was charged.Remove the code or send the active one (MICROSOFT20).
OUT_OF_STOCK409Not enough units available. Nothing was charged.Retry later or hide the product.
PRODUCT_UNAVAILABLE409Product not sellable through the API.Remove it from your shop.
DUPLICATE_EXTERNAL_ID409externalId already used; details.orderId is the existing order.Fetch that order instead.
IDEMPOTENCY_CONFLICT409Idempotency-Key reused with a different body.Use a new key per order.
IDEMPOTENCY_IN_PROGRESS409Same Idempotency-Key still being processed.Retry in a few seconds.
ORDER_LIMIT_EXCEEDED422Order total above your per-order limit.Split the order or ask for a higher limit.
DAILY_LIMIT_EXCEEDED42224-hour spend limit reached.Wait or ask for a higher limit.
RATE_LIMITED429Too many requests.Back off (details.retryAfterMs).
SERVICE_UNAVAILABLE503Temporarily unable to sell. Nothing was charged.Retry with exponential backoff.
INTERNAL_ERROR500Unexpected error (logged with requestId).Retry with the same Idempotency-Key.

Limits

LimitValue
Requests per key20 / second and 600 / minute
Orders per account120 / minute
Key downloads per account300 / minute
Lines per order / units per line10 / 9
Order value and 24-hour spendPer account (see Dashboard → Overview); ask us to raise them
Page size100 products (fields=full), 500 (fields=summary), 100 orders
ids filter200 ids

Balance, Wallet and top-ups

Orders are charged to your prepaid API balance and, if it is not enough, to the Wallet of your account. GET /balance returns the balance of the key's mode; GET /me also shows walletBalance and available. Top up from Dashboard → Balance (for example 500 EUR, then every order is charged automatically): you receive a unique reference for the bank transfer, or you can pay online; the amount is credited when it arrives (e-mail + balance.credited webhook). Every movement appears in the ledger.

Implementing with an AI assistant

Machine-readable docs: https://buycheapkeys.com/reseller-api.md (this page as Markdown; /reseller-api.es.md in Spanish), the OpenAPI 3.1 spec https://buycheapkeys.com/partner-api/v1/openapi.json and https://buycheapkeys.com/llms.txt. Give these URLs to your AI assistant together with the prompt below.

Complete reference integration (Node.js 18+, no dependencies): https://buycheapkeys.com/developers/bck-partner-client.mjs: catalogue sync with cursor, safe ordering with retries and idempotency, key download and a webhook receiver with signature verification.

curl -O https://buycheapkeys.com/developers/bck-partner-client.mjs
export BCK_API_KEY=bck_test_...   # sandbox key from Dashboard → Partner → API keys
node bck-partner-client.mjs balance
node bck-partner-client.mjs sync
node bck-partner-client.mjs order <productId> 1 <maxUnitPrice>
  • Invariant 1: sell only products with inStock=true and removed=false; re-sync every 1–5 min from the stored nextCursor.
  • Invariant 2: one customer order = one externalId = one Idempotency-Key; reuse both on every retry.
  • Invariant 3: always send maxUnitPrice; 4xx business errors are final and nothing was charged.
  • Invariant 4: retry only network errors, 429, 5xx and IDEMPOTENCY_IN_PROGRESS, with exponential backoff.
  • Invariant 5: never re-order after a timeout: repeat the same externalId and read the keys of the existing order.
  • Invariant 6: keep the API key server-side; verify webhook signatures; show customers the deliveryType, region and excluded countries.

Go-live checklist

  • Keep API keys on your server only (never in browsers or apps) and in a secret manager or environment variables.
  • Use separate keys per system and the minimum scopes; enable the IP allowlist.
  • Always send maxUnitPrice and an Idempotency-Key, and send storeUrl (or the X-Store-Url header) with the URL of your shop.
  • Verify every webhook signature and timestamp before trusting it.
  • Test the full flow with a bck_test_ key, then switch to bck_live_ and top up your balance.
  • Rotate keys and the webhook secret if you suspect a leak, then revoke the old ones.