Skip to content
QR code to Stripe paymentsQR2Stripe documentation

← All guides

Troubleshooting

Most problems come from a missing Stripe permission, a wrong website address or a webhook that does not arrive. Find your message below.

Red box “The app got a 502 because Stripe refused a request” in QR2Stripe → Payments The message under it names the problem. Almost always a missing permission of key B (Payment Intents: Write or Connection Tokens: Write) or a key from the wrong mode (test or live). Fix the key in Stripe; the box disappears after the next success.
“Permission denied” error during Set up Stripe The message names the missing permission, for example terminal_location_write. Key A lacks Terminal → Locations: Write or Webhook Endpoints: Write. Edit the key in Stripe and run the setup again; nothing is duplicated.
Stripe rejects the Location or the country The Location's country must match your Stripe account (Czech account → Czech address, CZK).
App: Paying from the QR code is not enabled for your website You scanned an inline QR but the option is off for that website in the app. Switch the plugin to API mode, or enable inline mode (with key C) in the app.
The app does not accept the QR The website address in the app must match the address in the QR exactly (HTTPS, the same www, no path). Add the final address in Merchant settings.
The QR address looks wrong or the app refuses it Pretty permalinks are off, so the QR address contains ?rest_route= instead of /wp-json/. Enable them in Settings → Permalinks (anything but “Plain”).
App: HTTP 404 The QR expired, was already paid or was cancelled. Create a new one.
The page never changes to Paid The webhook does not arrive. In Stripe open the webhook and check the recent deliveries: 400 = wrong signing secret, 503 = no secret in WordPress, nothing at all = wrong URL or the site is not on public HTTPS.
Status mismatch in Payments The paid amount, currency or reference differs from what the website created, and you also get an e-mail. Check the payment in the Stripe Dashboard before you release any goods.
Payment failed in the app Check the internet connection and NFC. Before trying again, check the payment status in Stripe so the customer is not charged twice.
The amount on the phone differs from the website Make sure the plugin and the app are up to date. In API mode the amount is read from the server, in inline mode it comes from the QR.

Still stuck? See the article on getting help.