Fluxo de venda
Do catálogo à entrega da key e ao suporte — a integração de ponta a ponta.
Este é o caminho que uma loja ou um bot faz para vender e entregar keys sem ninguém abrir o painel.
Monte a vitrine
Busque os produtos com Listar produtos e guarde a lista por alguns minutos. Mostre só os que têm available: true, com as durações de plans.
Registre a venda com um código
Quando o cliente pagar, crie uma Idempotency-Key (um UUID) e guarde junto do pedido, antes de chamar a API. Esse código é o que garante que a venda não seja cobrada duas vezes.
Gere a key
Chame Gerar keys com o product_id, a quantity e os days escolhidos.
- Deu certo: guarde
generation_id, e de cada key ouser_ide okey_code. - Erro de rede, timeout ou
500: repita com a mesmaIdempotency-Key. Se a primeira tinha dado certo, você recebe as mesmas keys sem nova cobrança. 402: falta saldo. Nada foi cobrado; avise que a entrega vai atrasar e compre créditos.422: o produto ficou indisponível ou a duração não existe. Não repita: confira a vitrine.
Entregue ao cliente
Mande o key_code ao cliente. A key fica com status: DISPONIVEL até ele ativar.
Atenda o suporte
- "Troquei de PC": chame Resetar HWID com o
user_idda key. - "Minha key não funciona": consulte a key com Listar suas keys e
user_ids[]— vejastatus,hwid_statuseseconds_remaining.
Confira as contas
No extrato, cada geração aparece com type: key_generation e reference_id igual ao generation_id. É assim que cada saída de créditos se liga à venda que a causou.
Receba avisos em vez de perguntar
Com os webhooks, o seu sistema recebe um aviso a cada key gerada, HWID resetado ou mudança de saldo — inclusive as feitas pelo painel.