Paiement crypto intégré vs redirection : conversions et compromis
Paiement intégré vs redirection : comment chaque modèle affecte la conversion, le contrôle et l’effort. Le widget Qvard est maintenant en direct. Comparez et choisissez.
Un paiement intégré garde le paiement sur votre page, tandis qu’une redirection envoie le client vers une page hébergée. Chaque modèle comporte des compromis en conversion, contrôle et effort. Le widget Qvard intégré est maintenant en direct, donc ce guide compare les deux et montre comment choisir.
Que signifie un paiement intégré
Un paiement intégré est une fenêtre qui s’ouvre directement sur votre page via un widget JavaScript. Il peut s’agir d’une fenêtre modale ou d’un formulaire intégré. Le client reste dans le contexte de votre site et paie sans partir. La logique de paiement est la même que sur une page hébergée ; seule la présentation change.
Comment cela fonctionne chez Qvard
Le widget se charge depuis https://qvard.com/checkout.js et ouvre une fenêtre de paiement en modal ou intégré. La fenêtre est la même page de paiement Qvard : le client choisit l’actif et le réseau, le montant est fixe par votre commande. Une instance de widget reçoit votre clé publique (qvard_pk_...) pour créer le paiement côté navigateur, ou un id de paiement pour le créer côté serveur. Découvrez le terrain de jeu à https://qvard.com/en/embedded-checkout/playground/.
Deux façons de créer le paiement
Côté navigateur : transmettez la clé publique (qvard_pk_...) et le montant au widget ; il crée le paiement et ouvre la fenêtre. Côté serveur : votre backend crée le paiement via POST /api/v1/payment et transmet l’id du paiement au widget. Pour les commandes à prix fixe ou limites d’inventaire, utilisez la création côté serveur pour que le prix ne puisse pas changer dans le navigateur. Ou sautez le widget et redirigez les clients vers la page de paiement hébergée.
<script src="https://qvard.com/checkout.js"></script>
new QvardCheckout({
mode: 'modal',
publishableKey: 'qvard_pk_…',
price: 10,
onSuccess: function (e) {
console.log('paid', e.paymentId);
}
}).open();Côté serveur : créez d’abord le paiement
Votre serveur envoie l’id de commande et le prix en USD avec l’en-tête x-api-key. La réponse retourne l’id du paiement et le redirectUrl. Transmettez l’id au widget dans le navigateur, ou utilisez redirectUrl pour un redirection hébergé. Gardez la clé sur le serveur, car la requête ne doit pas provenir du navigateur.
x-api-key: qvard_sk_…
{
"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
}Vérifiez le paiement depuis le webhook
Lorsque le statut est paid, votre endpoint webhook reçoit l’id et le statut, signés avec l’en-tête X-Qvard-Signature (HMAC-SHA256). Vérifiez la signature avec votre clé secrète (qvard_sk_...) et assurez-vous que le montant correspond à votre commande. Marquez la commande comme payée uniquement après vérification de la signature.
Quand choisir la fenêtre intégrée
Utilisez le widget modal ou intégré pour garder les clients sur votre page. La page hébergée avec redirection fonctionne tout aussi bien et est une option si vous préférez ne pas intégrer la fenêtre. Les deux approches utilisent le même flux de création de paiement et webhook.
FAQ
Le paiement intégré est-il disponible chez Qvard aujourd’hui ?
Oui. Chargez le widget depuis https://qvard.com/checkout.js et transmettez votre clé publique (qvard_pk_...) pour une création côté navigateur, ou créez le paiement côté serveur et transmettez l’id.
Comment ajouter le widget à mon site ?
Incluez la balise <script src="https://qvard.com/checkout.js"></script> et instanciez QvardCheckout avec votre clé, le montant et le mode (modal ou inline). Consultez les exemples de code dans cet article et la démo.
La signature du paiement est-elle importante ?
Oui. Vérifiez toujours l’en-tête X-Qvard-Signature dans votre webhook avec votre clé secrète, et assurez-vous que le montant dans le webhook correspond à votre commande.
Puis-je utiliser la redirection au lieu de la fenêtre intégrée ?
Oui. La page de paiement hébergée au redirectUrl fonctionne tout aussi bien et ne nécessite pas de widget. Les deux approches utilisent la même API et webhook.
