O x402 cobra cada chamada de uma API com uma prova de pagamento. Antes de integrar, a pergunta é se o seu produto precisa disso. Este tutorial ajuda a decidir.
Passo 1: meça o uso
Veja quantas vezes um cliente usa o produto por dia e por mês. Separe os clientes que usam muito dos que usam pouco. O x402 faz sentido para uso alto e frequente.
Passo 2: calcule o valor de uma chamada
Divida o preço mensal pelo número de chamadas. Se o valor de uma chamada for menor que um centavo, o pagamento por chamada pode ser caro demais para o cliente, mesmo com moeda digital.
Passo 3: confira o cliente
Pergunte se o cliente tem carteira de cripto e aceita pagar por ela. Para um público geral, a resposta costuma ser não. Para um público técnico, a resposta pode mudar.
Passo 4: defina a regra de reembolso
O pagamento por chamada é irreversível na maior parte dos casos. Decida antes o que acontece se a chamada falhar. Escreva essa regra na documentação da API.
Passo 5: escolha a alternativa
Se o uso é baixo, a assinatura ou o pacote de chamadas costuma ser mais simples. Se o uso é alto e o cliente é técnico, o x402 pode ser uma opção. Escolha uma alternativa e registre o motivo.
Passo 6: teste num ambiente de teste
Antes de qualquer produção, teste o fluxo numa rede de testes e sem chave real. Confira que a API responde 402 sem pagamento e que entrega o dado com a prova certa.
Passo 7: converse com a contabilidade
O pagamento sai de uma carteira digital, não de um cartão. A conciliação e a nota fiscal precisam de um processo novo. Leve isso ao seu contador antes de começar.
Como a Wortic faz
A Wortic não aceita x402. As APIs usam limite de pedidos por IP.
A documentação oficial está em x402.org, e o código, em GitHub.
Passo 8: confira se o aluno é o público certo
Pergunte quem usa o produto. Se a maioria é técnica e tem carteira de cripto, a cobrança por chamada pode funcionar. Se a maioria é de iniciantes, a cobrança por chamada costuma travar a adoção.
Passo 9: prepare o texto de reembolso
Como a cobrança por chamada costuma ser irreversível, escreva a regra de devolução antes de cobrar. Diga o que acontece se uma chamada falhar, se o servidor devolver erro ou se o dado vier incompleto.
Passo 10: escolha a moeda e a conciliação
Defina em qual moeda o valor será contabilizado e como o câmbio do dia será registrado. Essa decisão afeta o preço que o cliente vê. Um preço em moeda digital que muda com o câmbio exige uma regra clara de atualização.
