Aller au contenu
QR code to Stripe paymentsDocumentation QR2Stripe

← Tous les guides

Dépannage

La plupart des problèmes viennent d'une autorisation manquante dans Stripe, d'une mauvaise adresse de site web ou d'un webhook qui n'arrive pas. Trouvez votre message ci-dessous.

Cadre rouge « L'application a reçu un 502 parce que Stripe a refusé une requête » dans QR2Stripe → Payments Le message en dessous nomme le problème. Presque toujours, il s'agit d'une autorisation manquante de la clé B (Payment Intents: Write ou Connection Tokens: Write) ou d'une clé du mauvais mode (test ou production). Corrigez la clé dans Stripe ; le cadre disparaît après le prochain succès.
Erreur « Permission denied » pendant Set up Stripe Le message indique l'autorisation manquante, par exemple terminal_location_write. Il manque à la clé A Terminal → Locations: Write ou Webhook Endpoints: Write. Modifiez la clé dans Stripe et relancez la configuration ; rien n'est dupliqué.
Stripe refuse la Location ou le pays Le pays de la Location doit correspondre à votre compte Stripe (compte tchèque → adresse tchèque, CZK).
Application : Le paiement depuis le code QR n'est pas activé pour votre site web Vous avez scanné un QR inline, mais l'option est désactivée pour ce site web dans l'application. Passez l'extension en mode API, ou activez le mode inline (avec la clé C) dans l'application.
L'application n'accepte pas le QR L'adresse du site web dans l'application doit correspondre exactement à l'adresse du QR (HTTPS, le même www, sans chemin). Ajoutez l'adresse finale dans Paramètres du commerçant.
L'adresse du QR semble incorrecte ou l'application la refuse Les permaliens sont désactivés : l'adresse du QR contient donc ?rest_route= au lieu de /wp-json/. Activez-les dans Réglages → Permaliens (tout sauf « Simple »).
Application : HTTP 404 Le QR a expiré, a déjà été payé ou a été annulé. Créez-en un nouveau.
La page ne passe jamais à Paid Le webhook n'arrive pas. Dans Stripe, ouvrez le webhook et vérifiez les dernières livraisons : 400 = mauvais secret de signature, 503 = pas de secret dans WordPress, rien du tout = mauvaise URL ou le site n'est pas en HTTPS public.
Statut mismatch dans Payments Le montant, la devise ou la référence payés diffèrent de ce que le site web a créé, et vous recevez aussi un e-mail. Vérifiez le paiement dans le Dashboard Stripe avant de livrer la marchandise.
Le paiement a échoué dans l'application Vérifiez la connexion internet et le NFC. Avant de réessayer, vérifiez l'état du paiement dans Stripe pour ne pas débiter le client deux fois.
Le montant sur le téléphone diffère de celui du site web Assurez-vous que l'extension et l'application sont à jour. En mode API, le montant est lu depuis le serveur ; en mode inline, il provient du QR.

Toujours bloqué ? Consultez l'article sur comment obtenir de l'aide.