Aller au contenu
QR code to Stripe paymentsDocumentation QR2Stripe

← Tous les guides

Configurer l’extension WordPress

L'extension QR2Stripe Pay crée les paiements, affiche le code QR et marque un paiement comme payé lorsque Stripe le confirme.

Temporary Stripe key La clé A. Utilisée une seule fois par la configuration automatique de Stripe et non enregistrée.
Location name, Street, City, Postal code, Country (2 letters) L'adresse de la Terminal Location. Le pays doit correspondre au pays de votre compte Stripe.
Terminal Location ID L'identifiant de la Terminal Location, il commence par tml_. Renseigné par la configuration automatique.
Webhook signing secret Le secret de signature du webhook Stripe, il commence par whsec_. Sans lui, les paiements ne sont jamais marqués comme payés.
QR mode API (recommandé) ou Inline. Voir l'article sur le mode API et le mode inline.
Website Stripe key (API mode) La clé B. Au lieu de l'enregistrer ici, vous pouvez définir QR2STRIPE_API_KEY dans wp-config.php ; la clé n'est alors pas stockée dans la base de données.
QR validity (minutes) La durée pendant laquelle un code QR peut être payé. La valeur par défaut est de 10 minutes.
Default currency, Merchant name La devise des nouveaux paiements et le nom du commerçant affiché sur le téléphone.

Installer l'extension : dans WordPress, ouvrez Extensions → Ajouter → Téléverser une extension, téléversez qr2stripe-pay-VERSION.zip et cliquez sur Activer. Une page nommée Payment avec le shortcode [qr2stripe_payment] est créée automatiquement.

Configuration automatique de Stripe : ouvrez QR2Stripe → Settings → Automatic Stripe setup, collez la clé A, renseignez le nom et l'adresse de la Location et cliquez sur Set up Stripe. L'extension crée la Terminal Location et le webhook et enregistre l'ID de la Location et le secret de signature du webhook. La clé A est utilisée une seule fois et n'est pas enregistrée. Supprimez ensuite aussitôt la clé A dans Stripe.

Choisissez le mode QR. En mode API, collez la clé B dans Website Stripe key (API mode) ou définissez-la dans wp-config.php (voir le premier exemple). Enregistrez les réglages.

Les avertissements jaunes en haut des pages QR2Stripe indiquent ce qui manque encore. Quand ils ont disparu, le site web est prêt.

Pour faire la partie Stripe à la main, créez la Location dans Stripe (Terminal → Locations, copiez l'ID tml_) et un webhook (Developers → Webhooks → Add endpoint ou Add destination) pour les événements de Your account, l'unique événement payment_intent.succeeded et l'URL du endpoint du deuxième exemple. Affichez le secret de signature et collez l'ID de la Location et le secret dans les réglages de l'extension. Un webhook ne nécessite aucune autorisation. Il doit être en HTTPS public, localhost ne fonctionne pas.

L'adresse du site doit utiliser HTTPS et les permaliens doivent être activés (Réglages → Permaliens, tout sauf « Simple »). Sinon, l'adresse du QR contient ?rest_route= et l'application la refuse.

define('QR2STRIPE_API_KEY', 'rk_...');
https://YOUR-SITE/wp-json/qr2stripe/v1/stripe-webhook