Guia de Integração Rápida

Siga estes quatro passos para integrar perfeitamente o gateway de pagamento cripto BoltUtil à sua lógica de negócio existente.

1

Iniciação no Backend: Criar Pedido

Backend

Chame o endpoint /api/v1/orders/create. Nosso gateway mapeia seu endereço de destino pré-configurado para a transação específica.

Dica de Segurança: Certifique-se de que a X-Bolt-Key e a assinatura estejam incluídas no Header HTTP.
2

Orientação no Frontend: UI de Pagamento

Frontend

Use a checkoutUrl da resposta para redirecionar os usuários para nossa página de checkout minimalista ou renderize o código QR diretamente. Os usuários transferirão fundos de suas carteiras privadas diretamente para o seu endereço exclusivo.

Totalmente compatível com TRON (TRC20) e as principais carteiras com suporte nativo para invocação de aplicativos (App-invocation).
3

Envio do Sistema: Ouvir Callbacks

Webhook

Nossos clusters de nós monitoram o livro-razão (ledger) da blockchain em tempo real. Assim que uma confirmação de transação é detectada, o sistema envia imediatamente uma requisição POST para sua notifyUrl com os detalhes completos do pagamento, incluindo o txHash.

Para lidar com oscilações de rede, certifique-se de que seu endpoint implemente idempotência para processar notificações duplicadas com segurança.
4

Entrega do Negócio: Verificar e Finalizar

Backend

Ao receber o Webhook, verifique a origem dos dados usando nosso algoritmo de assinatura. Assim que o valor do callback for correspondido com o pedido, atualize o status do sistema e conclua a entrega ao usuário.

Zero Trust: Nunca finalize um pedido sem a verificação bem-sucedida da assinatura HMAC e a conferência do valor.