Referência da API REST
Integre sua loja ou aplicação diretamente aos servidores da Cubyc. Emita chaves Steam sob demanda com débito apenas após a ativação, consulte o catálogo em tempo real e sincronize pedidos automaticamente.
https://cubyc.com.br/api/v1Autenticação & cabeçalhos HTTP
Padronização de segurança em todas as rotas privadas
Todas as requisições autenticadas exigem o envio da sua chave secreta da API no cabeçalho Authorization utilizando o esquema Bearer. As chaves sempre iniciam com o prefixo cy_live_.
Authorization: Bearer cy_live_SEU_TOKEN Content-Type: application/json
1. Emissão de Chaves Steam sob Demanda
Emite chaves Steam de forma instantânea para entrega imediata ao cliente final. O modelo é 100% pós-pago: o débito no saldo do revendedor ocorre somente quando o jogador ativar a chave na Steam.
O lote é dividido igualmente entre os jogos informados, exceto quando 'isCombo' for true (gerando chaves que ativam todos os jogos da lista).
curl -X POST https://cubyc.com.br/api/v1/generate \
-H "Authorization: Bearer cy_live_SEU_TOKEN_AQUI" \
-H "Content-Type: application/json" \
-d '{
"games": ["730"],
"quantity": 1,
"isCombo": false
}'{
"success": true,
"message": "Chaves geradas com sucesso",
"batchId": "batch_981a2e7c4f",
"keys": {
"730": [
"CY-730-8K2A-9M4L-1P0X"
]
},
"totalGenerated": 1,
"isCombo": false
}2. Pesquisa no Catálogo Steam
Pesquisa jogos disponíveis no catálogo da Cubyc por termo de busca (nome ou AppID), com filtros opcionais para proteção DRM Denuvo, conteúdo adulto (NSFW) e paginação.
curl -X GET "https://cubyc.com.br/api/v1/games/search?q=Cyberpunk&limit=1" \ -H "Authorization: Bearer cy_live_SEU_TOKEN_AQUI"
{
"success": true,
"query": "Cyberpunk",
"total": 1,
"limit": 1,
"results": [
{
"id": "1091500",
"name": "Cyberpunk 2077",
"banner": "https://cdn.cloudflare.steamstatic.com/steam/apps/1091500/header.jpg",
"hasDenuvo": false,
"nsfw": false,
"type": "game",
"tags": ["RPG", "Open World", "Sci-Fi"]
}
]
}3. Catálogo Completo & Metadados
Retorna o total consolidado de jogos da plataforma, contagem de títulos disponíveis e metadados globais.
curl -X GET https://cubyc.com.br/api/v1/catalog \ -H "Authorization: Bearer cy_live_SEU_TOKEN_AQUI"
{
"success": true,
"totalGames": 4200,
"updatedAt": "2026-09-20T16:00:00.000Z",
"status": "ready"
}4. Status do Ciclo de Vida da Chave
Consulta o status atual de uma chave emitida pela Cubyc (Pendente, Ativada ou Revogada), com timestamp de ativação e dados de auditoria.
curl -X GET https://cubyc.com.br/api/v1/keys/CY-730-8K2A-9M4L-1P0X \ -H "Authorization: Bearer cy_live_SEU_TOKEN_AQUI"
{
"success": true,
"key": {
"code": "CY-730-8K2A-9M4L-1P0X",
"gameName": "Counter-Strike 2",
"appid": "730",
"status": "Ativada",
"createdAt": "2026-08-20T10:00:00.000Z",
"activatedAt": "2026-08-21T14:32:10.000Z"
}
}5. Consulta de Saldo & Custos de Ativação
Obtém o saldo atual da carteira Cubyc em Reais (BRL), o custo unitário cobrado por ativação de chave de acordo com o plano do revendedor e o nível de suporte.
curl -X GET https://cubyc.com.br/api/v1/balance \ -H "Authorization: Bearer cy_live_SEU_TOKEN_AQUI"
{
"success": true,
"balance": 250.00,
"currency": "BRL",
"plan": {
"name": "Pro Revendedor",
"keyPrice": 0.50,
"supportLevel": "Prioritário"
}
}6. Dados da Conta & Limites Operacionais
Retorna as informações cadastrais da loja, limites máximos de chaves por lote, data de expiração do plano e permissões ativas.
curl -X GET https://cubyc.com.br/api/v1/account \ -H "Authorization: Bearer cy_live_SEU_TOKEN_AQUI"
{
"success": true,
"reseller": {
"storeName": "Atlas Keys",
"plan": "PRO",
"batchLimit": 50,
"expiration": "2026-10-15T00:00:00.000Z",
"canGenKeys": true,
"activeIntegrations": ["CENTRALCART", "SHARPIFY"]
}
}7. Sincronização & Mapeamento de Produto
Vincula um ID de produto externo do seu e-commerce (CentralCart, Sharpify, Nerix, BetterSell) diretamente ao AppID Steam na Cubyc, permitindo entrega automatizada sem intervenção humana.
curl -X POST https://cubyc.com.br/api/v1/sync/centralcart/98765/730 \ -H "Authorization: Bearer cy_live_SEU_TOKEN_AQUI"
{
"success": true,
"message": "Produto sincronizado com sucesso",
"mapping": {
"platform": "CENTRALCART",
"externalProductId": "98765",
"internalAppId": "730",
"gameName": "Counter-Strike 2",
"active": true
}
}8. Telemetria Oficial de Ativação Steam
Consulta dados forenses e de telemetria sobre a ativação da chave na Steam, retornando o SteamID64 do jogador que ativou a chave e o timestamp exato registrado.
curl -X POST https://cubyc.com.br/api/activations/info \
-H "Authorization: Bearer cy_live_SEU_TOKEN_AQUI" \
-H "Content-Type: application/json" \
-d '{"keyValue": "CY-730-8K2A-9M4L-1P0X"}'{
"success": true,
"activation": {
"steamId": "76561198123456789",
"appid": "730",
"gameName": "Counter-Strike 2",
"activatedAt": "2026-08-21T14:32:10.000Z",
"status": "Ativada"
}
}9. Webhook Receptor de Vendas do E-commerce
Endpoint onde as plataformas parceiras (CentralCart, Sharpify, Nerix e BetterSell) enviam notificações em tempo real quando um pagamento de pedido é aprovado.
Este endpoint é chamado pelas plataformas, não por você. Ele exige a autenticação da plataforma: assinatura HMAC da CentralCart e da BetterSell, ou o segredo configurado na URL das demais. Veja o detalhamento em /docs/integracoes.
curl -X POST https://cubyc.com.br/api/webhooks/store/res_92049/centralcart \
-H "Content-Type: application/json" \
-d '{
"event": "ORDER_APPROVED",
"orderId": "CC-10948",
"customer": {
"name": "Gabriel Souza",
"email": "cliente@email.com"
},
"total": 39.90,
"products": [
{ "externalId": "98765", "quantity": 1 }
]
}'{
"success": true,
"message": "Webhook processado e chaves entregues ao cliente."
}Tabela de códigos HTTP & rate limits
Guia de diagnóstico e limites de tráfego
Além disso, a geração de chaves tem um intervalo mínimo de 2 segundos entre lotes do mesmo revendedor, para evitar emissão duplicada por duplo clique ou reenvio de fila.