Créer un paiement crypto et obtenir un redirectUrl
Créer un paiement crypto et obtenir un redirectUrl en un seul appel API : POST /api/v1/payment, en-tête x-api-key, montant dans votre devise (USD par défaut) et redirection vers le paiement.
Créer un paiement et obtenir un redirectUrl se fait en une seule requête avec l’API Host-to-Host v1 de Qvard. Ce guide détaille les champs de la requête, la réponse et la manière d’envoyer le client au paiement en toute sécurité.
Les champs de la requête
Envoyez un POST vers /api/v1/payment avec l’en-tête x-api-key. id est votre identifiant de transaction, price le montant dans la devise choisie (USD par défaut), currency un code ISO-4217 facultatif tel que INR, RUB ou EUR, et paymentSystemId est facultatif. Gardez l’id unique par commande pour rapprocher la réponse de votre registre. Une devise non prise en charge est refusée avec 422 unsupported_currency, un nombre de décimales supérieur à ce que la devise autorise avec 422 invalid_amount_precision, et une devise sans taux avec 422 rate_unavailable.
Lire la réponse
La réponse contient l’identifiant du paiement et le redirectUrl, qui pointe vers la page hébergée https://my.qvard.com/pay/ suivie de l’identifiant du paiement. Enregistrez les deux valeurs avec la commande avant de rediriger le client.
Rediriger le client
Envoyez le client vers le redirectUrl par une redirection HTTP classique ou par un lien sur votre site. Sur la page hébergée, le client choisit l’actif et le réseau et voit le montant exact à taux fixe.
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
}Erreurs et nouvelles tentatives
Si une requête échoue, vérifiez vos registres avant de la renvoyer, afin qu’une commande ne donne pas lieu à deux paiements. Journalisez le corps de la réponse pour le support et ne relancez que si aucun paiement n’existe pour cette commande.
Erreurs courantes
Ne mettez pas x-api-key dans le code front-end, ne considérez pas la redirection comme une confirmation de paiement, et n’envoyez pas le prix dans une autre devise que celle du champ currency. Le statut final arrive toujours par webhook.
Une commande en ligne, étape par étape
Quand l’acheteur clique sur payer, votre serveur crée le paiement avec l’identifiant de commande et le total du panier, puis redirige l’acheteur vers le redirectUrl. Lorsque le webhook signale le paiement, vous marquez la commande comme payée.
FAQ
Dois-je envoyer paymentSystemId ?
Non, il est facultatif. Envoyez-le si vous voulez un moyen de paiement précis ; sinon la page hébergée propose les options disponibles.
Puis-je réutiliser un redirectUrl pour une autre commande ?
Non. Chaque paiement a son propre redirectUrl. Créez un nouveau paiement pour chaque commande.
Le client peut-il payer depuis un lien que je lui envoie par e-mail ?
Oui. Le redirectUrl est une page HTTPS ordinaire, qui fonctionne dans un e-mail ou un chat. Le lien de paiement sans code depuis le tableau de bord est sur la feuille de route.
Quel montant le client paie-t-il ?
La page hébergée affiche le montant exact de l’actif choisi, à taux fixe pendant toute la durée de vie de la facture.
