Terminal de paiement crypto : ce que c’est et ce qui marche aujourd’hui
Terminal de paiement crypto expliqué : un appareil de point de vente crypto, ce qui est sur la feuille de route de Qvard et ce qui marche avec l’API.
Un terminal de paiement crypto est un appareil de point de vente qui encaisse les paiements en cryptomonnaies au comptoir. Qvard prévoit un terminal sur sa feuille de route, qui n’est pas encore publié. Ce guide explique le concept et le parcours qui fonctionne : un serveur de caisse qui crée les paiements avec l’API v1 réelle.
Ce que fait un terminal de paiement crypto
Un terminal de paiement crypto affiche le montant, permet au client de payer avec son portefeuille et confirme le résultat à l’écran. Il remplace le lecteur de cartes pour les entreprises qui veulent encaisser la crypto à un comptoir physique.
Statut : le terminal est sur la feuille de route
Le terminal POS de Qvard n’est pas encore publié, et cet article ne le décrit pas comme un appareil fini. Le parcours ci-dessous est disponible aujourd’hui via l’API, la page de paiement hébergée et le webhook.
Ce qui fonctionne aujourd’hui
Le serveur de caisse crée un paiement avec POST /api/v1/payment et l’en-tête x-api-key, et reçoit un redirectUrl. Le client paie sur la page hébergée vers laquelle pointe le redirectUrl, et le webhook transmet le statut final.
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 de caisse
Envoyez l’identifiant de la vente dans id et le total en USD dans price. Gardez la clé d’API sur le serveur de caisse. La réponse renvoie le redirectUrl que la caisse affiche au client.
Confirmer la vente par webhook
La caisse ne doit marquer la vente comme payée qu’après que le webhook a transmis l’id et le statut paid. Jusque-là, la vente reste en attente, même si le client affirme avoir payé.
Se préparer à un terminal dédié
Gardez la logique de vente et le webhook dans le logiciel de caisse. Quand un terminal dédié sortira, l’appareil changera, mais la création du paiement et la gestion du statut resteront identiques.
FAQ
Existe-t-il aujourd’hui un terminal de paiement crypto Qvard ?
Pas encore. Le terminal POS est sur la feuille de route. Aujourd’hui, un serveur de caisse utilise l’API, la page hébergée et le webhook.
Puis-je utiliser mon propre logiciel de caisse ?
Oui. Tout logiciel capable d’envoyer un POST HTTPS et de recevoir un webhook peut créer des paiements via l’API.
Que voit le client au comptoir ?
Aujourd’hui la caisse affiche le redirectUrl sous forme de QR code ou de lien, et la page de paiement s’ouvre sur l’appareil du client.
Comment tester avant une vente réelle ?
Créez une facture de démo, payez-la sur la page hébergée et vérifiez que le webhook marque la vente.
