Popup de paiement crypto : son fonctionnement et ce qui est prévu
Popup de paiement crypto expliqué : son fonctionnement, ce que le SDK de Qvard prévoit pour lui et ce que vous pouvez lancer aujourd’hui. Avec code.
Un popup de paiement crypto est une fenêtre de paiement qui s’ouvre au-dessus de la page en cours, si bien que le client paie sans quitter le site. Ce popup est prévu dans le cadre du SDK Qvard et n’est pas encore publié. Ce guide explique comment il fonctionne et ce que vous pouvez faire dès aujourd’hui avec l’API.
Comment fonctionne une fenêtre de paiement
La page appelle une fonction, une fenêtre s’ouvre au-dessus du contenu, le client termine le paiement dedans, puis la fenêtre se ferme. La boutique reste en arrière-plan et la commande est confirmée côté serveur.
Statut : le popup est sur la feuille de route
Le popup de checkout Qvard n’est pas encore publié, et cet article ne le décrit pas comme une fonctionnalité finie. Le code des médias est un aperçu de l’appel prévu.
Ce qui fonctionne aujourd’hui
Créez le paiement avec POST /api/v1/payment et l’en-tête x-api-key, puis redirigez le client vers le redirectUrl de la page de checkout hébergée. Recevez le statut final par webhook. Le client obtient ainsi le même résultat de paiement sans popup.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 149.99,
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Ouvrir une nouvelle fenêtre avec prudence
Si vous préférez une fenêtre séparée, ouvrez le redirectUrl dans un nouvel onglet uniquement après un clic. Les navigateurs bloquent les fenêtres ouvertes sans action de l’utilisateur ; le clic doit donc venir en premier.
Confirmer le paiement côté serveur
Le popup, lorsqu’il sortira, affichera la progression sur la page, mais le statut payé doit toujours provenir du webhook. Construisez dès maintenant la logique de commande autour du webhook.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });Ce qu’il faut éviter
Ne considérez pas une fenêtre fermée comme un paiement échoué, et ne marquez pas la commande comme payée à la fermeture de la fenêtre. Attendez le résultat du webhook.
FAQ
Existe-t-il aujourd’hui un popup de paiement Qvard ?
Pas encore. Le popup est prévu dans le cadre du SDK, sur la feuille de route. Aujourd’hui, la page de checkout hébergée ou un nouvel onglet suffit.
Une fenêtre peut-elle s’ouvrir sans clic ?
Les navigateurs la bloquent généralement. Ouvrez la page de paiement après un clic de l’utilisateur.
Que se passe-t-il si le client ferme la fenêtre ?
Ne déterminez pas le résultat à partir de l’événement de fermeture. Vérifiez le statut de la commande via le webhook.
Comment tester le parcours ?
Créez une facture de démo et vérifiez le résultat du webhook.
