Connection tab
Path: Vayapin → Settings → Connection
The first tab — and the only one strictly mandatory to configure. Without a valid API key the rest of the plugin can't talk to VayaPin.
API Connection
Your secret key authenticates all VayaPin address lookups and autofill requests at checkout.
API key
- Where to get one: vayapin.com/developers (free Starter tier — 50 conversions / month, no credit card).
- The key is stored encrypted at rest in the WordPress options table — it isn't readable in plain text from the database.
- Saving the key does not auto-verify. After saving, use Run Connection Test (see below) to confirm the key works.
Environment
- Production — the plugin runs normally for every customer at checkout.
- Sandbox — the VayaPin widget is shown only to logged-in shop administrators. Storefront customers see the default checkout. Use Sandbox while configuring copy, colours, or webhooks without exposing changes to real shoppers.
tip
Always switch back to Production before going live. While in Sandbox, regular customers won't see the VayaPin field at all.
Connection status
The header of the page shows the current status pill:
| Status | Meaning |
|---|---|
| Verified | The key was tested successfully against the VayaPin API. |
| Invalid key | The last test failed authentication — key is wrong, revoked, or doesn't match the environment. |
| Not verified | A key is saved but hasn't been tested yet (or the saved key was changed). |
If you see anything other than Verified, jump to Troubleshooting → Connection problems.
Test Connection
A dedicated section below the API key with two actions:
- Run Connection Test — performs a live request against the VayaPin API and updates the status pill. Run this after you first paste a key, and any time you suspect connectivity issues.
- Re-verify — re-runs the same test on an already-saved key. Useful after rotating the key on the VayaPin side or whitelisting a firewall.
Saving and rotating
- Click Save Changes at the bottom of the page to persist the key and environment. The status pill resets to Not verified until you run the connection test.
- To rotate a key: paste the new one, save, then Run Connection Test. The old key is overwritten immediately — there is no "two keys at once" mode, so swap during low traffic.