Arquitetura de referência: checkout cripto e pagamentos
Um marketplace cobra de compradores e paga vendedores. Este build usa as primitivas de pagamento para a metade de entrada e as de payout para a de saída, reconciliadas por webhooks assinados.
O desafio
Cobrar e desembolsar cripto normalmente significa um processador de um lado e ferramentas de custódia do outro. O objetivo é rodar as duas direções sobre um saldo com entrega de eventos consistente e verificável.
- Invoices / checkoutC2
- Mass payout / settlementC2
- Build / sign / broadcastC2
- Webhook (HMAC) deliveryC1
Cobrar com invoices
Crie uma invoice por pedido e apresente o checkout hospedado. Subpagamento, sobrepagamento e confirmações são rastreados por você.
Reconciliar com webhooks assinados
A liquidação dispara um webhook assinado por HMAC e idempotente. Verifique a assinatura e marque o pedido como pago; entregas duplicadas não creditam em dobro.
Desembolsar com pagamento em massa
Pague os vendedores em lote a partir do mesmo saldo, transmitindo transferências e rastreando cada uma até a confirmação.
O que a arquitetura entrega
- Cobrança de entrada e pagamentos de saída sobre um só saldo
- Webhooks idempotentes e assinados para que a reconciliação não conte em dobro
- Sem contratos separados de processador e custódia para manter
Perguntas frequentes
Como o crédito em dobro é evitado?
A entrega de webhook é idempotente e assinada; um evento de liquidação duplicado é reconhecido e ignorado.
Cobrança e payout podem compartilhar fundos?
Sim: ambos rodam contra um saldo, então os fundos cobrados podem liquidar pagamentos de saída.
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