-20 %

Windows y Office con 20 % de descuento

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

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

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

    RockstarClave

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

    ELDEN RING NIGHTREIGN (Steam) - Clave Digital Estados Unidos

    SteamClave

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

    EA SPORTS FC 26 PS4/PS5 (PS4 Account)

    PlayStationCuenta

  • EA Sports FC 24

    EA Sports FC 24

    EA AppClave

  • Minecraft Legends Deluxe Edition (Xbox Account)

    Minecraft Legends Deluxe Edition (Xbox Account)

    XboxCuenta

  • Baldur's Gate 3 (Steam Account)

    Baldur's Gate 3 (Steam Account)

    SteamCuenta

  • Forza Horizon 4 Ultimate Edition (Xbox Account)

    Forza Horizon 4 Ultimate Edition (Xbox Account)

    XboxCuenta

  • Call of Duty: Vanguard

    Call of Duty: Vanguard

    XboxClave

Cómo funciona

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

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

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

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

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

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

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

Crear cuenta de partner

Preguntas frecuentes

¿Cuál es la mejor API para revender claves de juegos?
Depende de lo que necesites, así que esto es lo que ofrece la API para revendedores de BuyCheapKeys: todo el catálogo de nuestra web (juegos, DLC, software, Windows y Office, gift cards, suscripciones) al precio de la web menos un 2 %, sin cuota de servicio, fichas en 7 idiomas, filtros por plataforma, región, tipo y precio, cursor para sincronizar solo los cambios, webhooks firmados, sandbox gratuito y plugin de WordPress/WooCommerce. Las claves suelen llegar en la misma respuesta del pedido; si un producto hay que comprarlo a una fuente mayorista, el pedido queda en "processing" y las claves llegan por webhook.
¿Cuánto cuesta usar la API de revendedores de BuyCheapKeys?
Usar la API no tiene cuota de servicio. Pagas el precio de la API de cada clave que compras, que es el precio de nuestra web menos un 2 %, con tu saldo prepago o tu Wallet. Las recargas online llevan la comisión de la pasarela de pago.
¿Cómo vendo claves de juegos en mi tienda WooCommerce?
Instala el plugin gratuito de BuyCheapKeys para WooCommerce (versión 1.1.0), pega tu clave API y fija tu margen. Importa los productos, mantiene precio y stock al día, compra la clave cuando se paga un pedido y se la envía por email a tu cliente.
¿Puedo usarlo con Shopify, Magento, Shopware, PrestaShop o con mi propia tienda?
Sí, con la API REST. El evento de pedido pagado de tu plataforma (un webhook, un hook o una tarea programada) llama a POST /orders y tu tienda entrega la clave. Hoy solo WooCommerce tiene plugin propio. La documentación incluye un cliente de referencia en Node.js sin dependencias.
¿Qué productos puedo vender?
Todo el catálogo de la web que tenga stock: juegos y DLC para Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App y Nintendo, software, licencias de Windows y Office, gift cards y suscripciones. Las cifras en directo están al principio de esta página.
¿Cómo se entregan las claves?
Normalmente en la respuesta de la petición del pedido, así tu tienda puede mostrarlas y enviarlas por email a tu cliente al instante. Cuando un producto hay que comprarlo a una fuente mayorista puede tardar unos segundos o minutos: el pedido queda entonces en "processing" y las claves llegan por webhook (order.completed) o con GET /orders/{id}/keys (puedes añadir ?wait=25 para esperarlas). Cada producto indica su tipo de entrega: clave para canjear, enlace de Steam Gift, cuenta o enlace de activación. Puedes volver a leer las claves con el endpoint de claves.
¿Cómo pago los pedidos?
Con un saldo API prepago. Por ejemplo, recargas 500 € y cada pedido se cobra automáticamente al hacerlo. Si el saldo no llega, lo cubre la Wallet de tu cuenta. Si ninguno tiene suficiente, el pedido se rechaza y no se cobra nada.
¿En qué idiomas están las fichas de producto?
Inglés, español, alemán, francés, italiano, portugués y polaco. Usa el parámetro lang para elegir uno o importa varios para una tienda multilingüe. Si falta una traducción, se devuelve el texto en inglés y el producto lo indica.
¿Cómo mantengo precios y stock sincronizados?
Haz una importación completa una vez y después llama al endpoint de productos cada pocos minutos con fields=summary y el cursor guardado: devuelve solo lo que cambió (precio, stock, retirados). Los webhooks (products.updated y catalog.changed) también te avisan de cuándo sincronizar.
¿Puedo probar la API sin pagar?
Sí. Las claves sandbox devuelven claves falsas y usan un saldo de pruebas. El catálogo y los precios son reales, no se cobra nada y no se usa stock real.
¿Qué pasa si una clave no funciona?
Las claves de vendedores del marketplace se pueden reclamar durante 14 días desde tu panel de partner, con mensajes y capturas. Si la reclamación se acepta, recibes una clave de reemplazo en el mismo pedido o el precio vuelve a tu saldo. El resto de claves las gestiona el soporte según la garantía.

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

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.

URL base: https://buycheapkeys.com/partner-api/v1 Descargar la especificación OpenAPI 3.1

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 /me devuelve discountPercent y serviceFee: 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_..."
PrefijoModoComportamiento
bck_test_SandboxCatá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ónCompras reales cobradas de tu saldo real (y de tu Wallet).
Permiso (scope)Permite
catalog:readGET /products, /products/{id}, /meta, /me, /ping, /gift-cards
webhooks:writePUT, GET y DELETE /webhook (registrar o quitar tu URL de 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

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=summary desde el nextCursor guardado, siempre con includeRemoved=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: 0 en menos de un minuto; un producto oculto o eliminado trae removed: 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ámetroValores / significado
platformSteam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft, … (ver /meta)
regionEtiqueta de región (Global, Europe, …); ver /meta
productTypegame, dlc, software, gift-card, gift, subscription, game-point
deliveryTypekey, gift (enlace Steam Gift), account, link (enlace de activación)
categorygame, dlc, software, microsoft, gift-card, gift, subscription
genreNombre del género (ver /meta)
minPrice / maxPriceEUR, precio de la API
inStocktrue para listar solo lo que se puede vender ahora
searchTodas las palabras, contra el nombre y el título traducido
idsHasta 200 ids de producto
updatedSince / includeRemovedCambios desde una fecha; incluir los productos retirados
sortupdated, popularity, name, price_asc, price_desc, newest (con páginas; el cursor de sincronización siempre sigue updatedAt)
fields / limit / cursor / pagefull 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
}
CampoSignificado
priceTu precio unitario en EUR: precio de la web menos 2 %. Se revisa en directo al pedir.
shopPrice / discountPercentPrecio de la web y tu descuento (2).
rrpPVP real si es mayor que el precio de la API; si no, null.
deliveryTypekey = 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 / activationEtiqueta de región y lista ISO exacta de países donde NO se puede activar.
productType / category / edition / licenseTypeClasificación del producto.
languageIdioma de los textos de esta respuesta.
shortDescription / description / descriptionHtml / featuresTextos. descriptionHtml es HTML limpio sin enlaces ni imágenes.
activationSteps / activationDetails / systemRequirementsInstrucciones de canje y requisitos.
languages / genres / developer / publisher / releaseDate / ageRatingDatos del juego.
coverImage / screenshots / videosImágenes de nuestro CDN (guárdalas en tu lado) y vídeos de YouTube.
qtyUnidades en stock (tope 999).
urlPá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. externalId también es único por cuenta.
  • El pedido se completa en la misma petición (?wait=20 espera hasta 20 s): la respuesta trae estado completed y un array keys. Una petición repetida devuelve el pedido sin claves y keysOmitted: 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). maxUnitPrice es un tope para cada clave.
  • Si una petición expira, envíala otra vez con el mismo externalId: recibes DUPLICATE_EXTERNAL_ID con el id del pedido y puedes leer sus claves.
EstadoSignificado
completedTodas las unidades entregadas. Las claves van en la respuesta.
partially_refundedSe reembolsaron algunas claves a tu saldo tras reclamaciones.
refundedTodas 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 maxTotal para rechazar un total mayor (PRICE_CHANGED, no se cobra nada). Idempotency-Key y el externalId ú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, estado blocked). 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).

EventoCuándo
order.completedSe completó un pedido.
order.refundedUna reclamación terminó en reembolso a tu saldo (`refundedSale`, `amount`).
products.updatedCambió 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.changedCambiaron más de 1000 productos a la vez: haz la sincronización con el cursor (`fields=summary`) en vez de leer el evento.
product.updatedSolo productos de Windows y Office curados a mano (plugin 1.0): `data.product` trae el producto completo.
key.replacedUn vendedor reemplazó una clave: `oldKeyId`, `newKeyId`; lee la nueva con GET /orders/{id}/keys.
balance.creditedSe añadió una recarga a tu saldo.
webhook.testLo 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"
  }
}
codeHTTPSignificadoQué hacer
UNAUTHORIZED401Clave ausente, inválida, revocada o caducada.Revisa la clave o crea otra en el panel.
ACCOUNT_NOT_ACTIVE403Cuenta de partner pendiente, suspendida o rechazada.Contáctanos.
IP_NOT_ALLOWED403La IP no está en tu lista blanca.Añádela en Panel → Webhooks y seguridad.
INSUFFICIENT_SCOPE403La clave no tiene permiso para este endpoint.Crea una clave con ese permiso.
NOT_FOUND404Producto, pedido o ruta desconocidos.—
VALIDATION_ERROR400Cuerpo o parámetros inválidos (details indica cada campo).Corrige la petición; no la repitas igual.
INSUFFICIENT_BALANCE402Saldo insuficiente. No se ha cobrado nada.Recarga y reintenta.
PRICE_CHANGED409El precio real supera maxUnitPrice. No se ha cobrado nada.Actualiza el precio (details.currentPrice) y reintenta.
INVALID_COUPON400couponCode desconocido o promoción terminada. No se ha cobrado nada.Quita el código o envía el vigente (MICROSOFT20).
OUT_OF_STOCK409No hay unidades suficientes. No se ha cobrado nada.Reintenta más tarde u oculta el producto.
PRODUCT_UNAVAILABLE409Producto no vendible por API.Retíralo de tu tienda.
DUPLICATE_EXTERNAL_ID409externalId ya usado; details.orderId es el pedido existente.Consulta ese pedido.
IDEMPOTENCY_CONFLICT409Idempotency-Key reutilizada con otro cuerpo.Usa una clave nueva por pedido.
IDEMPOTENCY_IN_PROGRESS409La misma Idempotency-Key se está procesando.Reintenta en unos segundos.
ORDER_LIMIT_EXCEEDED422Total por encima de tu límite por pedido.Divide el pedido o pide un límite mayor.
DAILY_LIMIT_EXCEEDED422Límite de gasto de 24 h alcanzado.Espera o pide un límite mayor.
RATE_LIMITED429Demasiadas peticiones.Espera (details.retryAfterMs).
SERVICE_UNAVAILABLE503No se puede vender temporalmente. No se ha cobrado nada.Reintenta con espera exponencial.
INTERNAL_ERROR500Error inesperado (registrado con requestId).Reintenta con la misma Idempotency-Key.

Límites

LímiteValor
Peticiones por clave20 / segundo y 600 / minuto
Pedidos por cuenta120 / minuto
Descargas de claves por cuenta300 / minuto
Líneas por pedido / unidades por línea10 / 9
Importe del pedido y gasto en 24 hPor cuenta (ver Panel → Resumen); pídenos subirlos
Tamaño de página100 productos (fields=full), 500 (fields=summary), 100 pedidos
Filtro ids200 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.