API Pública v1 & Webhooks

Documentação da API.

Rotas públicas oficiais para conectar seu site, checkout próprio, bot do Discord ou automação diretamente à Cubyc usando sua Chave de API ou Token OAuth2.

1. Visão Geral & Modelo Pós-Pago

Base URL pública, funcionamento das chaves e idempotência segura.

Base URLhttps://cubyc.com.br/api/v1Respostas JSON UTF-8 com CORS liberado.
Cobrança na AtivaçãoGerar é gratuitoO custo da chave só sai da carteira quando o comprador ativa.
IdempotênciaIdempotency-KeyEnvie um ID único por pedido para evitar duplicar geração.

2. Autenticação Bearer & Escopos

Mande sua chave ou token OAuth no cabeçalho Authorization de todas as rotas protegidas.

Authorization: Bearer cb_live_seu_token_aqui
Tipo de TokenPrefixoEscopos & Permissões
Chave de APIcb_live_…Criada no painel em Conexões › Chaves de API. Libera acesso completo às rotas v1 da conta.
Token OAuth2cba_…Para apps autorizados pelo usuário. Respeita os escopos concedidos: perfil, chaves, email, lojas.

3. Consultar Conta & Carteira

Retorna o plano ativo, custo por ativação e saldo disponível/reservado.

GET/api/v1/account

Caso precise consultar apenas os valores financeiros, use GET /api/v1/balance (escopo chaves).

curl -X GET "https://cubyc.com.br/api/v1/account" \
  -H "Authorization: Bearer cb_live_SUA_CHAVE"
{
  "account": {
    "id": "b7f2c1a0-...",
    "name": "Sua Loja",
    "plan": "pro",
    "balance": 145.50,
    "reservedBalance": 3.00,
    "activationPrice": 1.50,
    "status": "Ativo",
    "canGenKeys": true
  }
}

5. Gerar & Consultar Chaves

Emita de 1 a 100 chaves por chamada e consulte ativações em tempo real.

POST/api/v1/keys/generate
curl -X POST "https://cubyc.com.br/api/v1/keys/generate" \
  -H "Authorization: Bearer cb_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-loja-9841" \
  -d '{"appid": 1245620, "quantity": 5, "key_length": 20, "expiration": {"type": "none"}}'
GET/api/v1/keys/status

Passe ?key=XXXXX-… ou envie POST com { "keys": ["...", "..."] } (até 20). Também disponível via GET /api/v1/keys/{code}.

POST/api/v1/generate

Geração em combo ou por nome do jogo: { "games": ["Elden Ring", "1091500"], "quantity": 1, "isCombo": true }.

6. Webhooks de Entrada (Lojas)

URL gerada para cada conexão em Conexões › Plataformas para sincronizar vendas em tempo real.

POST/api/webhooks/loja/{id}
POST https://cubyc.com.br/api/webhooks/loja/{integrationId}?t={token_secreto}

Compatível com os eventos nativos da CentralCart, BukioPay, Nerix, Sharpify e Ereemby (incluindo validação opcional de assinatura HMAC configurável no modal da conexão).

7. Códigos de Resposta & Rate Limits

Falhas seguem o padrão { error: { code, message } }.

StatusCódigoMotivo
400invalid_requestParâmetro ausente ou fora do limite permitido.
401unauthorizedToken Bearer inválido, expirado ou revogado.
403forbiddenEscopo OAuth insuficiente ou plano sem API pública habilitada.
404game_not_found / not_foundAppID não encontrado no catálogo ou chave inexistente na conta.
429rate_limitedLimite de requisições atingido (120/min gerais · 30 gerações/min).