API de paiement crypto : paiements serveur à serveur
Guide de l’API de paiement crypto : créez un paiement depuis votre serveur avec POST /api/v1/payment, obtenez un redirectUrl et le statut final par webhook.
Une API de paiement crypto permet à votre backend de créer un paiement, d’envoyer le client vers une page de paiement hébergée et de connaître le statut final sans bâtir une infrastructure blockchain. Qvard propose ce parcours sous la forme de l’API Host-to-Host v1.
Ce que fait une API de paiement crypto
Une API de paiement crypto transforme un événement de commande sur votre serveur en demande de paiement. Votre backend envoie l’identifiant de votre commande et le montant dans votre devise (USD par défaut), et la passerelle renvoie un redirectUrl vers la page de paiement hébergée, où le client choisit l’actif et le réseau. Adresses, taux et surveillance de la blockchain restent côté passerelle.
À quoi ressemble la requête v1 de Qvard
L’appel est un POST unique vers /api/v1/payment avec l’en-tête x-api-key. Le champ id porte votre propre identifiant de transaction et price le montant dans la devise du champ currency facultatif (ISO-4217, USD par défaut). paymentSystemId est facultatif et choisit un moyen de paiement si besoin. La réponse renvoie l’identifiant du paiement et le redirectUrl.
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
}Serveur à serveur, pas navigateur vers la passerelle
La requête part de votre backend, la clé d’API n’atteint donc jamais le navigateur. Le client ne voit la page de paiement hébergée qu’après que vous l’avez redirigé. Vous vérifiez aussi chaque commande de votre côté avant de créer le paiement.
Le statut final arrive par webhook
La réponse de l’API confirme la création du paiement, pas son règlement. Le statut final est livré à votre URL de webhook sous forme de POST avec les champs id et status ; la logique de commande doit donc réagir au webhook.
Ce qu’il faut vérifier avant la mise en production
Conservez l’identifiant du paiement avec la commande, rendez votre gestionnaire de webhook sûr en cas d’exécution double et testez tout le parcours avec une facture de démo. Utilisez le même identifiant pour une commande dans toutes les requêtes afin de rapprocher les appels répétés.
Frais et réseaux
Le taux de traitement de base est de 1 % par paiement et descend individuellement jusqu’à 0,1 % à mesure que votre volume augmente. Les frais de réseau sont payés à part, sur le réseau choisi par le client. La page tarifs indique les conditions en vigueur.
FAQ
Une API de paiement crypto est-elle la même chose qu’un lien de paiement ?
Non. Un lien de paiement est une page à partager pour les ventes manuelles. L’API crée le paiement depuis votre système et renvoie un redirectUrl que votre code contrôle.
Dois-je faire tourner un nœud blockchain ?
Non. Qvard surveille les réseaux et transmet le statut final par webhook, vous n’avez donc pas à exploiter de nœuds ni de scanners.
Dans quelle devise le prix est-il exprimé ?
Le champ price est dans la devise indiquée par currency (ISO-4217, par exemple INR ou EUR) ; sans ce champ, il est en USD. Le client paie dans l’actif et le réseau qu’il choisit sur la page de paiement.
Puis-je tester avant la mise en production ?
Oui. Créez une facture de démo et voyez la même page de paiement hébergée que vos clients.
