Comment fonctionne redirectUrl dans la caisse crypto

Ce qu'est redirectUrl

Vous créez un paiement avec un seul POST vers https://api.qvard.com/api/v1/payment (l'en-tête x-api-key, votre numéro de commande comme id, le montant comme price en dollars américains). La réponse est 201 avec deux champs : id, l'identifiant du paiement chez Qvard, et redirectUrl, de la forme https://my.qvard.com/pay/<id>.

L'adresse mène à une page de paiement hébergée : une page gérée par Qvard, pas par votre serveur. Vous ne la construisez pas, ne l'hébergez pas et ne la maintenez pas. Votre travail est d'amener le client à cette adresse, puis de connaître le résultat par le webhook.

Ce que voit le client

Sur la page, le client :

1. choisit un actif et un réseau (ou trouve celui que vous avez présélectionné avec un paymentSystemId) ;
2. voit l'adresse et le montant exact à envoyer, avec le réseau affiché à côté de l'adresse ;
3. envoie le transfert depuis son propre portefeuille ou sa plateforme.

Le taux de la page est fixé pendant une heure, le montant ne bouge donc pas pendant que le client paie. La page est la même quel que soit l'aspect de votre boutique, et c'est le but : vous obtenez une caisse crypto qui fonctionne sans en construire une. Pour la voir avant d'intégrer, ouvrez une facture de démonstration.

Utiliser le lien à la caisse

L'usage standard est une redirection côté serveur ou un bouton, en trois étapes :

1. Le client choisit « Payer en crypto ». Votre serveur crée votre propre commande et le paiement Qvard.
2. Votre serveur répond avec le redirectUrl, sous forme de redirection HTTP ou de valeur que votre front-end utilise pour naviguer.
3. Le navigateur va sur la page ; le client y paie.

Créez le paiement après que le client a appuyé sur le bouton, pas à la constitution du panier. N'envoyez jamais la clé API secrète au navigateur : le navigateur ne reçoit que le redirectUrl. Un exemple complet de bouton se trouve dans bouton de paiement crypto pour sites web.

Utiliser le lien hors d'une caisse

Comme la page est hébergée à une adresse simple, le lien fonctionne aussi hors d'une caisse web :

• Dans un e-mail ou un PDF de facture, à côté des coordonnées bancaires, pour qu'un client professionnel puisse choisir de payer en crypto (voir paiements en stablecoins pour les factures B2B).
• Dans un chat ou un message de support, pour un paiement ponctuel créé à la main avec vos propres outils.
• Derrière un QR code, si votre propre système en génère un à partir de l'adresse.

Traitez le lien comme l'entrée de ce seul paiement. Envoyez-le au client auquel il appartient et ne le publiez pas. Les liens de paiement comme produit distinct sans code sont en développement ; aujourd'hui vous créez le paiement par l'API et partagez l'adresse qu'elle renvoie.

Répétitions, nouvelles tentatives et ce qui se passe après le paiement

• La même commande deux fois. Envoyer le même id pour le même moyen de paiement renvoie le paiement existant ; un double clic ou une requête réessayée donne donc le même paiement et non un second.
• Pas encore d'URL de retour. Après avoir payé, le client n'est pas renvoyé automatiquement sur votre site ; les URL de retour ne sont pas encore disponibles. Donnez-lui une page de commande qui affiche le statut réel et se rafraîchit pendant l'attente.
• Le résultat, c'est le webhook. Qvard appelle votre callback URL lorsque le paiement est terminé, avec votre id et le statut. Votre point de terminaison doit répondre exactement HTTP 200 et être sûr s'il s'exécute deux fois. Un client revenu sur votre site n'est pas une preuve de paiement. Voir comment sécuriser les webhooks de paiement crypto.

Ce que le lien ne fait pas

Pour que vous ne le cherchiez pas :

• Il ne vous donne pas le statut du paiement ; il n'existe pas de route pour lire un paiement par son id, utilisez donc le webhook et vos propres enregistrements.
• Il ne ramène pas le client sur votre site ; les URL de retour ne sont pas encore disponibles.
• Il ne remplace pas votre page de commande : il vous en faut toujours une qui affiche « en attente », « partiel » ou « payé ».

Les formats de requête et de réponse sont dans API de paiement crypto pour les développeurs, et tout le flux dans comment accepter les paiements crypto sur un site web.

FAQ