WooCommerce Plugin

WooCommerce Plugin

Add cryptocurrency payments to your WooCommerce store with our official plugin. Seamless checkout experience, automatic order updates, and full support for the WooCommerce Blocks checkout.

Tip

Using test API keys (pk_test_*) automatically enables sandbox mode with testnet coins.

Features

Embedded Checkout Modal

Customers complete payment without leaving your store

Multi-Crypto Support

Accept BTC, ETH, USDT, and more cryptocurrencies

Real-time Confirmations

Live blockchain confirmation tracking in the modal

Automatic Order Updates

Webhook-driven order status management

Sandbox Mode

Easy testing with testnet coins

Multilingual

Checkout UI supports EN, IT, ES, FR, DE

Requirements

• WordPress 5.8 or higher
• WooCommerce 5.0 or higher
• PHP 7.4 or higher
• SanPay merchant account

Installation

1. Download the plugin from the SanPay dashboard
2. Upload the `sanpay-woocommerce` folder to `/wp-content/plugins/`
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Go to WooCommerce → Settings → Payments → SanPay
5. Enter your API keys from the SanPay Dashboard
6. Copy the Webhook URL and add it to your SanPay webhook settings

Configuration

Setting	Description
Public Key	Your pk_live_xxx or pk_test_xxx key
Secret Key	Your sk_live_xxx or sk_test_xxx key
Webhook Secret	Your whsec_xxx signing secret

Note

Using pk_test_* keys automatically enables sandbox mode.

Webhook Events

The plugin handles these events automatically:

Event	WooCommerce Action
PAYMENT_CREATED	Log payment initiation
PAYMENT_DETECTED	Set order to 'On Hold'
PAYMENT_CONFIRMED	Complete the order
PAYMENT_CANCELLED	Cancel the order
PAYMENT_EXPIRED	Mark order as failed
PAYMENT_REORG	Alert admin, hold order