manifest / ecommerce / vanpay-woocommerce

Vanpay for WooCommerce

Unofficial WooCommerce plugin for VanPay.io. The developer is not responsible for any risks associated with its use.

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/orangerdev/vanpay-woocommerce/archive/refs/heads/main.zip

No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Accept payments through the Vanpay hosted crypto checkout.

This plugin adds Vanpay (https://vanpay.io) as a WooCommerce payment gateway.

Two checkout flows, selectable in the gateway settings: a waiting page on the store (the customer opens the Vanpay checkout in a new tab and the page updates live once the payment is confirmed — recommended), or a direct redirect to the Vanpay hosted checkout (checkout.vanpay.io).
Orders are placed on-hold while awaiting payment and confirmed by a signed payment.paid webhook (Standard Webhooks HMAC-SHA256) PLUS an authenticated re-read of the payment from the Vanpay API before fulfilment.
A reconciliation job (Action Scheduler, every 15 minutes) polls Vanpay for on-hold orders as a safety net when webhooks are delayed or unreachable.
Idempotency keys are managed automatically so retried checkouts reuse the same Vanpay payment instead of creating duplicates.
Optional: pin an on-ramp provider, choose the fee mode, choose the order status applied after payment (WooCommerce default / processing / completed), and auto-cancel orders that stay unpaid for N hours.
HPOS (custom order tables) compatible.

Important notes:

Vanpay has NO test/sandbox keys — every payment is live.
Vanpay checkout does not redirect the customer back to the store; the order is confirmed asynchronously. The waiting-page flow exists to give the customer an on-store confirmation despite this.
The Vanpay API has no refund capability, so the gateway does not offer refunds.
On a local development site webhooks cannot arrive from the internet; the reconciliation job (or the "Check payment status" button on the order screen) confirms payments instead.

Activate the plugin.
Go to WooCommerce -> Settings -> Payments -> Vanpay.
Paste your live merchant API key (vpklive...), save, then click "Test connection" and "Register webhook".