Guide d'intégration rapide

Suivez ces quatre étapes pour intégrer de manière fluide la passerelle de paiement crypto BoltUtil à votre logique métier existante.

1

Initiation Backend : Créer une commande

Backend

Appelez le point de terminaison /api/v1/orders/create. Notre passerelle associe votre adresse de réception préconfigurée à cette transaction spécifique.

Conseil de sécurité : Assurez-vous que la clé X-Bolt-Key et la signature sont incluses dans l'en-tête HTTP.
2

Guidage Frontend : Interface de paiement

Frontend

Utilisez l'URL checkoutUrl de la réponse pour rediriger les utilisateurs vers notre page de paiement minimaliste, ou générez le code QR directement. Les utilisateurs transfèrent les fonds de leur portefeuille privé directement vers votre adresse exclusive.

Entièrement compatible avec TRON (TRC20) et les portefeuilles grand public avec support natif de l'invocation d'application (App-invocation).
3

Notification Système : Écouter les Callbacks

Webhook

Nos clusters de nœuds surveillent le registre de la blockchain en temps réel. Dès qu'une confirmation de transaction est détectée, le système envoie immédiatement une requête POST à votre notifyUrl avec les détails complets du paiement, incluant le txHash.

Pour gérer les fluctuations du réseau, assurez-vous que votre point de terminaison implémente l'idempotence afin de traiter en toute sécurité d'éventuelles notifications en double.
4

Livraison Métier : Vérifier et Exécuter

Backend

À la réception du Webhook, vérifiez la source des données via notre algorithme de signature. Une fois que le montant du callback correspond à la commande, mettez à jour le statut système et finalisez la livraison au client.

Zéro Confiance (Zero Trust) : Ne livrez jamais une commande sans une vérification réussie de la signature HMAC et la correspondance du montant.