SDK JavaScript pour checkout crypto : prévu et opérationnel aujourd’hui
SDK JavaScript pour checkout crypto expliqué : un script prévu qui ouvre la fenêtre de paiement, ce qui est sur la feuille de route de Qvard et ce qui marche.
Un SDK JavaScript pour checkout crypto ouvrirait une fenêtre de paiement avec quelques lignes de code sur votre site. Le Low-Code SDK de Qvard figure sur la feuille de route et n’est pas encore publié. Ce guide explique l’idée et montre le parcours v1 réel que vous pouvez utiliser dès maintenant.
Ce que fait un SDK de checkout
Un SDK de checkout est une petite bibliothèque JavaScript chargée par un site pour lancer un paiement. Elle dessine la fenêtre de paiement, guide le client à travers les étapes et renvoie le statut à la page. La logique de commande reste sur le serveur du marchand.
Statut : le SDK est sur la feuille de route
Le Low-Code SDK de Qvard n’est pas encore publié, et cet article ne le présente pas comme une bibliothèque finie. L’extrait ci-dessous est un aperçu de l’appel prévu, pas un code exécutable aujourd’hui.
Ce qui fonctionne aujourd’hui
Créez le paiement sur votre serveur avec POST /api/v1/payment et l’en-tête x-api-key, redirigez le client vers le redirectUrl renvoyé sur la page de checkout hébergée, et recevez le statut final par webhook. C’est l’équivalent fonctionnel de l’appel SDK prévu.
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
}L’appel depuis le serveur
Envoyez l’identifiant de commande dans id et le prix en USD dans price. Gardez la clé d’API sur le serveur ; le navigateur ne reçoit que le redirectUrl renvoyé par le serveur.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });L’appel SDK prévu
Le SDK de la feuille de route devrait ouvrir le même parcours de paiement depuis la page, en un seul appel. Le nom de la méthode et les options peuvent changer avant la sortie : ne développez pas encore sur cet aperçu.
Comment s’y préparer
Gardez la création du paiement dans une fonction backend et le gestionnaire de webhook à part. À la sortie du SDK, seul l’appel front-end changera ; l’appel serveur et le webhook resteront les mêmes.
FAQ
Existe-t-il aujourd’hui un SDK JavaScript de checkout chez Qvard ?
Non. Le Low-Code SDK est sur la feuille de route. Aujourd’hui, le même résultat passe par l’API, la page de checkout hébergée et le webhook.
Puis-je utiliser l’appel QvardCheckout.open() maintenant ?
Non. Il n’est présenté que comme aperçu de l’API prévue. Utilisez POST /api/v1/payment et redirigez vers le redirectUrl.
Ai-je besoin d’une bibliothèque JavaScript pour accepter la crypto aujourd’hui ?
Non. Un bouton classique qui appelle votre backend et redirige vers le redirectUrl suffit ; le webhook confirme le paiement.
Comment tester le parcours ?
Créez une facture de démo et vérifiez que votre webhook reçoit le statut final.
