API para Revendedores

Integre seu painel, site ou bot ao catálogo do BoostGG. Você trabalha com saldo pré-pago e preço de revenda; o cliente final é seu.

Como começar

  1. Fale com o suporte no WhatsApp e peça acesso de revendedor.
  2. Você recebe uma chave de API (mostrada uma única vez) e um desconto contratado.
  3. Deposita saldo via Pix. Cada pedido debita do saldo automaticamente.

Endpoint

POST https://www.boostgg.com.br/api/public/reseller/v1
Content-Type: application/json

Todos os parâmetros vão no corpo (JSON ou form). A chave pode ir em key ou no header X-Api-Key.

1. Listar serviços

{ "key": "SUA_CHAVE", "action": "services" }

// resposta
{ "ok": true, "services": [
  { "service": "p1k", "name": "1.000 instagram seguidores",
    "quantity": 1000, "package_price": 25.90, "retail_price": 28.90,
    "refill": true, "currency": "BRL" }
] }

2. Consultar saldo

{ "key": "SUA_CHAVE", "action": "balance" }
// { "ok": true, "balance": "150.00", "currency": "BRL" }

3. Criar pedido

{ "key": "SUA_CHAVE", "action": "add",
  "service": "p1k", "link": "usuario_do_instagram" }

// { "ok": true, "order": "uuid-do-pedido",
//   "charge": "25.90", "balance": "124.10" }

Sem saldo suficiente a resposta é 402 e nada é cobrado. Pacote pausado retorna 409 com o motivo.

4. Status do pedido

{ "key": "SUA_CHAVE", "action": "status", "order": "uuid-do-pedido" }

// { "ok": true, "status": "Completed", "remains": 0, "charge": "25.90" }

Status possíveis: Pending, In progress, Completed, Canceled, Refunded.

Regras

  • Limite de 120 chamadas por minuto por chave.
  • Pacotes com quantidade fixa: o campo quantity já vem definido por serviço.
  • Reposição conforme o pacote (BR 30 dias, Premium BR 90 dias) — o campo refill indica.
  • Pedido que não despacha na hora fica em fila e é reconciliado automaticamente.

Voltar para a loja

Antes de integrar

A API foi feita para quem lança pedidos em volume e não quer usar o painel manualmente. Você precisa de uma chave ativa, saldo disponível e o identificador do serviço que vai consumir. O identificador é estável: mudanças de fornecedor acontecem por trás sem quebrar sua integração.

Recomendamos guardar o identificador do pedido retornado na criação. É com ele que você consulta status e comprova entrega ao seu cliente.

  • Sempre trate a resposta de erro: saldo insuficiente e link inválido são os casos mais comuns.
  • Use uma chave por ambiente para conseguir revogar sem parar a operação inteira.
  • Consulte status por polling espaçado em vez de checar a cada segundo.

Idempotência e pedidos duplicados

Timeout de rede não significa pedido perdido. Antes de reenviar a mesma requisição, consulte o pedido pelo seu identificador interno — o sistema bloqueia despacho duplicado, mas repetir chamadas sem checar polui seu histórico e dificulta a conciliação.

O que acontece quando algo falha

Pedido que não despacha na hora não é perdido: ele fica em fila e é reconciliado automaticamente em poucos minutos. Se mesmo assim não houver saída, o valor volta para o seu saldo e o status reflete isso. Nada fica em limbo silencioso.