Aceitar um pagamento cripto com uma invoice
Cobrar em cripto se resume a três movimentos: crie uma invoice por um valor, direcione o pagador a um checkout e reaja a um webhook de liquidação. O processamento, a gestão de endereços e o acompanhamento de confirmações são feitos por você.
- Uma chave de API ao vivo
- Um endpoint de webhook configurado e um segredo de assinatura
1Crie uma invoice
Peça uma invoice por um valor denominado em fiat e as cadeias que você aceita. Você recebe um endereço de cobrança e uma URL de checkout.
curl https://api.1st-node.com/v1/payments/invoices \
-H "Authorization: Bearer sk_live_..." \
-d '{"amount_usd":49,"accept":["eth","tron"]}'2Apresente o checkout
Redirecione o pagador para a URL de checkout retornada, ou renderize o endereço e o valor você mesmo. A invoice rastreia subpagamento, sobrepagamento e confirmações.
3Confirme via webhook
Na liquidação, um webhook assinado (HMAC-SHA256) dispara com o id da invoice e o status. Verifique a assinatura e então marque o pedido como pago. A entrega do webhook é idempotente —eventos duplicados não creditam em dobro.
> POST /your/webhook X-Signature: <hmac>
> { "invoice":"in_..","status":"settled","amount_usd":49 }Perguntas frequentes
Como confio no webhook?
Cada evento é assinado com HMAC-SHA256 sobre o corpo bruto. Recalcule com seu segredo e rejeite divergências.
Posso pagar além de cobrar?
Sim —pagamento em massa e liquidação são primitivas de pagamento irmãs sobre o mesmo saldo.
Continue lendo
Recarregue, pegue a chave e publique.
Autoatendimento. Pague em cripto ou cartão. Medido por créditos: primitivas pesadas custam mais, as simples são baratas.
Obter chave de API