Système POS crypto : comment un logiciel de caisse peut encaisser la crypto
Système POS crypto expliqué : comment un logiciel de caisse accepte la crypto, ce que Qvard prévoit pour son terminal POS et ce qui marche avec l’API.
Un système POS crypto est un logiciel de point de vente qui encaisse des paiements en cryptomonnaies à côté des espèces et des cartes. Qvard prévoit un terminal POS, qui n’est pas encore publié. Cet article montre comment un logiciel de caisse peut se connecter dès aujourd’hui à l’API v1 réelle, et où un terminal dédié s’intégrerait ensuite.
Ce dont un système POS crypto a besoin
Un logiciel de caisse doit créer un paiement pour le total de la vente, afficher un lien scannable et recevoir le statut final pour clôturer la vente. Le reste, comme les tickets et les stocks, reste dans le logiciel de caisse.
Statut : le terminal POS Qvard est sur la feuille de route
Le terminal POS de Qvard n’est pas encore publié, et cet article ne le présente pas comme un appareil fini. L’intégration ci-dessous fonctionne aujourd’hui avec l’API, la page hébergée et le webhook.
L’intégration aujourd’hui
Le logiciel de caisse envoie POST /api/v1/payment avec l’en-tête x-api-key, l’identifiant et le total de la vente, reçoit un redirectUrl et l’affiche en QR code ou lien. Le webhook renvoie ensuite le statut final pour clôturer la vente dans le POS.
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
}Relier la vente au paiement
Utilisez l’identifiant de la vente comme id, pour que chaque paiement soit lié à une seule vente. Le total en USD va dans price.
Clôturer la vente par webhook
Le POS ne clôture la vente et n’imprime le ticket qu’après que le webhook a transmis paid. Les ventes en attente peuvent apparaître comme en cours, pour que le caissier sache que l’argent n’est pas encore arrivé.
Prévoir la montée en version
Quand le terminal dédié sortira, il pourra prendre en charge l’étape du QR code. Le logiciel de caisse, les enregistrements de ventes et la gestion du webhook ne changeront pas.
FAQ
Mon logiciel de caisse peut-il accepter la crypto aujourd’hui ?
Oui, s’il peut envoyer un POST HTTPS, afficher un QR code ou un lien et recevoir un webhook. Le terminal POS Qvard est sur la feuille de route.
Quel champ relie un paiement à une vente ?
Le champ id porte l’identifiant de votre vente ; chaque paiement correspond donc à une vente de votre système.
Le POS a-t-il besoin d’un plugin spécial ?
Non. Tout POS capable d’appeler un endpoint REST et de recevoir un webhook peut s’intégrer à l’API.
Comment tester l’intégration du POS ?
Créez une facture de démo depuis une vente de test et vérifiez que le POS clôture la vente à l’arrivée du webhook.
