Guide d’intégration rapide

Connectez les paiements stablecoins (USDT / USDC) en quatre étapes. Configurez d'abord une clé API, un secret Webhook et des portefeuilles de réception pour les réseaux activés. L'exemple de droite vérifie votre clé API.

1

Créer un ordre de paiement

Votre backend

Appelez /api/v1/order/create depuis votre backend avec le prix, la devise, le réseau et la commande marchand ID. La réponse contient votre portefeuille configuré et le montant final à payer ; plusieurs commandes peuvent partager le même portefeuille.

GET /api/v1/ping vérifie votre clé API. La création d'une commande nécessite également un timestamp et une demande de signature.
2

Afficher les détails du paiement

Votre interface

Ouvrez checkoutUrl de la réponse ou affichez le montant, l’adresse, le réseau et la devise depuis l’objet payment. Les fonds arrivent directement dans le portefeuille configuré.

Utilisez le payment.amount complet. payment.qrData contient QR data, pas une image.
3

Attendez la confirmation du paiement

BoltUtil

BoltUtil fait correspondre les transferts par réseau, devise, portefeuille et montant, puis envoie une notification au notifyUrl associé lorsque les exigences de confirmation sont remplies. Les exceptions de paiement éligibles nécessitent un examen par le commerçant.

La confirmation et la livraison dépendent des conditions de la blockchain et du réseau. Une redirection de page ne prouve pas le paiement.
4

Vérifier et exécuter

Votre back-end

Vérifiez la signature du corps original et l’horodatage, puis associez l’événement à votre commande. Vérifiez le montant dû, le montant payé et le type de règlement. Renvoyez HTTP 2xx après enregistrement durable de l’événement, sans répéter la livraison de la même commande.

Détectez les événements en double avec eventId et ne livrez pas plusieurs fois la même commande. Pour un paiement insuffisant accepté manuellement, le montant payé peut être inférieur au montant dû.

Réseaux et devises

Vérifiez les devises prises en charge, les versions de jetons et les règles de confirmation de paiement.

Afficher les réseaux pris en charge →