Troubleshooting

If something isn't behaving the way the rest of these docs describe, work through the checklist below. Each section starts with the most common cause.

Connection problems

Symptom: the Connection tab shows anything other than the Verified status.

Status	Likely cause	Fix
Not verified	You saved a new key but haven't tested it yet.	Click Run Connection Test in the Test Connection section.
Invalid key	Key was revoked on the VayaPin side, or you pasted a Sandbox key while Environment is set to Production (or vice versa).	Re-copy the key from vayapin.com/developers; confirm the Environment dropdown matches. Click Re-verify.
Invalid key (outbound blocked)	Outbound HTTPS from your server to cs.vayapin.com is blocked by your firewall / host.	Whitelist cs.vayapin.com on port 443; ask your host if outbound calls are restricted, then click Re-verify.

If nothing works, screenshot the status plus the timestamp and contact support.vayapin.com.

VayaPin field doesn't appear at checkout

1. Confirm WooCommerce is active. The VayaPin admin menu vanishes without it.
2. Confirm the plugin is active under Plugins.
3. Check Environment in Connection: if Sandbox, only logged-in admins see the widget on the storefront — switch to Production for customers.
4. In Checkout Display → Widget Position, try a different position (e.g. Below billing address form) — some themes override the default hook.
5. Disable other checkout-customising plugins one at a time. The usual suspects are CartFlows, Funnelkit, Cartbounty, and custom checkout builders that don't fire standard Woo hooks.
6. If you use WooCommerce Blocks checkout, hard-reload the page (Cmd/Ctrl + Shift + R). Block stylesheets cache aggressively.

Customer says "my code doesn't work"

1. Open Pin Creation History and filter by Date range = Today.
2. Find the row matching the customer's order. Check the Status and Error Code columns:
   • failed — read the Error Code for the reason (mistyped code, account suspended, etc.). Ask the customer to confirm the spelling or try a known-good code.
   • pending — temporary in-flight state; usually resolves on retry. If you see this stuck for hours, contact support.
   • success — autofill succeeded server-side. If the customer still says fields didn't fill, it's almost always a theme issue overwriting the autofilled values. Test on Storefront (the default Woo theme) to confirm.
3. If you see no row at all for that time window, the request never reached the plugin — check storefront console for JS errors, or any aggressive caching layer.

Webhooks aren't arriving

1. Confirm at least one event is ticked in Notifications → Events to Subscribe.
2. Open Webhook Logs and filter Status = Failed.
3. If you see Failed rows, read the Response code and Error message:
   • 4xx/5xx — your endpoint returned an error; check your application logs.
   • timeout / connection refused — endpoint is unreachable; common on staging behind HTTP auth or a firewall.
4. If you see no rows at all, the webhook either wasn't sent by VayaPin (event not subscribed) or didn't reach your endpoint URL. Confirm the URL is publicly reachable; consider the Use Auto-Generated URL button.
5. If both sides claim success but values don't match the docs, the Webhook Secret Key on the plugin and on the VayaPin dashboard are out of sync. Re-copy on both sides.

QR sticker missing on order page

1. Confirm the order was placed with a VayaPin code — orders without a code don't get a sticker.
2. Confirm Delivery → QR Delivery Sticker is Enabled.
3. The sticker shows on the WooCommerce order detail page → Delivery section (admin), not on the customer thank-you page.
4. For packing-slip output, Include on packing slip must be on AND you must have WooCommerce PDF Invoices (or a compatible packing-slip plugin) installed.

Quota exhausted

You'll get an admin notice plus email alerts at 80 % and 100 % of your monthly quota. After 100 %:

• Starter plan: lookups return quota_exhausted until the reset date.
• Paid plans: overages bill per conversion at the rate shown in vayapin.com/pricing.

To raise your quota or switch plans, head to your VayaPin dashboard.

Resetting to defaults

A single Reset all settings to defaults action is available in the footer of the Settings page. It opens a confirmation modal:

"Your API key and verification status will be cleared. Environment and webhook settings will stay as they are."

After confirmation:

• Cleared: API key, verification status, and most checkout / delivery / notification toggles.
• Preserved: Environment (Production/Sandbox), Webhook URL, Webhook Secret, onboarding-completed flag.

After reset you'll need to paste the API key again and run Run Connection Test.

Still stuck?

• Docs: docs.vayapin.com
• Support: support.vayapin.com
• Feature requests: vayapin.com/feature-requests

When opening a support ticket, please include: WP version, Woo version, plugin version (visible at the top of any settings page), and any relevant rows from Pin Creation History or Webhook Logs.