SouthPay Gateway for WooCommerce

SouthPay Gateway for WooCommerce allows you to accept cryptocurrency payments directly in your WooCommerce store.

Customers are redirected to a secure SouthPay-hosted checkout where they can pay using supported cryptocurrencies. The order status updates automatically via webhook once payment is confirmed on-chain.

Features

• Accept cryptocurrency payments via a hosted checkout
• Automatic order status updates via secure webhooks
• HMAC-SHA256 webhook signature verification (Stripe-compatible format)
• Configurable invoice prefix
• Minimum order amount filter
• Debug logging via WooCommerce → Status → Logs
• Customisable checkout title and description
• Block checkout (Gutenberg) support

Requirements

• WordPress 5.8 or higher
• WooCommerce 6.0 or higher
• PHP 7.4 or higher
• A SouthPay merchant account

Configuration

After activation:

1. Navigate to WooCommerce → Settings → Payments → SouthPay.
2. Configure:
   • Title and Description (shown to customers at checkout)
   • API Key (from SouthPay dashboard → Settings → API Keys)
   • Webhook Signing Secret (from your webhook endpoint in SouthPay dashboard)
   • Invoice Prefix (optional)
   • Minimum Order Amount (optional)
   • Debug Mode (optional)

Webhook Setup

1. In your SouthPay dashboard, go to Settings → Webhook Endpoints → Add Endpoint.
2. Set the platform to WooCommerce and paste your store URL.
3. For the webhook URL, use the value shown in your SouthPay settings page in WooCommerce.
4. Copy the signing secret shown after creating the endpoint.
5. Paste the signing secret into WooCommerce → Settings → Payments → SouthPay → Webhook Signing Secret.

How It Works

1. Customer selects SouthPay at checkout.
2. The order is created with “Pending payment” status.
3. Customer is redirected to the SouthPay hosted checkout.
4. Customer completes payment using their preferred cryptocurrency.
5. SouthPay confirms the on-chain transaction and fires a webhook.
6. The WooCommerce order status updates to “Processing” automatically.
7. Customer is redirected back to your store’s order confirmation page.

External Services

This plugin connects to the SouthPay API to create cryptocurrency payment sessions and receive order status updates via webhook. Connection to this service is required for the gateway to function.

When a customer places an order using SouthPay as the payment method, the plugin sends the order total, currency, and return URLs to https://api.southpay.io/api/v2/payments to generate a hosted checkout session. No data is sent at any other time during normal store operation.

This service is provided by SouthPay: https://southpay.io/
Terms of service: https://www.southpay.io/merchant-payment-services-agreement
Privacy policy: https://www.southpay.io/merchant-payment-services-agreement