Para tiendas online y desarrolladores
Vende todo nuestro catálogo en tu tienda. Nosotros entregamos las claves.
Juegos, DLC, software, Windows y Office, gift cards y suscripciones, por API REST o con el plugin de WordPress. Cuando tu cliente paga, la clave se compra y se entrega sola, y se cobra de tu saldo prepago (por ejemplo, recargas 500 € y cada pedido se cobra automáticamente) o de tu Wallet.
2 % más barato que nuestra web
El precio de la API es el precio de nuestra web menos un 2 %, en todos los productos del catálogo.
Sin cuota de servicio
La web añade una cuota en el checkout. La API no: pagas el precio de la API y nada más.
Saldo prepago o Wallet
Recargas una vez y cada pedido se cobra solo. Si el saldo no llega, lo cubre la Wallet de tu cuenta.
Compatible con
- Shopify
- WooCommerce
- Shopware
- Magento
- PrestaShop
- CS-Cart
- OpenCart
- BigCommerce
- + 120
POST /partner-api/v1/orders
Authorization: Bearer bck_live_…
{ "externalId": "shop-10045",
"items": [ {
"productId": "prod-17298",
"qty": 1,
"maxUnitPrice": 4.50 } ] }
→ 201 { "status": "completed",
"total": "…",
"keys": [ { "value": "XXXXX-…" } ] }Promoción activa
20 % de descuento en todos los productos Microsoft
Añade el código a tus pedidos y pagas 20 % menos por cada licencia de Windows, Office, Visio, Project y SQL Server. Sin cuotas ni mínimos.
Campo de la API
"couponCode": "MICROSOFT20"En resumen
BuyCheapKeys ofrece a las tiendas online una API REST y un plugin de WordPress/WooCommerce para revender todo su catálogo: juegos, DLC, software, Windows y Office, gift cards y suscripciones. El precio de la API es el de la web menos un 2 %, sin cuota de servicio. La tienda importa las fichas en uno o varios de 7 idiomas, mantiene precio y stock sincronizados con un cursor y pide una clave cuando su propio cliente paga. La clave suele llegar en la respuesta del pedido (o después por webhook si el pedido sigue en proceso) y se paga con el saldo prepago de la tienda o con su Wallet. Hay un sandbox gratuito.
Actualizado:
El catálogo que puedes vender, en directo
Estas cifras salen directamente de la API y se actualizan cada pocos minutos. Los precios no se publican en esta página: los ves con tu clave.
- 33.457
- productos con stock
- 19
- plataformas con stock
- 32.839
- juegos y DLC con stock
- 498
- productos de software con stock
- 120
- suscripciones con stock
Plataformas con más productos
- Steam 25.960
- Xbox 4579
- PlayStation 1119
- GOG 426
- Epic Games 410
- Ubisoft Connect 330
- PC 305
- Microsoft 137
- EA App 120
- Rockstar 17
- Nintendo 13
- Mac 11
Parte de lo que puedes vender hoy
Una muestra de portadas del catálogo. Cada producto trae su ficha: descripción, pasos de activación, requisitos, capturas y región.

Grand Theft Auto V Enhanced EU PC Rockstar Digital Download (Rockstar) - Clave Digital Europa
RockstarClave

ELDEN RING NIGHTREIGN (Steam) - Clave Digital Estados Unidos
SteamClave

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

EA Sports FC 24
EA AppClave

Minecraft Legends Deluxe Edition (Xbox Account)
XboxCuenta

Baldur's Gate 3 (Steam Account)
SteamCuenta

Forza Horizon 4 Ultimate Edition (Xbox Account)
XboxCuenta

Call of Duty: Vanguard
XboxClave

Hogwarts Legacy
XboxClave

Hogwarts Legacy Digital Deluxe Edition (PS5 Account)
PlayStationCuenta

Stardew Valley (Steam Gift) (Steam) - Clave Digital Global
SteamEnlace de regalo

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

Microsoft Windows 11 Pro (PC) - Microsoft Key - GLOBAL (Microsoft) - Clave Digital Global
MicrosoftClave

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

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

Microsoft Windows 10 / 11 Pro - 1 PC - OEM
MicrosoftClave
Cómo funciona
- 01
Crea tu cuenta
Solicita el alta como partner y crea una clave sandbox para probarlo todo con claves falsas. En el sandbox no se mueve dinero.
- 02
Importa el catálogo
Lee el endpoint de productos con los filtros que necesites (plataforma, región, tipo, precio) en uno o varios idiomas y mantén precio y stock al día con el cursor.
- 03
Tu cliente paga
La venta ocurre en tu tienda, con tu precio y tus métodos de pago. Tu tienda hace una sola petición: POST /orders con el producto y el precio máximo que aceptas.
- 04
Se entrega la clave
La clave suele volver en la misma respuesta (si el pedido queda en "processing", llega por webhook o con GET /orders/{id}/keys), se cobra de tu saldo o Wallet y tu tienda se la envía a tu cliente. El plugin de WordPress hace todo esto solo.
Filtros y formatos
Vende solo lo que encaja con tu tienda. Todos los filtros funcionan en el endpoint de productos y se pueden combinar.
Formato de entrega
Clave para canjear, enlace de regalo (Steam Gift), cuenta o enlace de activación. Cada producto indica cuál es.
Plataforma
Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft y más.
Región
La región de cada clave y la lista exacta de países donde no se puede activar.
Tipo de producto
Juegos, DLC, software, Windows y Office, gift cards y suscripciones.
Precio
Precio mínimo y máximo, y orden por precio, popularidad, nombre o novedad.
Stock y cambios
Solo lo que tiene stock, o solo lo que cambió desde tu última sincronización.
Fichas de producto en 7 idiomas
Nombres, descripciones y pasos de activación están disponibles en inglés, español, alemán, francés, italiano, portugués y polaco. Elige un idioma o importa varios a la vez para una tienda multilingüe con WPML o Polylang. Cada producto indica el idioma real de su texto.
- en
- es
- de
- fr
- it
- pt
- pl
Paga con saldo prepago o con tu Wallet
Recarga tu saldo una vez, por ejemplo 500 €, y cada pedido se cobra automáticamente en el momento en que tu cliente paga. Si el saldo no llega, la Wallet de tu cuenta cubre el resto. Cada movimiento queda en tu libro de movimientos y un webhook te avisa cuando llega una recarga.
Sandbox gratuito
Las claves sandbox (bck_test_) usan el catálogo y los precios reales, pero devuelven claves falsas y un saldo de pruebas. No se cobra nada ni se usa stock real, así que puedes construir y probar todo el flujo antes.
Webhooks firmados
Recibe avisos cuando un pedido se completa o se reembolsa, cuando se reemplaza una clave y cuando cambian los productos (products.updated y catalog.changed). Cada evento va firmado con HMAC-SHA256 y se reintenta durante aproximadamente un día.
Plugin de WordPress y WooCommerce
Si tu tienda usa WordPress no necesitas programar. Instala el plugin, pega tu clave API y elige tu margen.
Versión 1.1.0 · gratis · WordPress + WooCommerce
Descargar el plugin- Importa cada producto con su ficha, pasos de activación y requisitos
- Actualiza precio y stock automáticamente, con tu margen y redondeo
- Revisa el carrito antes del pago y bloquea los productos que no se pueden entregar
- Compra la clave cuando se paga el pedido y se la envía por email a tu cliente
- Muestra la clave en la página del pedido y en Mi cuenta, guardada cifrada
- Reintenta solo si algo falla y te avisa por email
Documentación de la API
Todo lo que necesitas para integrarlo: autenticación, sincronización del catálogo, filtros, pedidos, entrega de claves, reclamaciones, webhooks, errores y límites.
Leer la documentación de la 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 } ] }'Plataformas
Funciona con Shopify, Shopware, Magento, PrestaShop y cualquier otra plataforma de tiendas
Si tu plataforma puede enviar una petición cuando se paga un pedido, puede vender nuestro catálogo. Eso incluye la lista de abajo, con más de 120 nombres, y cualquier tienda que hayas programado tú. El único plugin que tenemos hoy es el de WooCommerce. En el resto te conectas con la API REST.
Así se conecta en cualquier plataforma
- 01
Catálogo
Lee el endpoint de productos para importar nombres, descripciones, pasos de activación e imágenes, y para mantener precio y stock al día.
- 02
Pedido pagado
Tu plataforma lanza su evento de pedido pagado: un webhook, un hook, un flujo o una tarea programada. Ese evento llama a POST /orders con el producto y el precio máximo que aceptas.
- 03
Entrega
La respuesta trae la clave. Tu tienda se la envía por email al cliente y la muestra en el pedido. Si la clave aún no está lista, el webhook order.completed te avisa cuando lo esté.
Vías habituales según la plataforma
Cada plataforma tiene su forma de reaccionar a un pedido pagado. Estas son las que usan la mayoría de las tiendas. Tu programador, o una herramienta como Zapier o Make, puede montar cualquiera.
- 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
Todas las plataformas por tipo
Creadores de tiendas alojadas
- 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
Código abierto y alojamiento propio
- 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
Comercio empresarial y headless
- Adobe Commerce
- Salesforce Commerce Cloud
- SAP Commerce Cloud
- Oracle Commerce
- HCL Commerce
- commercetools
- Commerce Layer
- Elastic Path
- Kibo Commerce
- fabric
- Swell
- Spryker
- Intershop
- OroCommerce
- Sana Commerce
- Optimizely Commerce
- Emporix
- Crystallize
- Centra
Software de marketplaces
- Dokan
- WCFM Marketplace
- WC Vendors
- CS-Cart Multi-Vendor
- Mirakl
- Sharetribe
- Arcadier
- Marketplacer
- Yo!Kart
Venta de productos digitales
- Easy Digital Downloads
- Gumroad
- Lemon Squeezy
- Paddle
- FastSpring
- Sellfy
- SendOwl
- Payhip
- Podia
- Sellix
ERP y suites de gestión
- Odoo eCommerce
- ERPNext
- NetSuite SuiteCommerce
- Microsoft Dynamics 365 Commerce
- plentymarkets
Plataformas regionales
- 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
Herramientas de automatización
- Zapier
- Make
- n8n
- Pipedream
- Microsoft Power Automate
Tiendas hechas a medida
- Laravel
- Symfony
- Django
- Ruby on Rails
- Node.js
- Next.js
- Nuxt
- ASP.NET
- Spring Boot
- Go
¿Tu plataforma no aparece?
Si puede llamar a una URL cuando se confirma un pago, funciona. Escribe a partners@buycheapkeys.com y te decimos cuál es el disparador adecuado.
Preguntas frecuentes
¿Cuál es la mejor API para revender claves de juegos?
¿Cuánto cuesta usar la API de revendedores de BuyCheapKeys?
¿Cómo vendo claves de juegos en mi tienda WooCommerce?
¿Puedo usarlo con Shopify, Magento, Shopware, PrestaShop o con mi propia tienda?
¿Qué productos puedo vender?
¿Cómo se entregan las claves?
¿Cómo pago los pedidos?
¿En qué idiomas están las fichas de producto?
¿Cómo mantengo precios y stock sincronizados?
¿Puedo probar la API sin pagar?
¿Qué pasa si una clave no funciona?
Empieza a vender todo el catálogo
Crea una cuenta de partner, prueba en el sandbox y pasa a producción cuando quieras.
BuyCheapKeys es un revendedor independiente. Los nombres de plataformas y marcas pertenecen a sus propietarios y solo se usan para describir la compatibilidad. Comprueba que el tipo de licencia y la región convienen a tus clientes y a la ley de tu país.
Documentación de la API
Contenido
- Visión general
- Autenticación y entornos
- Inicio rápido
- Catálogo y sincronización
- Filtros, orden e idiomas
- Campos del producto
- Pedidos
- Entrega de claves
- Reclamaciones y reembolsos
- Tarjetas regalo BuyCheapKeys en bloque
- Webhooks
- Errores
- Límites
- Saldo, Wallet y recargas
- Implementarlo con una IA
- Lista para salir a producción
API REST/JSON para vender todo el catálogo de BuyCheapKeys en tu propia web. El precio de la API es el de la web menos un 2 %, sin cuota de servicio. Cada pedido se paga con tu saldo prepago (o tu Wallet) y las claves llegan en la misma respuesta.
Visión general
URL base: https://buycheapkeys.com/partner-api/v1. Todas las peticiones y respuestas son JSON (UTF-8). Los precios están en EUR con dos decimales y sin IVA. Las fechas son ISO 8601 en UTC.
- Catálogo: todo el catálogo de la web (juegos, DLC, software, Windows y Office, gift cards, suscripciones) con fichas en 7 idiomas (en, es, de, fr, it, pt, pl).
- Precio: precio de la API = precio de la web menos 2 %, y sin cuota de servicio (la web cobra una cuota en el checkout; la API no).
GET /medevuelvediscountPercentyserviceFee: 0. - Pedidos: hasta 10 líneas x 9 unidades por petición; el total se cobra de golpe de tu saldo prepago y, si no llega, de tu Wallet.
- Entrega: las claves van en la respuesta del pedido y se pueden volver a leer con GET /orders/{id}/keys.
- Reclamaciones: una clave defectuosa se reclama durante 14 días desde tu panel de partner; la clave de reemplazo llega sola a tu pedido y el reembolso vuelve a tu saldo.
¿WordPress/WooCommerce? Usa el plugin (sección Plugin, más arriba): importa el catálogo, mantiene precio y stock sincronizados y entrega las claves sin código.
Autenticación y entornos
Crea las claves en Panel → Partner → Claves API. Una clave se muestra una sola vez; solo guardamos su hash. Envíala en la cabecera Authorization (también se acepta X-Api-Key).
curl https://buycheapkeys.com/partner-api/v1/ping \
-H "Authorization: Bearer bck_test_xxxxxxxxxxxx_..."| Prefijo | Modo | Comportamiento |
|---|---|---|
| bck_test_ | Sandbox | Catálogo y precios reales, saldo de pruebas aparte (reiniciable), claves falsas tipo TEST-AB12C-…, no se mueve dinero. Los webhooks llevan mode: test. |
| bck_live_ | Producción | Compras reales cobradas de tu saldo real (y de tu Wallet). |
| Permiso (scope) | Permite |
|---|---|
| catalog:read | GET /products, /products/{id}, /meta, /me, /ping, /gift-cards |
| webhooks:write | PUT, GET y DELETE /webhook (registrar o quitar tu URL de 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 |
Lista blanca de IP opcional (IPv4/IPv6, CIDR) por cuenta. Las claves no caducan salvo que las revoques; rótalas creando una nueva y revocando la antigua. GET /public/catalog no necesita clave.
Inicio rápido
1) Crea una clave bck_test_. 2) Lista productos. 3) Haz un pedido: vuelve completado, con las claves. 4) Lee las claves otra vez cuando quieras con GET /orders/{id}/keys. Las cuentas aún en revisión pueden usar claves sandbox.
curl "https://buycheapkeys.com/partner-api/v1/products?lang=en&limit=100&inStock=true" \n -H "Authorization: Bearer $BCK_API_KEY"Catálogo y sincronización
GET /products devuelve los productos ordenados por updatedAt (y luego id). updatedAt solo cambia cuando cambia algo que te importa (precio, stock, nombre, región, textos, imágenes). Sincroniza con el cursor: cada respuesta trae nextCursor y hasMore; pasa nextCursor como ?cursor= hasta que hasMore sea false y guárdalo para la próxima ejecución. Nunca salta ni repite productos, aunque muchos compartan la misma marca de tiempo (el cursor siempre sigue updatedAt; sort solo vale al navegar por páginas).
Dos formatos: fields=full (por defecto, hasta 100 productos por página) es la ficha entera; fields=summary (hasta 500 por página) devuelve solo id, price, shopPrice, currency, inStock, qty, updatedAt y removed, ideal para mantener precio y stock al día cada minuto.
# Light incremental sync: only id, price, stock and flags (up to 500 per page)
curl "https://buycheapkeys.com/partner-api/v1/products?fields=summary&limit=500&includeRemoved=true&cursor=$SAVED_NEXT_CURSOR" \n -H "Authorization: Bearer $BCK_API_KEY"- Recomendado: importación completa una vez (fields=full, en el idioma o idiomas de tu tienda) y después cada 1–5 minutos
fields=summarydesde elnextCursorguardado, siempre conincludeRemoved=true. - Disponibilidad: si la web no puede vender un producto (sin stock, stock desactivado, coste por encima de nuestro tope) sale como
inStock: false, qty: 0en menos de un minuto; un producto oculto o eliminado traeremoved: true. No los vendas. - Los cambios del catálogo se avisan por webhook (
products.updated,catalog.changed), así que se puede consultar con poca frecuencia. GET /public/catalog?lang=(sin clave, caché de 10 minutos) devuelve cifras en directo y algunas portadas destacadas para tu propia landing.
Filtros, orden e idiomas
lang (en, es, de, fr, it, pt, pl; por defecto en) elige el idioma de nombres y descripciones. Cada producto trae language con el idioma real del texto (en si falta la traducción). Un idioma o varios: llama una vez por idioma, o importa los siete para tiendas con WPML/Polylang o multilingües. Las listas aceptan valores separados por comas.
| Parámetro | Valores / significado |
|---|---|
| platform | Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft, … (ver /meta) |
| region | Etiqueta de región (Global, Europe, …); ver /meta |
| productType | game, dlc, software, gift-card, gift, subscription, game-point |
| deliveryType | key, gift (enlace Steam Gift), account, link (enlace de activación) |
| category | game, dlc, software, microsoft, gift-card, gift, subscription |
| genre | Nombre del género (ver /meta) |
| minPrice / maxPrice | EUR, precio de la API |
| inStock | true para listar solo lo que se puede vender ahora |
| search | Todas las palabras, contra el nombre y el título traducido |
| ids | Hasta 200 ids de producto |
| updatedSince / includeRemoved | Cambios desde una fecha; incluir los productos retirados |
| sort | updated, popularity, name, price_asc, price_desc, newest (con páginas; el cursor de sincronización siempre sigue updatedAt) |
| fields / limit / cursor / page | full o summary; hasta 100 (full) o 500 (summary); cursor para sincronizar; page para navegar |
# 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 devuelve las facetas con recuento y stock (plataformas, regiones, tipos de producto, géneros, idiomas, rango de precios y valores de sort) para que construyas tus propios filtros.
Campos del producto
{
"id": "prod-17298",
"name": "Terraria (Steam Gift)",
"language": "en",
"platform": "Steam",
"region": "Europe",
"productType": "game",
"deliveryType": "gift",
"category": "game",
"price": 3.71,
"shopPrice": 3.79,
"discountPercent": 2,
"rrp": 9.99,
"currency": "EUR",
"inStock": true,
"qty": 12,
"activation": { "excludedCountries": ["RU", "BY", "..."], "allowedCountryCount": 53 },
"shortDescription": "Dig, fight, explore, build.",
"description": "Plain-text description...",
"descriptionHtml": "<p>Clean HTML without links or images...</p>",
"features": ["Single player", "Co-op"],
"activationSteps": [],
"activationDetails": "You will receive a gift link...",
"systemRequirements": [ { "system": "Windows", "requirement": ["..."] } ],
"languages": ["English", "Spanish", "German"],
"genres": ["Action", "Adventure"],
"developer": "Re-Logic", "publisher": "Re-Logic", "releaseDate": "2011-05-16", "ageRating": "PEGI 12",
"coverImage": "https://buycheapkeys.com/...cover.webp",
"screenshots": ["https://buycheapkeys.com/..."],
"videos": ["https://www.youtube.com/watch?v=..."],
"url": "https://buycheapkeys.com/en/product/terraria-steam-europe-238023",
"updatedAt": "2026-11-19T10:05:12.881Z",
"removed": false
}| Campo | Significado |
|---|---|
| price | Tu precio unitario en EUR: precio de la web menos 2 %. Se revisa en directo al pedir. |
| shopPrice / discountPercent | Precio de la web y tu descuento (2). |
| rrp | PVP real si es mayor que el precio de la API; si no, null. |
| deliveryType | key = código a canjear · gift = enlace Steam Gift · account = credenciales de acceso · link = enlace de activación. Dile a tu cliente cuál compra. |
| region / activation | Etiqueta de región y lista ISO exacta de países donde NO se puede activar. |
| productType / category / edition / licenseType | Clasificación del producto. |
| language | Idioma de los textos de esta respuesta. |
| shortDescription / description / descriptionHtml / features | Textos. descriptionHtml es HTML limpio sin enlaces ni imágenes. |
| activationSteps / activationDetails / systemRequirements | Instrucciones de canje y requisitos. |
| languages / genres / developer / publisher / releaseDate / ageRating | Datos del juego. |
| coverImage / screenshots / videos | Imágenes de nuestro CDN (guárdalas en tu lado) y vídeos de YouTube. |
| qty | Unidades en stock (tope 999). |
| url | Página pública del producto en la web. |
Pedidos
POST /orders con externalId (tu referencia única) e items (productId, qty 1–9, maxUnitPrice). En cada línea comprobamos el precio real: si supera maxUnitPrice se rechaza todo el pedido con PRICE_CHANGED y no se cobra nada. Si es menor, pagas el menor. Vende el origen más barato con stock, como en la web.
Recomendado: envía storeUrl (la URL de tu tienda donde se vende el producto) en el cuerpo de POST /orders, o la cabecera X-Store-Url en cualquier llamada. Es opcional; el plugin de WordPress envía la URL de tu web automáticamente.
Código promocional: añade couponCode: MICROSOFT20 para pagar un 20 % menos en productos Microsoft (Windows, Office, Visio, Project, SQL Server) mientras dure la promoción. Solo se aplica a esas líneas; un código desconocido o una promoción terminada devuelve INVALID_COUPON y no se cobra nada.
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
}- Envía la cabecera
Idempotency-Key(8–100 caracteres) y reutilízala al reintentar: recibes la respuesta original y nunca se cobra dos veces.externalIdtambién es único por cuenta. - El pedido se completa en la misma petición (
?wait=20espera hasta 20 s): la respuesta trae estadocompletedy un arraykeys. Una petición repetida devuelve el pedido sin claves ykeysOmitted: true: léelas con GET /orders/{id}/keys. - Sin stock o con saldo insuficiente no se cobra nada ni se usa ninguna clave (
OUT_OF_STOCK,INSUFFICIENT_BALANCE).maxUnitPricees un tope para cada clave. - Si una petición expira, envíala otra vez con el mismo externalId: recibes
DUPLICATE_EXTERNAL_IDcon el id del pedido y puedes leer sus claves.
| Estado | Significado |
|---|---|
| completed | Todas las unidades entregadas. Las claves van en la respuesta. |
| partially_refunded | Se reembolsaron algunas claves a tu saldo tras reclamaciones. |
| refunded | Todas las claves del pedido se reembolsaron a tu saldo. |
Entrega de claves
GET /orders/{id}/keys devuelve cada unidad entregada: value contiene el código, la URL de Steam Gift, las credenciales de la cuenta o el enlace de activación según deliveryType. contentType es text/plain o un tipo de imagen (entonces value va en base64).
Guarda las claves cifradas y muéstralas solo al comprador. La primera descarga de cada pedido queda registrada en nuestro lado como prueba de entrega.
Reclamaciones y reembolsos
Una clave defectuosa se puede reclamar durante 14 días. Abre el pedido en Panel → Pedidos (pedidos API), elige la clave, escribe al vendedor y adjunta capturas del error de activación. El vendedor puede enviar una clave de reemplazo (aparece en tu pedido y recibes el webhook key.replaced) o reembolsar la clave (el precio vuelve a tu saldo API una sola vez y recibes order.refunded). Si no estás de acuerdo, escala y decide BuyCheapKeys.
Comprueba la región, excludedCountries y el tipo de licencia antes de vender y muéstraselos a tu cliente. El reembolso a tu saldo no reembolsa a tu propio cliente: eso lo decides tú.
Tarjetas regalo BuyCheapKeys en bloque
Además de las gift cards de otras marcas (son productos del catálogo, productType=gift-card), puedes comprar nuestras propias tarjetas regalo para revenderlas: códigos BCK-XXXX-XXXX-XXXX-XXXX que suman su valor a la Wallet de BuyCheapKeys de quien los canjea en buycheapkeys.com/wallet. GET /gift-cards devuelve los valores en venta, los descuentos por volumen, los máximos por pedido y el saldo de tu Wallet. POST /gift-cards/orders compra N tarjetas de un valor y devuelve los códigos al instante; GET /gift-cards/orders/{id} los muestra de nuevo con el estado de cada código.
curl https://buycheapkeys.com/partner-api/v1/gift-cards \
-H "Authorization: Bearer $BCK_API_KEY"- Se paga solo con la Wallet de BuyCheapKeys de la cuenta de tu tienda (recárgala en buycheapkeys.com/wallet), no con el saldo API. Precio = valor nominal menos el descuento por volumen de esa cantidad.
- Valores, descuentos y máximos pueden cambiar: envía
maxTotalpara rechazar un total mayor (PRICE_CHANGED, no se cobra nada).Idempotency-Keyy elexternalIdúnico funcionan igual que en los pedidos. - Venta en pausa:
PRODUCT_UNAVAILABLE(409). Valor no vendido o cantidad fuera de rango:VALIDATION_ERROR. Pedido demasiado grande:ORDER_LIMIT_EXCEEDED. Wallet sin saldo suficiente:INSUFFICIENT_BALANCE(402). - Las claves sandbox devuelven códigos falsos
BCK-TEST-…que no se pueden canjear y no cobran nada. - Los códigos vendidos son definitivos. Cada código tiene fecha de caducidad (
expiresAt) y límites de canje por cuenta. Un código que bloqueamos por fraude deja de mostrarse (code: null, estadoblocked). Guarda los códigos cifrados.
Webhooks
Indica una URL https en Panel → Webhooks (o con PUT /webhook); recibes un secreto de firma (whsec_…). Cada evento es un POST con las cabeceras X-BCK-Event, X-BCK-Delivery (id único: descarta duplicados con él) y X-BCK-Signature: t=<unix>,v1=<hex>, donde v1 = HMAC-SHA256(secreto, t + "." + cuerpoSinProcesar).
| Evento | Cuándo |
|---|---|
| order.completed | Se completó un pedido. |
| order.refunded | Una reclamación terminó en reembolso a tu saldo (`refundedSale`, `amount`). |
| products.updated | Cambió el precio, el stock o la disponibilidad de productos: `data.products` trae hasta 100 productos en formato summary por evento (`removed: true` si se retira). |
| catalog.changed | Cambiaron más de 1000 productos a la vez: haz la sincronización con el cursor (`fields=summary`) en vez de leer el evento. |
| product.updated | Solo productos de Windows y Office curados a mano (plugin 1.0): `data.product` trae el producto completo. |
| key.replaced | Un vendedor reemplazó una clave: `oldKeyId`, `newKeyId`; lee la nueva con GET /orders/{id}/keys. |
| balance.credited | Se añadió una recarga a tu saldo. |
| webhook.test | Lo envía POST /webhooks/test o el botón del panel. |
{
"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}" }
}- Responde 2xx en menos de 8 s y haz el trabajo de forma asíncrona. No se siguen redirecciones.
- Las entregas fallidas se reintentan a los 10 s, 30 s, 1 min, 5 min, 15 min, 30 min, 1 h, 2 h, 4 h, 6 h y 12 h (~26 h).
- Los eventos pueden llegar desordenados o repetidos: ante la duda, vuelve a leer GET /orders/{id} o el cursor.
Errores
Los errores usan códigos HTTP y un code estable. Cita requestId al contactar con soporte.
{
"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 | Significado | Qué hacer |
|---|---|---|---|
| UNAUTHORIZED | 401 | Clave ausente, inválida, revocada o caducada. | Revisa la clave o crea otra en el panel. |
| ACCOUNT_NOT_ACTIVE | 403 | Cuenta de partner pendiente, suspendida o rechazada. | Contáctanos. |
| IP_NOT_ALLOWED | 403 | La IP no está en tu lista blanca. | Añádela en Panel → Webhooks y seguridad. |
| INSUFFICIENT_SCOPE | 403 | La clave no tiene permiso para este endpoint. | Crea una clave con ese permiso. |
| NOT_FOUND | 404 | Producto, pedido o ruta desconocidos. | — |
| VALIDATION_ERROR | 400 | Cuerpo o parámetros inválidos (details indica cada campo). | Corrige la petición; no la repitas igual. |
| INSUFFICIENT_BALANCE | 402 | Saldo insuficiente. No se ha cobrado nada. | Recarga y reintenta. |
| PRICE_CHANGED | 409 | El precio real supera maxUnitPrice. No se ha cobrado nada. | Actualiza el precio (details.currentPrice) y reintenta. |
| INVALID_COUPON | 400 | couponCode desconocido o promoción terminada. No se ha cobrado nada. | Quita el código o envía el vigente (MICROSOFT20). |
| OUT_OF_STOCK | 409 | No hay unidades suficientes. No se ha cobrado nada. | Reintenta más tarde u oculta el producto. |
| PRODUCT_UNAVAILABLE | 409 | Producto no vendible por API. | Retíralo de tu tienda. |
| DUPLICATE_EXTERNAL_ID | 409 | externalId ya usado; details.orderId es el pedido existente. | Consulta ese pedido. |
| IDEMPOTENCY_CONFLICT | 409 | Idempotency-Key reutilizada con otro cuerpo. | Usa una clave nueva por pedido. |
| IDEMPOTENCY_IN_PROGRESS | 409 | La misma Idempotency-Key se está procesando. | Reintenta en unos segundos. |
| ORDER_LIMIT_EXCEEDED | 422 | Total por encima de tu límite por pedido. | Divide el pedido o pide un límite mayor. |
| DAILY_LIMIT_EXCEEDED | 422 | Límite de gasto de 24 h alcanzado. | Espera o pide un límite mayor. |
| RATE_LIMITED | 429 | Demasiadas peticiones. | Espera (details.retryAfterMs). |
| SERVICE_UNAVAILABLE | 503 | No se puede vender temporalmente. No se ha cobrado nada. | Reintenta con espera exponencial. |
| INTERNAL_ERROR | 500 | Error inesperado (registrado con requestId). | Reintenta con la misma Idempotency-Key. |
Límites
| Límite | Valor |
|---|---|
| Peticiones por clave | 20 / segundo y 600 / minuto |
| Pedidos por cuenta | 120 / minuto |
| Descargas de claves por cuenta | 300 / minuto |
| Líneas por pedido / unidades por línea | 10 / 9 |
| Importe del pedido y gasto en 24 h | Por cuenta (ver Panel → Resumen); pídenos subirlos |
| Tamaño de página | 100 productos (fields=full), 500 (fields=summary), 100 pedidos |
| Filtro ids | 200 ids |
Saldo, Wallet y recargas
Los pedidos se cobran de tu saldo API prepago y, si no llega, de la Wallet de tu cuenta. GET /balance devuelve el saldo del modo de la clave; GET /me muestra además walletBalance y available. Recarga desde Panel → Saldo (por ejemplo 500 EUR, y cada pedido se cobra solo): recibes una referencia única para la transferencia bancaria, o puedes pagar online; el importe se abona al llegar (email + webhook balance.credited). Cada movimiento aparece en el libro de movimientos.
Implementarlo con una IA
Documentación legible por máquinas: https://buycheapkeys.com/reseller-api.es.md (esta página en Markdown; /reseller-api.md en inglés), la especificación OpenAPI 3.1 https://buycheapkeys.com/partner-api/v1/openapi.json y https://buycheapkeys.com/llms.txt. Dale estas URL a tu asistente de IA junto con el prompt de abajo.
Integración de referencia completa (Node.js 18+, sin dependencias): https://buycheapkeys.com/developers/bck-partner-client.mjs: sincronización del catálogo con cursor, pedidos seguros con reintentos e idempotencia, descarga de claves y receptor de webhooks con verificación de firma.
curl -O https://buycheapkeys.com/developers/bck-partner-client.mjs
export BCK_API_KEY=bck_test_... # clave sandbox de Panel → Partner → Claves API
node bck-partner-client.mjs balance
node bck-partner-client.mjs sync
node bck-partner-client.mjs order <productId> 1 <maxUnitPrice>- Invariante 1: vende solo productos con inStock=true y removed=false; resincroniza cada 1–5 min desde el nextCursor guardado.
- Invariante 2: un pedido de cliente = un externalId = una Idempotency-Key; reutiliza ambos en cada reintento.
- Invariante 3: envía siempre maxUnitPrice; los errores de negocio 4xx son definitivos y no se cobró nada.
- Invariante 4: reintenta solo errores de red, 429, 5xx e IDEMPOTENCY_IN_PROGRESS, con espera exponencial.
- Invariante 5: nunca vuelvas a pedir tras un timeout: repite el mismo externalId y lee las claves del pedido existente.
- Invariante 6: guarda la clave API en el servidor; verifica las firmas de los webhooks; muestra al cliente el deliveryType, la región y los países excluidos.
Lista para salir a producción
- Guarda las claves API solo en tu servidor (nunca en navegadores ni apps) y en un gestor de secretos o variables de entorno.
- Usa claves distintas por sistema y los permisos mínimos; activa la lista blanca de IP.
- Envía siempre maxUnitPrice y una Idempotency-Key, y envía storeUrl (o la cabecera X-Store-Url) con la URL de tu tienda.
- Verifica la firma y la marca de tiempo de cada webhook antes de fiarte de él.
- Prueba todo el flujo con una clave bck_test_, luego pasa a bck_live_ y recarga tu saldo.
- Rota las claves y el secreto del webhook si sospechas una fuga y revoca las antiguas.
