This article lists the most frequently reported issues in WP SmartPay and how to resolve them quickly.

"No gateway selected" at Checkout

Symptom: The checkout form appears but there is no payment button or gateway selector.

Cause: No gateway is enabled in SmartPay settings, or the form does not have a gateway assigned.

Fix:

  1. Go to SmartPay → Settings → Payment Gateways.
  2. Enable at least one gateway (Test Payment is always available for quick testing).
  3. Open the form in the editor and confirm the Payment sidebar panel shows an active gateway.

Stripe Webhook Signature Failure

Symptom: Stripe payments complete on Stripe's side but stay Pending in SmartPay. The debug log shows "webhook signature verification failed".

Fix:

  1. Go to your Stripe Dashboard → Developers → Webhooks.
  2. Click the webhook endpoint to see its details.
  3. Copy the Signing Secret (starts with whsec_).
  4. Paste it into the Webhook Secret field in SmartPay's Stripe gateway settings.
  5. Save and test with a new payment.

License Key Not Activating

Symptom: Clicking "Activate License" shows an error or the status stays Inactive.

Fixes:

  • Double-check the key for extra spaces or line breaks when pasting.
  • Confirm you have not exceeded the activation limit for your license plan — deactivate on an unused site first.
  • Check that your server can make outbound HTTPS requests to the licensing server (some firewalls block external connections). Ask your host to confirm.
  • Try deactivating and reactivating: clear the existing key, save, then re-enter and activate.

Currency Mismatch Error

Symptom: Gateway declines the payment with a currency-related error.

Cause: The currency set in SmartPay General Settings is not supported by your gateway account, or the gateway is not configured to accept that currency.

Fix:

  1. Check your gateway dashboard to see which currencies your account supports.
  2. Go to SmartPay → Settings → General and update the currency to match a supported one.
  3. For Stripe: confirm the currency is enabled in your Stripe account settings.

Missing Receipt Page / 404 After Payment

Symptom: After a successful payment, the customer sees a 404 or blank page instead of the receipt.

Fix:

  1. Create a WordPress page with the [smartpay_payment_receipt] shortcode.
  2. Go to SmartPay → Settings → General.
  3. Set the Payment Success Page field to that page.
  4. Save settings.

Payments Stuck at Pending

This is the most common issue and is almost always caused by webhooks not reaching your site. See Payment Not Completing for a full troubleshooting checklist.

Forms Appear Blank on Frontend

Symptom: The shortcode or block is on the page but nothing renders.

Fixes:

  • Confirm the free SmartPay plugin is active — Pro alone will not render forms.
  • Check for JavaScript errors in the browser console (press F12). JS errors from other plugins can break SmartPay's checkout rendering.
  • Deactivate other plugins one by one to identify a conflict.
  • Switch to a default WordPress theme temporarily to rule out a theme conflict.