Conciliação Pix relaciona o que sua empresa cobrou ou pagou ao que efetivamente aconteceu. Na Hodle, use referências de operação, webhooks assinados e extrato por API para acompanhar recebimentos, payouts e entrega de ativos.
Pix
USDC
USDTUm identificador interno do pedido ajuda a relacionar a venda ao depósito. No fluxo de depósito, o campo externalId permite fornecer essa referência conforme as regras da API. O identificador devolvido pela Hodle acompanha a operação até seu desfecho.
O endToEndId identifica uma transação Pix e o txHash identifica uma transação on-chain, quando disponíveis. Eles representam etapas diferentes: não substitua um pelo outro nem conclua que a conversão terminou apenas porque o Pix foi iniciado.
A Hodle assina as entregas de webhook com HMAC-SHA256. A integração verifica X-Hodle-Signature e X-Hodle-Timestamp sobre o corpo original da requisição antes de confiar no evento. O segredo do webhook deve permanecer no backend.
Processe os eventos de forma que uma nova entrega do mesmo resultado não cause uma segunda baixa. Para dúvidas de estado, consulte a operação e reconcilie com o extrato.
O extrato da Hodle reúne operações por período, com paginação e filtros por tipo. Use-o para conferir o fechamento e localizar pagamentos cujo evento ainda não foi processado no seu sistema.
Compare valor, ativo, rede, direção, status e taxa antes de somar. A API de depósito recebe reais em centavos; os campos do extrato seguem as unidades descritas na referência. Misturar centavos com reais ou USDC com BRL produz um saldo incorreto.
Separe o pedido comercial do estado financeiro. Um pedido pode aguardar pagamento, enquanto uma operação já paga ainda aguarda a entrega do ativo; a experiência do cliente deve deixar essa diferença clara.
A Hodle fornece os dados e eventos documentados para montar essa rotina no seu ERP ou backend. Isso não significa que exista um conector pronto para todo sistema.
A cobertura de eventos varia por recurso. Verifique a referência técnica do fluxo e use a consulta de status quando necessário, em vez de presumir que toda etapa da operação dispara um webhook.
Respostas para avaliar a solução e preparar sua operação.
É a conferência entre cobranças, pagamentos e seus resultados financeiros. Ela relaciona o pedido ao valor recebido ou enviado e considera taxas, estados finais, devoluções e diferenças.
Use o status da operação e os eventos previstos pelo fluxo integrado. Valide a assinatura do webhook e confira o resultado final. Um QR Code gerado ou um comprovante enviado pelo cliente não substituem essa confirmação.
O endToEndId identifica a transferência Pix. O txHash identifica a transação em blockchain. Em um fluxo com conversão, guarde ambos quando retornados para acompanhar as etapas correspondentes.
A API e os webhooks permitem desenvolver essa integração. A disponibilidade de um conector específico deve ser confirmada com o time; não presuma compatibilidade automática.
