Accepter la crypto en magasin : comment une boutique physique peut encaisser la crypto aujourd’hui
Accepter la crypto en magasin physique : le parcours de vente en caisse, ce que prévoit le terminal Qvard et le chemin qui marche aujourd’hui avec l’API.
Accepter la crypto en magasin signifie que le client paie au comptoir avec un portefeuille au lieu d’une carte. Qvard prévoit un terminal de point de vente pour cela, qui n’est pas encore publié. Ce guide explique le parcours de vente et le chemin qui fonctionne aujourd’hui : la caisse crée le paiement et le client paie sur la page hébergée.
Le parcours de vente en magasin
Le caissier saisit le total, la caisse affiche un code de paiement, le client le scanne avec un portefeuille et la vente est confirmée. Les étapes sont simples, mais la caisse doit savoir quand le paiement est définitif.
Statut : le terminal POS est sur la feuille de route
Un terminal Qvard dédié aux magasins n’est pas encore publié, et cet article ne le présente pas comme disponible. Le parcours de vente ci-dessous fonctionne aujourd’hui avec l’API, la page hébergée et le webhook.
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 un redirectUrl et l’affiche sous forme de QR code ou de lien. Le client paie sur la page hébergée, et le webhook renvoie le statut final à la caisse.
Affichez le total avant le paiement
Affichez le montant en USD au comptoir avant que le client ne scanne. La page hébergée montre ensuite le montant exact en crypto à taux fixe pour l’actif et le réseau choisis.
Gérer le statut au comptoir
Gardez la vente en attente sur la caisse jusqu’à ce que le webhook transmette paid. Le ticket imprimé doit suivre le statut payé, pas la parole du client.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Préparer le terminal
Quand le terminal dédié sortira, l’appareil du comptoir changera. Le logiciel de caisse, les enregistrements de commandes et la gestion du webhook resteront en place.
FAQ
Une boutique peut-elle encaisser la crypto au comptoir aujourd’hui ?
Oui, avec une caisse qui crée les paiements via l’API et affiche le redirectUrl en QR code ou lien. Le terminal dédié est sur la feuille de route.
Le client a-t-il besoin d’une application ?
Il a besoin d’un portefeuille qui prend en charge l’actif et le réseau choisis. La page hébergée guide le paiement.
Quand une vente est-elle définitive ?
Lorsque le webhook transmet l’id et le statut paid, et non quand le client montre l’écran de paiement.
Comment tester en magasin ?
Créez une facture de démo depuis une caisse de test et vérifiez que le webhook marque la vente avant la mise en service.
