WP Manifestindependent plugin directory
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.

by Ridwan Arifandi · github.com/orangerdev/vanpay-woocommerce · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

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

Accept payments through the Vanpay hosted crypto checkout.

Description

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.

Installation

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

Changelog

1.0.0

  • Initial release.