-20%

20% de desconto em Windows e Office

Para lojas online e programadores

Vende todo o nosso catálogo na tua loja. Nós entregamos as chaves.

Jogos, DLC, software, Windows e Office, gift cards e subscrições, por API REST ou com o plugin de WordPress. Quando o teu cliente paga, a chave é comprada e entregue automaticamente e cobrada do teu saldo pré-pago (por exemplo, carregas 500 € e cada encomenda é cobrada sozinha) ou da tua Wallet.

  • 2% mais barato que o nosso site

    O preço da API é o preço do nosso site menos 2%, em todos os produtos do catálogo.

  • Sem taxa de serviço

    O site acrescenta uma taxa no checkout. A API não: pagas o preço da API e mais nada.

  • Saldo pré-pago ou Wallet

    Carregas uma vez e cada encomenda é cobrada automaticamente. Se o saldo não chegar, a Wallet da tua conta cobre a diferença.

Funciona com

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

Promoção ativa

20% de desconto em todos os produtos Microsoft

Adiciona o código às tuas encomendas e pagas 20% menos por cada licença de Windows, Office, Visio, Project e SQL Server. Sem taxas nem mínimos.

Campo da API

"couponCode": "MICROSOFT20"

Em resumo

A BuyCheapKeys oferece às lojas online uma API REST e um plugin de WordPress/WooCommerce para revender todo o seu catálogo: jogos, DLC, software, Windows e Office, gift cards e subscrições. O preço da API é o preço do site menos 2%, sem taxa de serviço. A loja importa as fichas de produto numa ou várias das 7 línguas, mantém preço e stock sincronizados com um cursor e pede uma chave quando o seu próprio cliente paga. A chave costuma vir na resposta da encomenda (ou mais tarde por webhook se a encomenda ainda estiver em curso) e é paga com o saldo pré-pago da loja ou com a sua Wallet. Há um sandbox gratuito.

Atualizado:

O catálogo que podes vender, em direto

Estes números vêm diretamente da API e atualizam-se a cada poucos minutos. Os preços não são publicados nesta página: vês-los com a tua chave.

33.457
produtos em stock
19
plataformas com stock
32.839
jogos e DLC em stock
498
produtos de software em stock
120
subscrições em stock

Plataformas com mais produtos

  • Steam 25.960
  • Xbox 4.579
  • PlayStation 1.119
  • GOG 426
  • Epic Games 410
  • Ubisoft Connect 330
  • PC 305
  • Microsoft 137
  • EA App 120
  • Rockstar 17
  • Nintendo 13
  • Mac 11

Parte do que podes vender hoje

Uma amostra de capas do catálogo. Cada produto traz a sua ficha: descrição, passos de ativação, requisitos, capturas e região.

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

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

    RockstarChave

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

    ELDEN RING NIGHTREIGN (Steam) - Chave Digital Estados Unidos

    SteamChave

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

    EA SPORTS FC 26 PS4/PS5 (PS4 Account)

    PlayStationConta

  • EA Sports FC 24

    EA Sports FC 24

    EA AppChave

  • Minecraft Legends Deluxe Edition (Xbox Account)

    Minecraft Legends Deluxe Edition (Xbox Account)

    XboxConta

  • Baldur's Gate 3 (Steam Account)

    Baldur's Gate 3 (Steam Account)

    SteamConta

  • Forza Horizon 4 Ultimate Edition (Xbox Account)

    Forza Horizon 4 Ultimate Edition (Xbox Account)

    XboxConta

  • Call of Duty: Vanguard

    Call of Duty: Vanguard

    XboxChave

Como funciona

  1. 01

    Cria a tua conta

    Pede o registo como parceiro e cria uma chave sandbox para testar tudo com chaves falsas. No sandbox não se move dinheiro.

  2. 02

    Importa o catálogo

    Lê o endpoint de produtos com os filtros de que precisas (plataforma, região, tipo, preço) numa ou várias línguas e mantém preço e stock atualizados com o cursor.

  3. 03

    O teu cliente paga

    A venda acontece na tua loja, com o teu preço e os teus métodos de pagamento. A tua loja faz um único pedido: POST /orders com o produto e o preço máximo que aceitas.

  4. 04

    A chave é entregue

    A chave costuma voltar na mesma resposta (se a encomenda ficar em "processing", chega por webhook ou com GET /orders/{id}/keys), é cobrada do teu saldo ou Wallet e a tua loja envia-a ao teu cliente. O plugin de WordPress faz tudo isto sozinho.

Filtros e formatos

Vende só o que se adequa à tua loja. Todos os filtros funcionam no endpoint de produtos e podem combinar-se.

  • Formato de entrega

    Chave para resgatar, link de oferta (Steam Gift), conta ou link de ativação. Cada produto indica qual é.

  • Plataforma

    Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft e mais.

  • Região

    A região de cada chave e a lista exata de países onde não pode ser ativada.

  • Tipo de produto

    Jogos, DLC, software, Windows e Office, gift cards e subscrições.

  • Preço

    Preço mínimo e máximo, e ordenação por preço, popularidade, nome ou novidade.

  • Stock e alterações

    Só o que tem stock, ou só o que mudou desde a tua última sincronização.

Fichas de produto em 7 línguas

Nomes, descrições e passos de ativação estão disponíveis em inglês, espanhol, alemão, francês, italiano, português e polaco. Escolhe uma língua ou importa várias de uma vez para uma loja multilingue com WPML ou Polylang. Cada produto indica a língua real do seu texto.

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

Paga com saldo pré-pago ou com a tua Wallet

Carrega o teu saldo uma vez, por exemplo 500 €, e cada encomenda é cobrada automaticamente no momento em que o teu cliente paga. Se o saldo não chegar, a Wallet da tua conta cobre o resto. Cada movimento fica no teu registo e um webhook avisa-te quando chega um carregamento.

Sandbox gratuito

As chaves sandbox (bck_test_) usam o catálogo e os preços reais, mas devolvem chaves falsas e um saldo de teste. Não se cobra nada nem se usa stock real, por isso podes construir e testar todo o fluxo primeiro.

Webhooks assinados

Recebe avisos quando uma encomenda é concluída ou reembolsada, quando uma chave é substituída e quando os produtos mudam (products.updated e catalog.changed). Cada evento é assinado com HMAC-SHA256 e repetido durante cerca de um dia.

Plugin de WordPress e WooCommerce

Se a tua loja usa WordPress não precisas de programar. Instala o plugin, cola a tua chave API e escolhe a tua margem.

Versão 1.1.0 · grátis · WordPress + WooCommerce

Descarregar o plugin
  • Importa cada produto com a sua ficha, passos de ativação e requisitos
  • Atualiza preço e stock automaticamente, com a tua margem e arredondamento
  • Verifica o carrinho antes do pagamento e bloqueia os produtos que não podem ser entregues
  • Compra a chave quando a encomenda é paga e envia-a por email ao teu cliente
  • Mostra a chave na página da encomenda e em A minha conta, guardada cifrada
  • Tenta de novo sozinho se algo falhar e avisa-te por email

Documentação da API

Tudo o que precisas para integrar: autenticação, sincronização do catálogo, filtros, encomendas, entrega de chaves, reclamações, webhooks, erros e limites.

Ler a documentação da 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 com Shopify, Shopware, Magento, PrestaShop e qualquer outra plataforma de lojas

Se a tua plataforma consegue enviar um pedido quando uma encomenda é paga, consegue vender o nosso catálogo. Isso inclui a lista abaixo, com mais de 120 nomes, e qualquer loja que tenhas programado. O único plugin que temos hoje é o de WooCommerce. Nas restantes ligas-te com a API REST.

Como se liga em qualquer plataforma

  1. 01

    Catálogo

    Leia o endpoint de produtos para importar nomes, descrições, passos de ativação e imagens, e para manter preço e stock em dia.

  2. 02

    Encomenda paga

    A sua plataforma dispara o evento de encomenda paga: um webhook, um hook, um fluxo ou uma tarefa agendada. Esse evento chama POST /orders com o produto e o preço máximo que aceita.

  3. 03

    Entrega

    A resposta traz a chave. A sua loja envia-a por email ao cliente e mostra-a na encomenda. Se a chave ainda não estiver pronta, o webhook order.completed avisa quando estiver.

Vias habituais por plataforma

Cada plataforma tem a sua forma de reagir a uma encomenda paga. Estas são as que a maioria das lojas usa. O seu programador, ou uma ferramenta como Zapier ou Make, consegue montar qualquer uma.

  • 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 as plataformas por tipo

Criadores de lojas 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 aberto e alojamento próprio

  • 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

Comércio empresarial e 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

Venda de produtos digitais

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

ERP e suites de gestão

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

Plataformas regionais

  • 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

Ferramentas de automatização

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

Lojas feitas por medida

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

A sua plataforma não está na lista?

Se consegue chamar um URL quando um pagamento é confirmado, funciona. Escreva para partners@buycheapkeys.com e indicamos-lhe o acionador certo.

Criar conta de parceiro

Perguntas frequentes

Qual é a melhor API para revender chaves de jogos?
Depende do que precisas, por isso aqui fica o que a API para revendedores da BuyCheapKeys oferece: todo o catálogo do nosso site (jogos, DLC, software, Windows e Office, gift cards, subscrições) ao preço do site menos 2%, sem taxa de serviço, fichas em 7 línguas, filtros por plataforma, região, tipo e preço, um cursor para sincronização incremental, webhooks assinados, sandbox gratuito e plugin de WordPress/WooCommerce. As chaves costumam vir na mesma resposta da encomenda; se um produto tiver de ser comprado a uma fonte grossista, a encomenda fica em "processing" e as chaves chegam por webhook.
Quanto custa a API para revendedores da BuyCheapKeys?
Usar a API não tem taxa de serviço. Pagas o preço da API de cada chave que compras, que é o preço do nosso site menos 2%, com o teu saldo pré-pago ou a tua Wallet. Os carregamentos online incluem a comissão do gateway de pagamento.
Como vendo chaves de jogos na minha loja WooCommerce?
Instala o plugin gratuito da BuyCheapKeys para WooCommerce (versão 1.1.0), cola a tua chave API e define a tua margem. Importa os produtos, mantém preço e stock atualizados, compra a chave quando uma encomenda é paga e envia-a por email ao teu cliente.
Posso usá-la com Shopify, Magento, Shopware, PrestaShop ou com a minha própria loja?
Sim, com a API REST. O evento de encomenda paga da tua plataforma (um webhook, um hook ou uma tarefa agendada) chama POST /orders e a tua loja entrega a chave. Hoje só o WooCommerce tem plugin próprio. A documentação inclui um cliente de referência em Node.js sem dependências.
Que produtos posso vender?
Todo o catálogo do site que tenha stock: jogos e DLC para Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App e Nintendo, software, licenças de Windows e Office, gift cards e subscrições. Os números em direto estão no início desta página.
Como são entregues as chaves?
Normalmente na resposta ao pedido da encomenda, para a tua loja as poder mostrar e enviar por email ao teu cliente de imediato. Quando um produto tem de ser comprado a uma fonte grossista pode demorar alguns segundos ou minutos: a encomenda fica então em "processing" e as chaves chegam por webhook (order.completed) ou com GET /orders/{id}/keys (podes juntar ?wait=25 para as esperar). Cada produto indica o seu tipo de entrega: chave para resgatar, link Steam Gift, conta ou link de ativação. Podes voltar a ler as chaves com o endpoint de chaves.
Como pago as encomendas?
Com um saldo API pré-pago. Por exemplo, carregas 500 € e cada encomenda é cobrada automaticamente ao ser feita. Se o saldo não chegar, a Wallet da tua conta cobre a diferença. Se nenhum chegar, a encomenda é recusada e não se cobra nada.
Em que línguas estão as fichas de produto?
Inglês, espanhol, alemão, francês, italiano, português e polaco. Usa o parâmetro lang para escolher uma ou importa várias para uma loja multilingue. Se faltar uma tradução, devolve-se o texto em inglês e o produto indica-o.
Como mantenho preços e stock sincronizados?
Faz uma importação completa uma vez e depois chama o endpoint de produtos a cada poucos minutos com fields=summary e o cursor guardado: devolve só o que mudou (preço, stock, removidos). Os webhooks (products.updated e catalog.changed) também te dizem quando sincronizar.
Posso testar a API sem pagar?
Sim. As chaves sandbox devolvem chaves falsas e usam um saldo de teste. O catálogo e os preços são reais, não se cobra nada e não se usa stock real.
O que acontece se uma chave não funcionar?
As chaves de vendedores do marketplace podem ser reclamadas durante 14 dias a partir do teu painel de parceiro, com mensagens e capturas. Se a reclamação for aceite, recebes uma chave de substituição na mesma encomenda ou o preço volta ao teu saldo. As restantes chaves são tratadas pelo suporte ao abrigo da garantia.

Começa a vender todo o catálogo

Cria uma conta de parceiro, testa no sandbox e passa a produção quando quiseres.

A BuyCheapKeys é um revendedor independente. Os nomes de plataformas e marcas pertencem aos seus proprietários e só são usados para descrever a compatibilidade. Verifica se o tipo de licença e a região convêm aos teus clientes e à lei do teu país.

Documentação da API

Conteúdo

API REST/JSON para vender todo o catálogo da BuyCheapKeys no seu próprio site. O preço da API é o preço do site menos 2 %, sem taxa de serviço. Cada encomenda é paga com o seu saldo pré-pago (ou com a sua Wallet) e as chaves chegam na mesma resposta.

URL base: https://buycheapkeys.com/partner-api/v1 Descarregar a especificação OpenAPI 3.1

Visão geral

URL base: https://buycheapkeys.com/partner-api/v1. Todos os pedidos e respostas são JSON (UTF-8). Os preços estão em EUR com duas casas decimais e não incluem IVA. As datas seguem o formato ISO 8601 em UTC.

  • Catálogo: todo o catálogo do site (jogos, DLC, software, Windows e Office, cartões-presente, subscrições) com fichas de produto em 7 idiomas (en, es, de, fr, it, pt, pl).
  • Preço: preço da API = preço do site menos 2 %, e sem taxa de serviço (o site cobra uma taxa no checkout; a API não). GET /me devolve discountPercent e serviceFee: 0.
  • Encomendas: compre até 10 linhas x 9 unidades por pedido; o total é cobrado de uma só vez ao seu saldo pré-pago e, se este não chegar, à sua Wallet.
  • Entrega: as chaves vêm na resposta da encomenda e podem ser consultadas de novo com GET /orders/{id}/keys.
  • Reclamações: uma chave defeituosa pode ser reclamada durante 14 dias a partir do seu painel de parceiro; uma chave de substituição chega automaticamente à sua encomenda e um reembolso volta para o seu saldo.

Usa WordPress/WooCommerce? Utilize o plugin (veja a secção Plugin acima): importa o catálogo, mantém preço e stock sincronizados e entrega as chaves sem código.

Autenticação e ambientes

Crie chaves em Painel → Parceiro → Chaves de API. Uma chave é mostrada uma só vez; apenas guardamos o seu hash. Envie-a no cabeçalho Authorization (também aceitamos X-Api-Key).

curl https://buycheapkeys.com/partner-api/v1/ping \
  -H "Authorization: Bearer bck_test_xxxxxxxxxxxx_..."
Prefixo da chaveModoComportamento
bck_test_SandboxCatálogo e preços reais, saldo de teste separado (reinicializável), chaves falsas como TEST-AB12C-…, sem movimento de dinheiro. Os webhooks são enviados com mode: test.
bck_live_ProduçãoCompras reais cobradas ao seu saldo real (e à Wallet).
Permissão (scope)Permite
catalog:readGET /products, /products/{id}, /meta, /me, /ping, /gift-cards
webhooks:writePUT, GET e DELETE /webhook (registar ou remover o URL do seu 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 de IPs permitidos opcional (IPv4/IPv6, CIDR) por conta. As chaves nunca expiram, a menos que sejam revogadas; para as rodar, crie uma chave nova e revogue a antiga. GET /public/catalog não precisa de chave.

Início rápido

1) Crie uma chave bck_test_. 2) Liste os produtos. 3) Faça uma encomenda: volta concluída, com as chaves. 4) Volte a ler as chaves em qualquer momento com GET /orders/{id}/keys. As contas ainda em aprovação podem usar chaves de sandbox.

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

Catálogo e sincronização

GET /products devolve os produtos ordenados por updatedAt (e depois por id). updatedAt só muda quando muda algo que lhe interessa (preço, stock, nome, região, textos, imagens). Sincronize com o cursor: cada resposta traz nextCursor e hasMore; devolva nextCursor como ?cursor= até hasMore ser falso e guarde-o para a execução seguinte. Nunca salta nem repete produtos, mesmo quando muitos partilham o mesmo carimbo temporal (o cursor segue sempre updatedAt; sort só se aplica quando navega por páginas).

Dois formatos: fields=full (por omissão, até 100 produtos por página) é a ficha completa; fields=summary (até 500 por página) devolve apenas id, price, shopPrice, currency, inStock, qty, updatedAt e removed, ideal para manter preço e stock atualizados 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: importação completa uma vez (fields=full, no(s) idioma(s) da sua loja) e depois, a cada 1–5 minutos, fields=summary a partir do nextCursor guardado, sempre com includeRemoved=true.
  • Disponibilidade: se o site não puder vender um produto (sem stock, stock desativado, custo acima do nosso limite) aparece como inStock: false, qty: 0 em menos de um minuto; um produto oculto ou eliminado tem removed: true. Nunca venda esses produtos.
  • As alterações ao catálogo são anunciadas por webhook (products.updated, catalog.changed), pelo que a consulta periódica pode ser pouco frequente.
  • GET /public/catalog?lang= (sem chave, em cache durante 10 minutos) devolve números em tempo real e algumas capas em destaque para a sua própria página de destino.

Filtros, ordenação e idiomas

lang (en, es, de, fr, it, pt, pl; por omissão en) escolhe o idioma dos nomes e das descrições. Cada produto tem language com o idioma real do texto (en quando falta uma tradução). Um idioma ou vários: faça uma chamada por idioma ou importe os sete para lojas multilingues com WPML/Polylang. As listas aceitam valores separados por vírgulas.

ParâmetroValores / significado
platformSteam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft, … (ver /meta)
regionEtiqueta de região (Global, Europe, …); ver /meta
productTypegame, dlc, software, gift-card, gift, subscription, game-point
deliveryTypekey, gift (link de Steam Gift), account, link (link de ativação)
categorygame, dlc, software, microsoft, gift-card, gift, subscription
genreNome do género (ver /meta)
minPrice / maxPriceEUR, preço da API
inStocktrue para listar apenas o que pode ser vendido agora
searchTodas as palavras, comparadas com o nome e o título traduzido
idsAté 200 ids de produto
updatedSince / includeRemovedAlterações desde uma data; incluir produtos retirados
sortupdated, popularity, name, price_asc, price_desc, newest (com páginas; o cursor de sincronização segue sempre updatedAt)
fields / limit / cursor / pagefull ou summary; até 100 (full) ou 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 devolve as facetas com contagens e stock (plataformas, regiões, tipos de produto, géneros, idiomas, intervalo de preços, valores de ordenação) para que construa os seus próprios filtros.

Campos do produto

{
  "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
priceO seu preço unitário em EUR: preço do site menos 2 %. Reverificado em tempo real quando encomenda.
shopPrice / discountPercentPreço do site e o seu desconto (2).
rrpPreço de retalho real quando é superior ao preço da API; caso contrário, null.
deliveryTypekey = código a resgatar · gift = link de Steam Gift · account = credenciais de acesso · link = link de ativação. Diga ao seu cliente qual deles está a comprar.
region / activationEtiqueta de região e a lista ISO exata de países onde NÃO pode ser ativado.
productType / category / edition / licenseTypeClassificação do produto.
languageIdioma dos textos desta resposta.
shortDescription / description / descriptionHtml / featuresTextos. descriptionHtml é HTML limpo, sem links nem imagens.
activationSteps / activationDetails / systemRequirementsInstruções de resgate e requisitos.
languages / genres / developer / publisher / releaseDate / ageRatingDados do jogo.
coverImage / screenshots / videosImagens do nosso CDN (guarde-as em cache do seu lado) e vídeos do YouTube.
qtyUnidades em stock (limitado a 999).
urlPágina pública do produto no site.

Encomendas

POST /orders com externalId (a sua referência única) e items (productId, qty 1–9, maxUnitPrice). Para cada linha verificamos o preço em tempo real: se for superior a maxUnitPrice, toda a encomenda é rejeitada com PRICE_CHANGED e não é cobrado nada. Se for inferior, paga o preço mais baixo. Vende a fonte mais barata com stock, tal como no site.

Recomendado: envie storeUrl (o URL da sua loja onde o produto é vendido) no corpo de POST /orders, ou o cabeçalho X-Store-Url em qualquer chamada. É opcional; o plugin de WordPress envia automaticamente o URL do seu site.

Código promocional: adicione couponCode: MICROSOFT20 para pagar 20 % menos em produtos Microsoft (Windows, Office, Visio, Project, SQL Server) enquanto a promoção estiver ativa. Só se aplica a essas linhas; um código desconhecido ou uma promoção terminada devolve INVALID_COUPON e não é cobrado 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
}
  • Envie um cabeçalho Idempotency-Key (8–100 caracteres) e reutilize-o quando repetir o pedido: recebe a resposta original e nunca é cobrado duas vezes. externalId também é único por conta.
  • A encomenda é concluída no mesmo pedido (?wait=20 espera até 20 s): a resposta tem o estado completed e um array keys. Um pedido repetido devolve a encomenda sem as chaves e com keysOmitted: true: leia-as com GET /orders/{id}/keys.
  • Sem stock ou com saldo insuficiente: não é cobrado nada nem é usada nenhuma chave (OUT_OF_STOCK, INSUFFICIENT_BALANCE). maxUnitPrice é um teto para cada chave.
  • Se um pedido expirar por tempo, envie-o de novo com o mesmo externalId: recebe DUPLICATE_EXTERNAL_ID com o id da encomenda e pode ler as respetivas chaves.
EstadoSignificado
completedTodas as unidades entregues. As chaves vêm na resposta.
partially_refundedAlgumas chaves foram reembolsadas ao seu saldo após reclamações.
refundedTodas as chaves da encomenda foram reembolsadas ao seu saldo.

Entrega de chaves

GET /orders/{id}/keys devolve todas as unidades entregues: value contém o código, o URL de Steam Gift, as credenciais da conta ou o link de ativação, consoante deliveryType. contentType é text/plain ou um tipo de imagem (nesse caso value é base64).

Guarde as chaves cifradas e mostre-as apenas ao comprador. A primeira descarga de cada encomenda fica registada do nosso lado como prova de entrega.

Reclamações e reembolsos

Uma chave defeituosa pode ser reclamada durante 14 dias. Abra a encomenda em Painel → Encomendas (encomendas da API), escolha a chave, escreva ao vendedor e anexe capturas de ecrã do erro de ativação. O vendedor pode enviar uma chave de substituição (aparece na sua encomenda e recebe o webhook key.replaced) ou reembolsar a chave (o preço volta ao seu saldo da API uma única vez e recebe order.refunded). Se não concordar, escale o caso e a BuyCheapKeys decide.

Verifique a região, excludedCountries e o tipo de licença antes de vender e mostre-os ao seu cliente. Um reembolso ao seu saldo não reembolsa o seu próprio cliente: essa decisão é sua.

Cartões-presente BuyCheapKeys por grosso

Além dos cartões-presente de outras marcas (são produtos do catálogo, productType=gift-card), pode comprar os nossos próprios cartões-presente para revender: códigos BCK-XXXX-XXXX-XXXX-XXXX que adicionam o seu valor à Wallet BuyCheapKeys de quem os resgatar em buycheapkeys.com/wallet. GET /gift-cards devolve os valores à venda, os descontos por volume, os máximos por encomenda e o saldo da sua Wallet. POST /gift-cards/orders compra N cartões de um valor e devolve os códigos de imediato; GET /gift-cards/orders/{id} mostra-os de novo com o estado de cada código.

curl https://buycheapkeys.com/partner-api/v1/gift-cards \
  -H "Authorization: Bearer $BCK_API_KEY"
  • Pago apenas com a Wallet BuyCheapKeys da conta da sua loja (carregue-a em buycheapkeys.com/wallet), não com o saldo da API. Preço = valor facial menos o desconto por volume para essa quantidade.
  • Os valores, descontos e máximos podem mudar: envie maxTotal para recusar um total superior (PRICE_CHANGED, nada é cobrado). Idempotency-Key e o externalId único funcionam como nas encomendas.
  • Venda em pausa: PRODUCT_UNAVAILABLE (409). Valor não vendido ou quantidade fora do intervalo: VALIDATION_ERROR. Encomenda demasiado grande: ORDER_LIMIT_EXCEEDED. Saldo da Wallet insuficiente: INSUFFICIENT_BALANCE (402).
  • As chaves de sandbox devolvem códigos falsos BCK-TEST-… que não podem ser resgatados e não cobram nada.
  • Os códigos vendidos são definitivos. Cada código tem uma data de validade (expiresAt) e limites de resgate por conta. Um código que bloqueamos por fraude deixa de ser mostrado (code: null, estado blocked). Guarde os códigos cifrados.

Webhooks

Defina um URL https em Painel → Webhooks (ou PUT /webhook); recebe um segredo de assinatura (whsec_…). Cada evento é um POST com os cabeçalhos X-BCK-Event, X-BCK-Delivery (id único: elimine duplicados com base nele) e X-BCK-Signature: t=<unix>,v1=<hex>, em que v1 = HMAC-SHA256(secret, t + "." + rawBody).

EventoQuando
order.completedUma encomenda foi concluída.
order.refundedUma reclamação terminou com um reembolso ao seu saldo (`refundedSale`, `amount`).
products.updatedMudou o preço, o stock ou a disponibilidade de produtos: `data.products` contém até 100 produtos em formato summary por evento (`removed: true` quando retirados).
catalog.changedMais de 1000 produtos mudaram de uma só vez: execute a sincronização por cursor (`fields=summary`) em vez de ler o evento.
product.updatedApenas produtos Windows e Office tratados manualmente (plugin 1.0): `data.product` contém o produto completo.
key.replacedUm vendedor substituiu uma chave: `oldKeyId`, `newKeyId`; leia a nova chave com GET /orders/{id}/keys.
balance.creditedFoi adicionado um carregamento ao seu saldo.
webhook.testEnviado por POST /webhooks/test ou pelo botão do painel.
{
  "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}" }
}
  • Responda 2xx em 8 s e faça o trabalho de forma assíncrona. Os redirecionamentos não são seguidos.
  • As entregas falhadas são repetidas após 10 s, 30 s, 1 min, 5 min, 15 min, 30 min, 1 h, 2 h, 4 h, 6 h e 12 h (~26 h).
  • Os eventos podem chegar fora de ordem ou mais do que uma vez: em caso de dúvida, volte sempre a ler GET /orders/{id} ou o cursor.

Erros

Os erros usam códigos de estado HTTP e um code estável. Indique o requestId ao contactar o suporte.

{
  "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"
  }
}
codeHTTPSignificadoO que fazer
UNAUTHORIZED401Chave em falta, inválida, revogada ou expirada.Verifique a chave ou crie outra no painel.
ACCOUNT_NOT_ACTIVE403Conta de parceiro pendente, suspensa ou rejeitada.Contacte-nos.
IP_NOT_ALLOWED403O IP do pedido não consta da sua lista de IPs permitidos.Adicione o IP em Painel → Webhooks e segurança.
INSUFFICIENT_SCOPE403A chave não tem permissão para este endpoint.Crie uma chave com essa permissão.
NOT_FOUND404Produto, encomenda ou rota desconhecidos.—
VALIDATION_ERROR400Corpo ou parâmetros inválidos (details indica cada campo).Corrija o pedido; não o repita tal como está.
INSUFFICIENT_BALANCE402Saldo insuficiente. Não foi cobrado nada.Carregue o saldo e tente de novo.
PRICE_CHANGED409O preço real excede maxUnitPrice. Não foi cobrado nada.Atualize o preço (details.currentPrice) e tente de novo.
INVALID_COUPON400couponCode desconhecido ou promoção terminada. Não foi cobrado nada.Retire o código ou envie o que está em vigor (MICROSOFT20).
OUT_OF_STOCK409Não há unidades suficientes. Não foi cobrado nada.Tente mais tarde ou oculte o produto.
PRODUCT_UNAVAILABLE409Produto não vendável através da API.Retire-o da sua loja.
DUPLICATE_EXTERNAL_ID409externalId já utilizado; details.orderId é a encomenda existente.Consulte essa encomenda.
IDEMPOTENCY_CONFLICT409Idempotency-Key reutilizada com outro corpo.Use uma chave nova por encomenda.
IDEMPOTENCY_IN_PROGRESS409A mesma Idempotency-Key ainda está a ser processada.Tente de novo dentro de alguns segundos.
ORDER_LIMIT_EXCEEDED422Total acima do seu limite por encomenda.Divida a encomenda ou peça um limite superior.
DAILY_LIMIT_EXCEEDED422Limite de gastos de 24 h atingido.Aguarde ou peça um limite superior.
RATE_LIMITED429Demasiados pedidos.Espere (details.retryAfterMs).
SERVICE_UNAVAILABLE503Venda temporariamente indisponível. Não foi cobrado nada.Tente de novo com espera exponencial.
INTERNAL_ERROR500Erro inesperado (registado com requestId).Tente de novo com a mesma Idempotency-Key.

Limites

LimiteValor
Pedidos por chave20 / segundo e 600 / minuto
Encomendas por conta120 / minuto
Descargas de chaves por conta300 / minuto
Linhas por encomenda / unidades por linha10 / 9
Valor da encomenda e gasto em 24 horasPor conta (ver Painel → Visão geral); peça-nos para os aumentar
Tamanho da página100 produtos (fields=full), 500 (fields=summary), 100 encomendas
Filtro ids200 ids

Saldo, Wallet e carregamentos

As encomendas são cobradas ao seu saldo pré-pago da API e, se este não chegar, à Wallet da sua conta. GET /balance devolve o saldo do modo da chave; GET /me mostra também walletBalance e available. Carregue o saldo em Painel → Saldo (por exemplo 500 EUR, e depois cada encomenda é cobrada automaticamente): recebe uma referência única para a transferência bancária, ou pode pagar online; o valor é creditado quando chega (e-mail + webhook balance.credited). Todos os movimentos aparecem no registo.

Implementação com um assistente de IA

Documentação legível por máquinas: https://buycheapkeys.com/reseller-api.md (esta página em Markdown; /reseller-api.es.md em espanhol), a especificação OpenAPI 3.1 https://buycheapkeys.com/partner-api/v1/openapi.json e https://buycheapkeys.com/llms.txt. Dê estes URL ao seu assistente de IA juntamente com o prompt abaixo.

Integração de referência completa (Node.js 18+, sem dependências): https://buycheapkeys.com/developers/bck-partner-client.mjs: sincronização do catálogo com cursor, encomendas seguras com repetições e idempotência, descarga de chaves e um recetor de webhooks com verificação de assinatura.

curl -O https://buycheapkeys.com/developers/bck-partner-client.mjs
export BCK_API_KEY=bck_test_...   # chave de sandbox em Painel → Parceiro → Chaves de API
node bck-partner-client.mjs balance
node bck-partner-client.mjs sync
node bck-partner-client.mjs order <productId> 1 <maxUnitPrice>
  • Invariante 1: venda apenas produtos com inStock=true e removed=false; volte a sincronizar a cada 1–5 min a partir do nextCursor guardado.
  • Invariante 2: uma encomenda de cliente = um externalId = uma Idempotency-Key; reutilize ambos em cada repetição.
  • Invariante 3: envie sempre maxUnitPrice; os erros de negócio 4xx são definitivos e não foi cobrado nada.
  • Invariante 4: repita apenas erros de rede, 429, 5xx e IDEMPOTENCY_IN_PROGRESS, com espera exponencial.
  • Invariante 5: nunca volte a encomendar após um timeout: repita o mesmo externalId e leia as chaves da encomenda existente.
  • Invariante 6: mantenha a chave da API no servidor; verifique as assinaturas dos webhooks; mostre aos clientes o deliveryType, a região e os países excluídos.

Lista de verificação antes de entrar em produção

  • Mantenha as chaves da API apenas no seu servidor (nunca em navegadores nem em aplicações) e num gestor de segredos ou em variáveis de ambiente.
  • Use chaves separadas por sistema e as permissões mínimas; ative a lista de IPs permitidos.
  • Envie sempre maxUnitPrice e uma Idempotency-Key, e envie storeUrl (ou o cabeçalho X-Store-Url) com o URL da sua loja.
  • Verifique a assinatura e o carimbo temporal de cada webhook antes de confiar nele.
  • Teste o fluxo completo com uma chave bck_test_, depois passe a bck_live_ e carregue o seu saldo.
  • Rode as chaves e o segredo do webhook se suspeitar de uma fuga e, depois, revogue as antigas.