Intégrer le paiement crypto au backend, étape par étape
Intégrer le paiement crypto au backend étape par étape : créer les paiements depuis votre serveur, rediriger le client, vérifier les webhooks et rapprocher.
Intégrer le paiement crypto à un backend demande trois éléments : un appel serveur qui crée le paiement, une redirection pour le client et un webhook qui clôt la commande. Ce guide détaille chaque étape avec l’API v1 de Qvard.
Étape 1 : enregistrer la commande d’abord
Enregistrez la commande dans votre base avec un statut comme pending avant d’appeler l’API. Utilisez l’identifiant de commande comme champ id : le paiement et la commande sont liés dès le départ.
Étape 2 : créer le paiement
Depuis votre backend, envoyez un POST vers /api/v1/payment avec l’en-tête x-api-key, l’identifiant de commande dans id et le total dans price. Gardez la clé d’API dans la configuration serveur, jamais dans le code front-end.
Étape 3 : rediriger le client
Enregistrez le redirectUrl renvoyé avec la commande et envoyez-y le client. Sur la page hébergée, le client choisit l’actif et le réseau et paie le montant exact.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR",
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Étape 4 : clôturer la commande depuis le webhook
Votre endpoint webhook vérifie x-api-key, retrouve la commande par id et la passe à payée lorsque le statut est paid. C’est le seul endroit où un paiement est confirmé.
Étape 5 : rapprocher et surveiller
Lancez chaque jour un contrôle des commandes restées trop longtemps en attente et comparez-les à vos registres de paiement. Journalisez chaque réponse de l’API et chaque webhook pour le support.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Conseils d’architecture
Gardez le code de paiement dans un petit service distinct des vues de checkout. Vous pourrez ainsi modifier le gestionnaire de webhook ou ajouter un second canal sans toucher au reste de la boutique.
FAQ
Quels langages de backend puis-je utiliser ?
Tout langage capable d’envoyer un POST HTTPS avec un corps JSON et de recevoir un webhook. L’API est en HTTP simple, aucun SDK n’est requis.
Où dois-je placer l’URL du webhook ?
Utilisez un endpoint HTTPS public sur votre backend. Il doit accepter les POST et vérifier l’en-tête x-api-key avant de mettre une commande à jour.
Faut-il une intégration distincte pour chaque cryptomonnaie ?
Non. Le client choisit l’actif et le réseau sur la page de checkout hébergée ; votre backend crée donc un seul paiement en USD et lit un seul statut.
Puis-je tester toute l’intégration au préalable ?
Oui. Utilisez le parcours de facture de démo pour payer une facture test et vérifiez que votre gestionnaire de webhook s’exécute avant d’accepter de vrais paiements.
