# VayaPin Connector

**VayaPin Checkout Autofill for WooCommerce** — by [VayaPin](https://vayapin.com)

| | |
| --- | --- |
| **Requires WordPress** | 6.0+ (tested up to 6.7) |
| **WooCommerce** | 3.0+ (tested up to 9.x) |
| **Requires PHP** | 7.4+ |
| **Stable tag** | 2.0.0 |
| **License** | GPLv2 or later |

One-click checkout autofill powered by GPS-precise digital addresses. Reduce cart abandonment, cut failed deliveries, and grow a self-updating customer database — from a **free** WordPress plugin (VayaPin API token required).

**At a glance:** Free Starter tier includes **50 conversions/month**, no credit card · GPS precision · GDPR-minded consent flows · WooCommerce classic checkout and Blocks.

---

## Description

**Stop losing sales at checkout. Stop losing money on failed deliveries.**

41% of customers abandon their cart when address entry is difficult. 39% of deliveries fail due to inaccurate addresses. **VayaPin Checkout Autofill** addresses both with one integration: the customer enters a short code (for example **MARIA86**) → name, address, GPS coordinates, and delivery context can flow into checkout via the VayaPin API.

### What VayaPin is

VayaPin is a GPS-precision digital address system — a unique, human-readable code that maps to an exact physical location, including GPS coordinates, entrance photos, and custom delivery instructions. Your customer enters their code at checkout; fields can autofill in seconds.

### How it works

1. **Install the plugin** — Add the VayaPin field to WooCommerce checkout. Works with standard checkout and WooCommerce Blocks. Configure API token, labels, and styling in minutes (**WooCommerce → VayaPin** in admin, as implemented in this version).
2. **Customer checks out** — Has a VayaPin? Enters the code → the form can autofill → faster completion. No VayaPin? They complete checkout as usual and can opt in to **Create my VayaPin** → receive a code by email → reuse it on any VayaPin-enabled store.
3. **Delivery** — Orders can include GPS coordinates, driver instructions, and entrance photos where the API and profile provide them. Generate a **QR delivery label** for your shipping partner where the plugin supports it.
4. **Your store grows** — Customers who create a VayaPin through your checkout can associate your store as a **Favourite Pin**, keeping your brand visible for repeat purchases (per VayaPin product behaviour).

### Why merchants choose VayaPin

- **Less abandonment** — Address forms are a major friction point; one-tap style autofill reduces typing on mobile, tablet, and desktop.
- **GPS-precise deliveries** — Coordinates and entrance context, not only a street line — fewer “could not find address” failures.
- **Always-current data** — When customers update their VayaPin, subsequent lookups reflect their latest details.
- **Better delivery experience** — Clearer handoffs to carriers and fewer refund/support cycles when the address is unambiguous.

### VayaPin vs traditional address validators

| Traditional address validators | VayaPin Checkout Autofill |
| --- | --- |
| Address validation only | One-click full checkout autofill |
| No deep WooCommerce-native checkout integration | WooCommerce-native — classic checkout and Blocks |
| Static data that goes stale | Auto-updating customer identity via VayaPin |
| No GPS-level precision | GPS coordinates + entrance photos where available |
| No delivery workflow helpers | QR-coded delivery labels for partners |

### Industry context (illustrative)

Figures often cited in e-commerce and logistics research (see your own compliance for marketing claims):

| Metric | Context |
| --- | --- |
| **41%** | Shoppers abandon checkout when address entry is difficult |
| **60%** | Faster checkout on mobile with VayaPin-style autofill (product positioning) |
| **71%** | Failed deliveries tied to inaccurate address data (sector narratives) |
| **$17–$30** | Typical reship/support cost band per failed delivery |
| **85%** | Shoppers who may not return after a poor delivery experience |
| **69.6%** | Average cart abandonment across e-commerce (benchmark) |

### Plugin features

- **VayaPin autofill field** at checkout — configurable label, placeholder, and position  
- **API lookup** — can fill name, address, phone, email, city, postcode, country, and GPS coordinates (field set depends on API response and profile)  
- **Customer opt-in** — e.g. *Create my VayaPin for faster checkout everywhere*  
- **GPS capture** on VayaPin orders — stored in WooCommerce order meta where enabled  
- **Delivery instructions** and entrance photos when provided by the profile/API  
- **QR delivery label** generation — print or share with carriers (where configured)  
- **VayaPin delivery metabox** on the order screen  
- **Analytics** in admin — conversions, autofill rate, new VayaPins, estimates where implemented  
- **Classic + Blocks** checkout compatibility (as supported by this release)  
- **HPOS** compatible where WooCommerce supports it  
- **Hooks and filters** for developers  
- **Consent-aware flows** — configure copy to match GDPR and local requirements  
- **Responsive** — mobile, tablet, desktop  

### Pricing and plans

The WordPress plugin is **free** to install. You need a **VayaPin API token**. Get a free Starter token at [vayapin.com/developers](https://vayapin.com/developers) — no credit card on Starter as offered by VayaPin. **Paid plans** scale with conversion volume; SaaS pricing applies to the API, not the plugin zip.

| Tier | Price | Includes (per listing) |
| --- | --- | --- |
| **Starter** | Free | 50 conversions/month, all features on Starter, no credit card |
| **Business** | $29/mo | 1,000 conversions/month, email support |
| **Professional** | $99/mo | 5,000 conversions/month, priority live chat |
| **Scale** | $249/mo | 15,000 conversions/month, phone + webhooks |
| **Enterprise** | Custom | 50,000+ conversions/month, dedicated AM |

*Paid SaaS plans: 30-day money-back guarantee per VayaPin terms. The plugin download itself is free.*

---

## External services

This plugin uses the **VayaPin API** to resolve codes and related address or profile data during checkout and admin flows.

| | |
| --- | --- |
| **Service** | VayaPin API |
| **Endpoint (example)** | [https://cs.vayapin.com](https://cs.vayapin.com) |
| **Terms** | [VayaPin Terms of Use](https://vayapin.com/terms-of-use) |
| **Privacy** | [VayaPin Privacy Policy](https://vayapin.com/privacy-policy) |

Data sent to VayaPin is limited to what is needed to authenticate and to perform lookups or actions you enable. You must use a valid API token. Describe data flows accurately in your privacy policy and checkout notices.

---

## Installation

1. Upload the `vayapin` folder to `/wp-content/plugins/` or install from a package / WordPress.org when available.  
2. Activate the plugin under **Plugins**.  
3. Install and activate **WooCommerce** (3.0+; test against your Woo major version).  
4. Open **VayaPin** in the WordPress admin (or **WooCommerce → Settings → VayaPin** where that UI is wired) and paste your **API key**, choose **production/sandbox** if shown, save.  
5. Adjust checkout widget copy, colours, notices, webhooks, and delivery options.  

**API token:** [vayapin.com/developers](https://vayapin.com/developers)

---

## Frequently asked questions

### Is the free plan completely free — no credit card required?

Yes. The Starter plan includes **50 conversions per month** at no cost, with no credit card required. Plugin features available on Starter depend on VayaPin’s current plan matrix. Upgrade when you need higher volume.

### Will this slow down my store?

VayaPin loads checkout assets where needed, with a minimal JS footprint on checkout. The marketplace copy states asynchronous loading and negligible impact on Core Web Vitals (LCP, CLS, INP); still profile your stack alongside other plugins.

### What happens when a customer doesn’t have a VayaPin?

They checkout with a normal address. An optional checkbox can offer: *Create my VayaPin with this information for faster checkout everywhere.* If they opt in, they receive a permanent code by email for future VayaPin-enabled stores.

### Does this work with my theme and checkout setup?

Yes, for typical WooCommerce themes, **classic checkout** and **WooCommerce Blocks**. Hooks and filters exist for customization. Heavily modified checkouts may need developer support.

### Is customer data secure and GDPR compliant?

Traffic uses encrypted connections. Customers should explicitly authorise sharing VayaPin data at checkout. VayaPin publishes compliance documentation; **you** remain responsible for lawful basis, notices, and regional rules.

### What if a customer moves or changes contact details?

When they update their VayaPin, the next lookup can reflect current details — fewer stale addresses on repeat orders.

### Do my customers need the VayaPin Chrome extension?

No. The WooCommerce plugin is independent of any browser extension. Shoppers enter the code in the checkout field. The Chrome extension is a separate product for other sites.

### What data does my store receive per order?

Typically: full name, address, phone, email, city, postcode, country, GPS coordinates (lat/long), entrance type, and custom delivery instructions from the VayaPin profile — **exact fields depend on API response and settings**.

### What happens if I exceed my monthly conversion limit?

The plugin can keep working while VayaPin applies account rules. You may get email alerts at **80%** and **100%** of quota; overages may bill per conversion — see [vayapin.com/pricing](https://vayapin.com/pricing).

### Can I use this on multiple WooCommerce sites?

Yes. **Each site should use its own API token**; one VayaPin developer account can manage multiple tokens. Limits apply **per token**, not only per account.

### What payment gateways does VayaPin work with?

All major WooCommerce gateways (Stripe, PayPal, Square, WooPayments, etc.). VayaPin handles **address autofill only**, not payment processing.

### Do you offer refunds?

Paid SaaS subscriptions include a **30-day money-back** guarantee per VayaPin policy (contact **support@vayapin.com** within 30 days of first charge). The WordPress plugin itself is free; the guarantee applies to **paid API/SaaS** plans.

### Where are docs and support?

- Documentation: [docs.vayapin.com](https://docs.vayapin.com)  
- Support: [support.vayapin.com](https://support.vayapin.com)  
- Feature requests: [vayapin.com/feature-requests](https://vayapin.com/feature-requests)  

---

## Changelog

### 2.0.0

- Settings UI refresh, checkout and delivery options, webhooks and logging, compatibility updates.  
- Documentation aligned with WooCommerce.com–style product copy and API disclosure.

### 1.0.0

- Initial public structure for the VayaPin Connector plugin.

---

## Upgrade notice

**2.0.0** — Review VayaPin settings after upgrading, re-save if prompted, and test checkout on staging first.

---

## License

[GPLv2 or later](https://www.gnu.org/licenses/gpl-2.0.html).

WordPress.org–style packaging also ships [`readme.txt`](readme.txt) (same story, `.txt` format).
