VouchLinks for WooCommerce

VouchLinks for WooCommerce connects a merchant's WooCommerce store to their VouchLinks advertiser account. After connection, the plugin captures VouchLinks referral identifiers from visitor URLs, stores attribution on WooCommerce orders, and sends configured order events to VouchLinks. VouchLinks event settings decide which WooCommerce events are tracked and which events trigger conversion rewards. This plugin requires a VouchLinks advertiser account, advertiser email, and API key. Features

• Connect a WooCommerce store using VouchLinks advertiser email and API key.
• Automatically sends the WordPress store URL to VouchLinks during connection.
• Captures ref_id, refId, referral_id, link_id, Link_id, tracking_code, and code.
• Stores attribution in browser cookies, WooCommerce sessions, and order metadata.
• Sends WooCommerce event monitoring records to VouchLinks.
• Sends conversion postbacks when VouchLinks marks an event as rewarded.
• Sends refund/cancellation postbacks for enabled reversal events.
• Declares compatibility with WooCommerce High-Performance Order Storage.

Supported WooCommerce Events

• Order Paid: woocommerce_payment_complete
• Order Completed: woocommerce_order_status_completed
• Cancelled/Refunded: woocommerce_order_status_cancelled, woocommerce_order_status_refunded, woocommerce_order_fully_refunded
• Chargeback/Failed: woocommerce_order_status_failed

External Service This plugin relies on VouchLinks, an external service operated by VouchLinks, to connect a WooCommerce store to a merchant's VouchLinks advertiser account, load VouchLinks event settings, record WooCommerce order events, and send conversion or refund postbacks for attribution and reward processing. Service endpoints: Production API endpoint: https://api.vouchlinks.com/api/v1 Development API endpoint: https://dev.api.vouchlinks.com/api/v1 Service website: https://vouchlinks.com Advertiser account portal linked from the settings screen: https://app.vouchlinks.com Data sent to VouchLinks:

• When a merchant connects the store, the plugin sends the merchant's VouchLinks advertiser email, VouchLinks API key, WordPress store URL, and plugin version.
• When event settings are synced or loaded, the plugin sends the saved VouchLinks advertiser email and API key in request headers.
• When a shopper visits with VouchLinks attribution parameters, the plugin stores the attribution identifiers locally in browser cookies, the WooCommerce session, and order metadata. These identifiers are sent to VouchLinks only when a tracked WooCommerce order event is processed.
• When an enabled WooCommerce order event is processed, the plugin sends the event type, order ID, order amount, currency, store URL, VouchLinks attribution identifiers, billing email, and line item details such as product name, product category, price, and quantity.
• When an enabled cancellation, refund, or failed order event is processed, the plugin also sends the order ID, VouchLinks link ID, reversal reason, and related order payload so VouchLinks can reverse or record the conversion status.

Data is sent only after the merchant has connected the plugin with VouchLinks credentials. Production is used by default. The development endpoint is used only when the site owner explicitly configures the plugin for development testing with VOUCHLINK_WC_API_ENV or VOUCHLINK_WC_API_BASE_URL. Terms of Service: https://www.vouchlinks.com/terms Privacy Policy: https://www.vouchlinks.com/privacy

1. Upload the vouchlink-woocommerce folder to /wp-content/plugins/, or upload the plugin zip through Plugins > Add New > Upload Plugin.
2. Activate the plugin in WordPress.
3. Go to WooCommerce > VouchLinks.
4. Enter the advertiser's VouchLinks email and API key.
5. Click Connect Store.
6. Click Sync Event Settings.

Production is used by default. For development testing, define this constant in wp-config.php: define('VOUCHLINK_WC_API_ENV', 'dev');

1.0.0

• Initial release.
• Store connection with VouchLinks email and API key.
• Referral attribution capture.
• VouchLinks event settings sync.
• Conversion and refund postbacks.