Paiements crypto par QR code : comment un code scanné mène au paiement
Paiements crypto par QR code expliqués : comment un code scanné mène à la page de paiement, ce que Qvard prévoit pour le QR et ce qui marche.
Les paiements crypto par QR code permettent au client de scanner un code avec son portefeuille et de payer en cryptomonnaie. Qvard prévoit le paiement par QR sur son terminal de point de vente, qui n’est pas encore publié. Ce guide explique comment le scan mène au paiement et ce qui marche aujourd’hui : un QR code qui pointe vers la page de paiement hébergée.
Ce que contient un QR code
Un QR code est l’image d’un lien. Lorsque le client le scanne, le portefeuille ou le téléphone ouvre le lien, qui mène à la page de paiement de cette vente précise.
Statut : le QR sur le terminal est sur la feuille de route
Un terminal Qvard qui affiche son propre QR code n’est pas encore publié. Cet article ne le présente pas comme disponible. Le parcours QR ci-dessous fonctionne aujourd’hui, car le code encode le redirectUrl renvoyé par l’API.
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
}Ce qui fonctionne aujourd’hui
La caisse crée le paiement avec POST /api/v1/payment et l’en-tête x-api-key, reçoit le redirectUrl et l’encode en QR code. Le client scanne, ouvre la page hébergée, paie, et le webhook transmet le statut final.
N’encodez que le redirectUrl
Ne mettez que le redirectUrl dans le code. N’y placez ni la clé d’API, ni le total, ni aucun secret : quiconque voit le code peut le lire.
Affichez le montant à côté du code
Affichez le total en USD à côté du QR code. La page hébergée montre ensuite le montant exact dans la cryptomonnaie choisie, à taux fixe, pour que le client puisse comparer.
Confirmer par webhook
Un code scanné ne prouve pas le paiement. Marquez la vente comme payée uniquement lorsque le webhook transmet l’id et le statut paid.
FAQ
Qvard affiche-t-il aujourd’hui un QR code sur le terminal ?
Pas depuis un terminal dédié, qui est sur la feuille de route. Aujourd’hui votre propre caisse peut générer un QR code à partir du redirectUrl.
Puis-je mettre la clé d’API dans le QR code ?
Jamais. Le QR code ne doit contenir que le redirectUrl, qui peut être partagé en toute sécurité.
Un QR code scanné suffit-il à confirmer le paiement ?
Non. Confirmez le paiement uniquement par webhook avec le statut paid.
Comment tester le QR code ?
Créez une facture de démo, encodez son redirectUrl et scannez-le avec un portefeuille de test.
