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
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-…" } ] }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
RockstarChave

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

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

EA Sports FC 24
EA AppChave

Minecraft Legends Deluxe Edition (Xbox Account)
XboxConta

Baldur's Gate 3 (Steam Account)
SteamConta

Forza Horizon 4 Ultimate Edition (Xbox Account)
XboxConta

Call of Duty: Vanguard
XboxChave

Hogwarts Legacy
XboxChave

Hogwarts Legacy Digital Deluxe Edition (PS5 Account)
PlayStationConta

Stardew Valley (Steam Gift) (Steam) - Chave Digital Global
SteamLink de oferta

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

Microsoft Windows 11 Pro (PC) - Microsoft Key - GLOBAL (Microsoft) - Chave Digital Global
MicrosoftChave

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

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

Microsoft Windows 10 / 11 Pro - 1 PC - OEM
MicrosoftChave
Como funciona
- 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.
- 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.
- 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.
- 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
- 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.
- 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.
- 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.
Perguntas frequentes
Qual é a melhor API para revender chaves de jogos?
Quanto custa a API para revendedores da BuyCheapKeys?
Como vendo chaves de jogos na minha loja WooCommerce?
Posso usá-la com Shopify, Magento, Shopware, PrestaShop ou com a minha própria loja?
Que produtos posso vender?
Como são entregues as chaves?
Como pago as encomendas?
Em que línguas estão as fichas de produto?
Como mantenho preços e stock sincronizados?
Posso testar a API sem pagar?
O que acontece se uma chave não funcionar?
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
- Visão geral
- Autenticação e ambientes
- Início rápido
- Catálogo e sincronização
- Filtros, ordenação e idiomas
- Campos do produto
- Encomendas
- Entrega de chaves
- Reclamações e reembolsos
- Cartões-presente BuyCheapKeys por grosso
- Webhooks
- Erros
- Limites
- Saldo, Wallet e carregamentos
- Implementação com um assistente de IA
- Lista de verificação antes de entrar em produção
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.
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 /medevolvediscountPercenteserviceFee: 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 chave | Modo | Comportamento |
|---|---|---|
| bck_test_ | Sandbox | Catá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ção | Compras reais cobradas ao seu saldo real (e à Wallet). |
| Permissão (scope) | Permite |
|---|---|
| catalog:read | GET /products, /products/{id}, /meta, /me, /ping, /gift-cards |
| webhooks:write | PUT, GET e DELETE /webhook (registar ou remover o URL do seu 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 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=summarya partir donextCursorguardado, sempre comincludeRemoved=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: 0em menos de um minuto; um produto oculto ou eliminado temremoved: 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âmetro | Valores / significado |
|---|---|
| platform | Steam, Xbox, PlayStation, Epic Games, GOG, Ubisoft Connect, EA App, Nintendo, Microsoft, … (ver /meta) |
| region | Etiqueta de região (Global, Europe, …); ver /meta |
| productType | game, dlc, software, gift-card, gift, subscription, game-point |
| deliveryType | key, gift (link de Steam Gift), account, link (link de ativação) |
| category | game, dlc, software, microsoft, gift-card, gift, subscription |
| genre | Nome do género (ver /meta) |
| minPrice / maxPrice | EUR, preço da API |
| inStock | true para listar apenas o que pode ser vendido agora |
| search | Todas as palavras, comparadas com o nome e o título traduzido |
| ids | Até 200 ids de produto |
| updatedSince / includeRemoved | Alterações desde uma data; incluir produtos retirados |
| sort | updated, popularity, name, price_asc, price_desc, newest (com páginas; o cursor de sincronização segue sempre updatedAt) |
| fields / limit / cursor / page | full 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
}| Campo | Significado |
|---|---|
| price | O seu preço unitário em EUR: preço do site menos 2 %. Reverificado em tempo real quando encomenda. |
| shopPrice / discountPercent | Preço do site e o seu desconto (2). |
| rrp | Preço de retalho real quando é superior ao preço da API; caso contrário, null. |
| deliveryType | key = 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 / activation | Etiqueta de região e a lista ISO exata de países onde NÃO pode ser ativado. |
| productType / category / edition / licenseType | Classificação do produto. |
| language | Idioma dos textos desta resposta. |
| shortDescription / description / descriptionHtml / features | Textos. descriptionHtml é HTML limpo, sem links nem imagens. |
| activationSteps / activationDetails / systemRequirements | Instruções de resgate e requisitos. |
| languages / genres / developer / publisher / releaseDate / ageRating | Dados do jogo. |
| coverImage / screenshots / videos | Imagens do nosso CDN (guarde-as em cache do seu lado) e vídeos do YouTube. |
| qty | Unidades em stock (limitado a 999). |
| url | Pá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.externalIdtambém é único por conta. - A encomenda é concluída no mesmo pedido (
?wait=20espera até 20 s): a resposta tem o estadocompletede um arraykeys. Um pedido repetido devolve a encomenda sem as chaves e comkeysOmitted: 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_IDcom o id da encomenda e pode ler as respetivas chaves.
| Estado | Significado |
|---|---|
| completed | Todas as unidades entregues. As chaves vêm na resposta. |
| partially_refunded | Algumas chaves foram reembolsadas ao seu saldo após reclamações. |
| refunded | Todas 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
maxTotalpara recusar um total superior (PRICE_CHANGED, nada é cobrado).Idempotency-Keye oexternalIdú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, estadoblocked). 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).
| Evento | Quando |
|---|---|
| order.completed | Uma encomenda foi concluída. |
| order.refunded | Uma reclamação terminou com um reembolso ao seu saldo (`refundedSale`, `amount`). |
| products.updated | Mudou 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.changed | Mais de 1000 produtos mudaram de uma só vez: execute a sincronização por cursor (`fields=summary`) em vez de ler o evento. |
| product.updated | Apenas produtos Windows e Office tratados manualmente (plugin 1.0): `data.product` contém o produto completo. |
| key.replaced | Um vendedor substituiu uma chave: `oldKeyId`, `newKeyId`; leia a nova chave com GET /orders/{id}/keys. |
| balance.credited | Foi adicionado um carregamento ao seu saldo. |
| webhook.test | Enviado 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"
}
}| code | HTTP | Significado | O que fazer |
|---|---|---|---|
| UNAUTHORIZED | 401 | Chave em falta, inválida, revogada ou expirada. | Verifique a chave ou crie outra no painel. |
| ACCOUNT_NOT_ACTIVE | 403 | Conta de parceiro pendente, suspensa ou rejeitada. | Contacte-nos. |
| IP_NOT_ALLOWED | 403 | O IP do pedido não consta da sua lista de IPs permitidos. | Adicione o IP em Painel → Webhooks e segurança. |
| INSUFFICIENT_SCOPE | 403 | A chave não tem permissão para este endpoint. | Crie uma chave com essa permissão. |
| NOT_FOUND | 404 | Produto, encomenda ou rota desconhecidos. | — |
| VALIDATION_ERROR | 400 | Corpo ou parâmetros inválidos (details indica cada campo). | Corrija o pedido; não o repita tal como está. |
| INSUFFICIENT_BALANCE | 402 | Saldo insuficiente. Não foi cobrado nada. | Carregue o saldo e tente de novo. |
| PRICE_CHANGED | 409 | O preço real excede maxUnitPrice. Não foi cobrado nada. | Atualize o preço (details.currentPrice) e tente de novo. |
| INVALID_COUPON | 400 | couponCode desconhecido ou promoção terminada. Não foi cobrado nada. | Retire o código ou envie o que está em vigor (MICROSOFT20). |
| OUT_OF_STOCK | 409 | Não há unidades suficientes. Não foi cobrado nada. | Tente mais tarde ou oculte o produto. |
| PRODUCT_UNAVAILABLE | 409 | Produto não vendável através da API. | Retire-o da sua loja. |
| DUPLICATE_EXTERNAL_ID | 409 | externalId já utilizado; details.orderId é a encomenda existente. | Consulte essa encomenda. |
| IDEMPOTENCY_CONFLICT | 409 | Idempotency-Key reutilizada com outro corpo. | Use uma chave nova por encomenda. |
| IDEMPOTENCY_IN_PROGRESS | 409 | A mesma Idempotency-Key ainda está a ser processada. | Tente de novo dentro de alguns segundos. |
| ORDER_LIMIT_EXCEEDED | 422 | Total acima do seu limite por encomenda. | Divida a encomenda ou peça um limite superior. |
| DAILY_LIMIT_EXCEEDED | 422 | Limite de gastos de 24 h atingido. | Aguarde ou peça um limite superior. |
| RATE_LIMITED | 429 | Demasiados pedidos. | Espere (details.retryAfterMs). |
| SERVICE_UNAVAILABLE | 503 | Venda temporariamente indisponível. Não foi cobrado nada. | Tente de novo com espera exponencial. |
| INTERNAL_ERROR | 500 | Erro inesperado (registado com requestId). | Tente de novo com a mesma Idempotency-Key. |
Limites
| Limite | Valor |
|---|---|
| Pedidos por chave | 20 / segundo e 600 / minuto |
| Encomendas por conta | 120 / minuto |
| Descargas de chaves por conta | 300 / minuto |
| Linhas por encomenda / unidades por linha | 10 / 9 |
| Valor da encomenda e gasto em 24 horas | Por conta (ver Painel → Visão geral); peça-nos para os aumentar |
| Tamanho da página | 100 produtos (fields=full), 500 (fields=summary), 100 encomendas |
| Filtro ids | 200 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.
