SouthPay

SouthPay Crypto Payment Gateway lets your WooCommerce store accept cryptocurrency payments through SouthPay’s secure hosted checkout. Connect in one click via OAuth, and the plugin handles webhook setup, token refresh, and on-chain confirmation automatically — no key copy-pasting and no manual webhook configuration.
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.
<h3>Features</h3>
<ul>
<li>One-click “Connect with SouthPay” — OAuth 2.0 with PKCE, no key copy-pasting</li>
<li>Automatic background token refresh — the connection stays live without merchant action</li>
<li>Accept cryptocurrency payments via a hosted checkout</li>
<li>Automatic order status updates via secure webhooks</li>
<li>Automatic webhook endpoint registration after first connection</li>
<li>HMAC-SHA256 webhook signature verification</li>
<li>Configurable invoice prefix</li>
<li>Minimum order amount filter</li>
<li>Debug logging via WooCommerce → Status → Logs</li>
<li>Customisable checkout title and description</li>
<li>Block checkout (Gutenberg) support</li>
</ul>
<h3>Requirements</h3>
<ul>
<li>WordPress 5.8 or higher</li>
<li>WooCommerce 6.0 or higher</li>
<li>PHP 7.4 or higher (cURL and OpenSSL extensions enabled)</li>
<li>HTTPS on your store domain — required for OAuth redirect and webhook delivery</li>
<li>A publicly reachable site URL so SouthPay can POST webhook events</li>
<li>A SouthPay merchant account at https://southpay.io/</li>
</ul>
<h3>Configuration</h3>
All settings live at WooCommerce → Settings → Payments → SouthPay.
Your SouthPay Account
<ul>
<li>Status — shows the current connection state (Connected, Disconnected, or Reconnect Required) and the connected store name.</li>
<li>Connect / Disconnect — manages the OAuth connection. Disconnecting revokes the refresh-token family on SouthPay’s side, not just the local copy.</li>
<li>API Key — only used as a manual fallback when OAuth isn’t possible (see Authentication below). Leave blank in the normal OAuth flow.</li>
</ul>
Checkout Appearance
<ul>
<li>Payment Method Name — what customers see at checkout (default: SouthPay). Customise this to something like “Pay with Crypto”.</li>
<li>Payment Method Description — short text shown below the name at checkout.</li>
</ul>
Advanced
<ul>
<li>Minimum Order Amount — hides SouthPay at checkout when the cart total is below this value. Set to <code>0</code> to always show it. Default: <code>1</code>.</li>
<li>Order Reference Prefix — prepended to the order number sent to SouthPay (default: <code>WC-</code>), so orders are easy to identify in the SouthPay dashboard.</li>
<li>Debug Logging — writes detailed request/response logs to WooCommerce → Status → Logs under the <code>southpay</code> source. Enable only when troubleshooting; the logs can contain order metadata.</li>
</ul>
<h3>Authentication</h3>
The plugin uses OAuth 2.0 with PKCE and the <code>offline_access</code> scope, so the connection survives access-token expiry without merchant intervention:
<ul>
<li>Access tokens are short-lived (one hour) and refreshed automatically before each API call.</li>
<li>Refresh tokens rotate on every use, and the previous refresh token is invalidated server-side.</li>
<li>If the refresh-token family is ever revoked (for example, an admin clicks Disconnect in the SouthPay dashboard), the plugin surfaces a Reconnect your account admin notice in WooCommerce and the gateway is hidden at checkout until reconnected.</li>
<li>Disconnecting from the WooCommerce side calls SouthPay’s revoke endpoint to invalidate the entire token family — not just the locally cached access token.</li>
</ul>
Manual API Key fallback. For environments without browser access (air-gapped boxes, whitelabel deployments, automated provisioning), paste a long-lived API key from SouthPay Dashboard → Developers → API Keys into the API Key field. This mode bypasses OAuth and does not auto-refresh; you are responsible for rotating the key yourself. The webhook still needs to be created manually in this mode.
<h3>Webhook Setup</h3>
In the standard OAuth flow there is nothing to configure — the plugin registers a webhook endpoint pointing at your site automatically the first time you connect, and stores the signing secret locally.
<ul>
<li>The active endpoint URL is shown in the Webhook URL row on the settings page (it is the WooCommerce REST route <code>/wc-api/southpay_webhook</code>).</li>
<li>Every inbound delivery is signed with HMAC-SHA256 over the raw request body plus a timestamp. The plugin rejects requests with a missing, malformed, or stale signature before any order state is touched.</li>
<li>If you ever need to rotate the signing secret (for example, after a security incident or when migrating environments), click Reconnect webhook on the settings page. The plugin will deregister the old endpoint and create a new one with a fresh secret in one step.</li>
</ul>
<h3>How It Works</h3>
<ol>
<li>The customer selects SouthPay at checkout and clicks Place order.</li>
<li>WooCommerce creates the order with status Pending payment.</li>
<li>The plugin calls <code>POST https://api.southpay.io/api/v2/payments</code> with the order total, currency, order reference, and return URLs to create a hosted-checkout session.</li>
<li>The customer is redirected to SouthPay’s hosted checkout, where they choose a cryptocurrency, see the quoted amount and exchange rate, and send the funds from their wallet.</li>
<li>Once the transaction is confirmed on-chain, SouthPay POSTs a signed webhook to your store.</li>
<li>The plugin verifies the HMAC-SHA256 signature, matches the event to the WooCommerce order, and transitions the order:
<ul>
<li>paid → order moves to Processing (or Completed for virtual orders), and a payment note is added.</li>
<li>expired → order moves to Cancelled.</li>
<li>failed → order moves to Failed; the customer can retry from the order-pay page.</li>
</ul>
</li>
<li>The customer is redirected back to your store’s order-received page.</li>
</ol>
All state transitions are driven by webhooks — the customer’s browser returning is not required to mark the order as paid.
<h3>External Services</h3>
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://southpay.io/terms 
Privacy policy: https://southpay.io/privacy

SouthPay Crypto Payment Gateway

Accept cryptocurrency payments in WooCommerce via SouthPay's hosted checkout, with one-click OAuth connect and automatic webhook registration.

Syed Muhammad Usman

aurtech

Grow globally with crypto and stablecoin checkout. Aurpay’s non-custodial smart contract flow gives you owner-controlled keys, faster settlement, and fees under 1%—vs. cards at 2.9% + 30¢, saving roughly ~$2 per $100 order (subject to network fees/FX).
<h3>For example:</h3>
On Coinbase, if a merchant has 1,000 ERC20 crypto orders, they would pay 1,000 times more in gas fees according to Coinbase’s model. Each time it costs $2, leading to a loss of $2,000. It’s impossible for Coinbase to subsidize merchants indefinitely.
With Aurpay, you only need to pay one gas fee for 1,000 orders or more, costing just $2. Invisibly, Aurpay generates significant profits for you. Every time you receive our ERC20 tokens, you earn $2. We genuinely care about your success – we make money only when you make money. It’s that simple!
<h3>Elevate your website traffic for free!</h3>
Discover our New Merchant Directory – a worldwide showcase of merchants accepting a diverse range of cryptocurrencies.
Our directory is purpose-built to boost your website traffic, connecting you with over 420 million crypto users. Stay ahead of the curve with our spotlight on evolving crypto trends, reimagining the shopping landscape. Join thousands of crypto users browsing our directory daily.
<h3>Get your company published on our directory for <a href="https://www.aurpay.net/incentive/" rel="nofollow ugc">Free here:</a>!</h3>
Unlike competing self-hosted platforms, our revenue sharing business model incentivizes us to genuinely care about your success – we make money only when you make money. It is that simple!
<a href="https://dashboard.aurpay.net/#/login?platform=WOOCOMMERCE" rel="nofollow ugc">Sign up</a>
<iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/UeNASEXFXlI?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe>
<h3>🔥 Features: What’s unique about Aurpay Crypto Payment.</h3>
<ul>
<li><a href="https://aurpay.net/" rel="nofollow ugc">Reduce gas fees:</a> Save 96% on gas for withdrawals.</li>
<li>Cost-effective: The most affordable crypto plugin, with fees below 1%.</li>
<li>Bitcoin Lightning Network support: Instant transactions with zero transaction fees.</li>
<li>[Smart contract:] (https://aurpay.net/smart-contract/) Fully non-custodial, giving merchants complete control over private keys and received payments.</li>
<li>Stablecoin settlement: Settle USDC at a 1:1 ratio with USD, ensuring zero volatility.</li>
<li>No exchange rate loss: Prices calculated using real-time exchange rates.</li>
<li>Enhanced checkout experience, boosting your product conversion rate by 20%.</li>
<li>Fraud and chargeback-free transactions.</li>
</ul>
You can place a test order in <a href="https://example-wp.aurpay.net/shop/" rel="nofollow ugc">Demo store.</a>
<h3>⚙️ Easy integration and setup</h3>
<ol>
<li>Navigate to Plugins > Add New within your WordPress admin page.</li>
<li>Install and activate Aurpay.</li>
<li>Follow instructions and “Set up Aurpay” and get”Publickey”.</li>
<li><a href="https://dashboard.aurpay.net/#/login?platform=WOOCOMMERCE" rel="nofollow ugc">Sign up</a> an Aurpay account to get “Publickey”.</li>
<li>Save the key in Aurpay payment settings, you’re all set.</li>
</ol>
For more product features, please visit our official website here, or sign up to get a merchant account.
<h3>✌️ Functionality</h3>
<ul>
<li>Accommodate minor underpayments and resolve underpaid orders.</li>
<li>Alternatively, request the remaining amount for underpaid orders.</li>
<li>Issue refunds directly from the order!</li>
<li>Share direct payment links with your customers.</li>
<li>Enjoy instant payouts to your wallet.</li>
<li>Embed a payment button on your site.</li>
<li>Customize token options and select your preferred tokens for receiving payments.</li>
</ul>
Cryptocurrencies we support:
<ul>
<li>Bitcoin BTC</li>
<li>Bitcoin lightning network, zero transaction fees，instant</li>
<li>BNB</li>
<li>ERC20 tokens</li>
<li>Ethereum ETH</li>
<li>DAI</li>
<li>USD Tether USDT (Ethereum ERC20)</li>
<li>USD Coin USDC (Ethereum ERC20)</li>
<li>USD Tether USDT (Tron TRC20)</li>
<li>USD Tether USDT (BSC BIP20)</li>
</ul>
Supported all fiat currencies. Automatically convert to crypto at real-time exchange rates.
<ul>
<li>USD – United States Dollar</li>
<li>AUD – Australian Dollar</li>
<li>BRL – Brazilian Real</li>
<li>CAD – Canadian Dollar</li>
<li>CNY – Chinese Yuan</li>
<li>EUR – Euro</li>
<li>GBP – British Pound Sterling</li>
<li>HKD – Hong Kong Dollar</li>
<li>IDR – Indonesian Rupiah</li>
<li>INR – Indian Rupee</li>
<li>JPY – Japanese Yen</li>
<li>KRW – South Korean Won</li>
<li>MXN – Mexican Peso</li>
<li>MYR – Malaysian Ringgit</li>
<li>NZD – New Zealand Dollar</li>
<li>PKR – Pakistani Rupee</li>
<li>PLN – Polish Zloty</li>
<li>RUB – Russian Ruble</li>
<li>SEK – Swedish Krona</li>
<li>SGD – Singapore Dollar</li>
<li>THB – Thai Baht</li>
<li>And more.</li>
</ul>
As a decentralized digital currency payment service, Aurpay also provides customization to our users particular need if applicable.
<h3>✨ An end buyer’s journey — Example:</h3>
<ul>
<li>A customer purchases a $100 item and chooses to pay with Bitcoin.</li>
<li>The order is generated based on the real-time exchange rate, costing 0.0049 Bitcoin.</li>
<li>Upon payment completion, the funds are transferred directly to your crypto wallet, available for withdrawal at any time.</li>
</ul>
<h3>✨ Merchant’s journey — Example:</h3>
<ul>
<li>When payment is successful, the merchant receives the funds on Aurpay’s dashboard.</li>
<li>Settle anytime and withdraw to your personal wallet address in real-time.</li>
<li>Prefer to accept only Bitcoin and stablecoins? Adjust your settings in the dashboard.</li>
<li>Implement a non-custodial smart contract, granting merchants full control over their keys and funds.</li>
</ul>
<h3>🎉 Partner Incentive Reward Program!</h3>
Join hundreds of successful WordPress, WooCommerce sellers who have chosen Aurpay as their global growth partner. Start accepting crypto in just one minute and experience the immediate benefits of our managed platform.
Learn more about <a href="https://aurpay.net/partner/" rel="nofollow ugc">Partner Program!</a>
<ul>
<li><a href="https://dashboard.aurpay.net/#/login?platform=WOOCOMMERCE" rel="nofollow ugc">Register a partner account</a> and get a percentage of their transaction-based profit. dashboard.</li>
<li>Easy sign-up referral link to get merchants.</li>
<li>Lifetime reward. Manage your merchants in the partner dashboard. The more merchants you bring, the more reward you get!</li>
</ul>

AURPAY WooCommerce – Bitcoin/USDT Crypto Payment Gateway

I tested the gateway out, it works well for my Woocommerce website, I’m looking forward to more crypto options like Dogecoin and BCH. And your non-custodial solution.

Great gateway for crypto payments, bitcoin lightning network is insanely fast.

Accept ETH, USDC, USDT, DAI, BTC & Lightning in WooCommerce. Non-custodial, low fees, no card chargebacks.

SouthPay Crypto Payment Gateway vs AURPAY WooCommerce – Bitcoin/USDT Crypto Payment Gateway