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.

Satinder Singh

CoolHappy

Cool Plugins

<h3>Crypto Price Widgets For WordPress Website</h3>
<a href="https://cryptocurrencyplugins.com/wordpress-plugin/cryptocurrency-widgets-pro/?utm_source=ccw_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=crypto_widgets" rel="nofollow ugc">Cryptocurrency Widgets</a> is a powerful WordPress plugin that allows you to easily display live crypto prices, market data, price tickers, and coin lists on your website.
<iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/rqemHFw9KW8?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>
The key feature of this plugin is the ability to show real-time updates. This plugin utilizes third-party crypto APIs to fetch the latest market prices of virtual coins by quickly retrieving data from leading crypto exchanges.
<a href="https://cryptocurrencyplugins.com/demo/cryptocurrency-widgets-pro/?utm_source=ccw_plugin&utm_medium=readme&utm_campaign=demo&utm_content=view_demos" rel="nofollow ugc">View Demos</a>
<h3>Key Features</h3>
<ul>
<li>
Live Price Ticker: Display real-time cryptocurrency prices in a scrolling ticker. Place it in your website’s header, footer, or anywhere on your site.
</li>
<li>
Real-Time Binance Data: Utilize Binance’s live data API for accurate updates on supported cryptocurrencies, ensuring current market info.
</li>
<li>
24-Hour Percentage Changes: Show cryptocurrency price changes over the last 24 hours, allowing users to see quick market trends.
</li>
<li>
Advanced Price Table: An advanced price table of 250 top crypto coins with their marketcap, % changes, volume & circulating supply.
</li>
<li>
Advanced Tables and Multi-Currency Tabs: Create detailed tables of 250 crypto coins with their marketcap, % changes, volume & circulating supply, so users can quickly switch between different currencies or exchanges.
</li>
<li>
Multi-Fiat Currency Support: Convert and display cryptocurrency prices in different fiat currencies, like USD, EUR, and GBP etc.
</li>
<li>
API Source: This plugin displays prices of the top 250 cryptocurrencies sourced from CoinGecko, CoinMarketCap, CoinCap or Coinpaprika free API. You can select any API source from the plugin settings.
</li>
<li>
Compatibility with WordPress Themes: This plugin is compatible with all WordPress themes.
</li>
<li>
Fully Responsive: Ensures your site looks visually appealing across all devices.
</li>
</ul>
<h3>Free Version Demos</h3>
<ul>
<li><a href="https://cryptocurrencyplugins.com/demo/cryptocurrency-widgets-pro/crypto-price-ticker-widget/?utm_source=ccw_plugin&utm_medium=readme&utm_campaign=demo&utm_content=price_ticker" rel="nofollow ugc">Crypto Price Ticker</a></li>
<li><a href="https://cryptocurrencyplugins.com/demo/cryptocurrency-widgets-pro/crypto-price-list-widget/?utm_source=ccw_plugin&utm_medium=readme&utm_campaign=demo&utm_content=price_list" rel="nofollow ugc">Coins Price List</a></li>
<li><a href="https://cryptocurrencyplugins.com/demo/cryptocurrency-widgets-pro/multicurrency-tabs-widget/?utm_source=ccw_plugin&utm_medium=readme&utm_campaign=demo&utm_content=multicurrency_tabs" rel="nofollow ugc">Multi-currency Tabs</a></li>
</ul>
<h3>Upgrade To Pro</h3>
Upgrading to the Pro version unlocks the advanced features and functionalities:
<ul>
<li>
Number of Coins: In the free version, you can only display prices of the top 250 crypto coins, while in the Pro version, you can display price widgets of any crypto coin from the top 2500.
</li>
<li>
Real Time Price Updates: In the free version, crypto coin prices are updated every 5 to 10 minutes from the API. However, with the Pro version, you can enjoy real-time price updates for any coin listed on Binance, thanks to integration with the Binance API.
</li>
<li>
Advanced Layouts & Styles: Pro version provides numerous advanced layouts and style options that are not available in the free version. These include price blocks, accordion styles, price cards, slider layouts, and many others, check them in demos above.
</li>
<li>
Chart, Calculator & more: Pro version also includes additional widgets besides simple price widgets, such as historical price chart, crypto calculator, Binance widget & CoinGecko widget.
</li>
<li>
Premium Support: Pro users will get their questions answered by <a href="https://coolplugins.net/support/?utm_source=ccw_plugin&utm_medium=readme&utm_campaign=support&utm_content=premium_support" rel="nofollow ugc">Cool Plugins premium support team</a> with in 24 hours.
</li>
</ul>
<a href="https://cryptocurrencyplugins.com/wordpress-plugin/cryptocurrency-widgets-pro/?utm_source=ccw_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=pro_version" rel="nofollow ugc">Get Pro!</a>
<h3>Pro Version Demos</h3>
<ul>
<li><a href="https://cryptocurrencyplugins.com/demo/cryptocurrency-widgets-pro/crypto-price-card-widget/?utm_source=ccw_plugin&utm_medium=readme&utm_campaign=demo&utm_content=price_card" rel="nofollow ugc">Price Card Widget</a></li>
<li><a href="https://cryptocurrencyplugins.com/demo/cryptocurrency-widgets-pro/crypto-calculator-widget/?utm_source=ccw_plugin&utm_medium=readme&utm_campaign=demo&utm_content=crypto_calculator" rel="nofollow ugc">Crypto Calculator</a></li>
<li><a href="https://cryptocurrencyplugins.com/demo/cryptocurrency-widgets-pro/coingecko-widgets/?utm_source=ccw_plugin&utm_medium=readme&utm_campaign=demo&utm_content=coingecko_widgets" rel="nofollow ugc">CoinGecko Widgets</a></li>
</ul>
<blockquote>
Are you using Elementor? Try <a href="https://wordpress.org/plugins/cryptocurrency-widgets-for-elementor/" title="Cryptocurrency price widgets plugin for Elementor." rel="ugc">Cryptocurrency Widgets for Elementor</a> plugin and display crypto price widgets on your Elementor pages.
</blockquote>
<h3>Check Our Other Cryptocurrency Plugins</h3>
<ul>
<li>
<a href="https://cryptocurrencyplugins.com/wordpress-plugin/coins-marketcap/?utm_source=ccw_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=cmc_view_plugin" rel="nofollow ugc">Coins MarketCap Plugin</a>: Effortlessly integrate real-time market data for over 2,500 coins, including prices, market caps, and trading volumes. The plugin supports multiple fiat currencies and is Yoast SEO friendly, ensuring each coin has unique meta tags for better search engine visibility. 
Get a <a href="https://cryptocurrencyplugins.com/coinmarketcap-clone-website/?utm_source=ccw_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=cmc_clone_site" rel="nofollow ugc">complete website like coinmarketcap.com</a> that includes our all crypto plugins. Our developer will set it up for you.
</li>
<li>
<a href="https://cryptocurrencyplugins.com/wordpress-plugin/cryptocurrency-exchanges-list-pro/?utm_source=ccw_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=celp_view_plugin" rel="nofollow ugc">Cryptocurrency Exchanges List Pro</a>: Display real-time data from over 250 cryptocurrency exchanges on your website. Create automatic exchange pages showing trading pairs and volumes. Easily enable or disable exchanges as needed.
</li>
<li>
<a href="https://cryptocurrencyplugins.com/wordpress-plugin/pay-with-metamask-for-woocommerce-pro/?utm_source=ccw_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=cpmw_view_plugin" rel="nofollow ugc">Pay With MetaMask</a>: If you run a WooCommerce store and want to accept cryptocurrency payments at checkout, our WooCommerce Crypto Payments plugin makes it simple. Customers can pay directly with crypto using Web3 wallets such as MetaMask, WalletConnect, and more. You can <a href="https://paywithcryptocurrency.net/wordpress-plugin/test-cryptocurrency-payment/?utm_source=ccw_plugin&utm_medium=readme&utm_campaign=demo&utm_content=cpmw_view_demo" rel="nofollow ugc">test crypto payment integration in WooCommerce</a> by purchasing a dummy product on our demo site using <a href="https://paywithcryptocurrency.net/plugin-features/test-networks-and-tokens/?utm_source=ccw_plugin&utm_medium=readme&utm_campaign=demo&utm_content=cpmw_faucet" rel="nofollow ugc">faucet tokens</a>.
</li>
</ul>
Use of 3rd Party Services: This plugin connects to the Cool Plugins API to display information about related plugins inside the dashboard. It also offers optional usage tracking and optional feedback submission on deactivation. Data is sent only after explicit user consent. No hidden tracking is performed, and no frontend visitor or site user data is collected. For more details, please review our <a href="https://my.coolplugins.net/terms/usage-tracking/" rel="nofollow ugc">Data Usage Policy</a>, <a href="https://my.coolplugins.net/terms/" rel="nofollow ugc">TOS</a>, and <a href="https://my.coolplugins.net/terms/privacy-policy/" rel="nofollow ugc">Privacy Policy</a>.
<h3>Disclaimer</h3>
Our Cryptocurrency Widgets plugin offers price widgets for crypto coins through a third-party API. Please note that it does not provide crypto investment advice, buy/sell or guarantee price accuracy due to third-party API usage. Additionally, some links on this page may be affiliate links, meaning we may earn a commission if you make a purchase through these links, at no extra cost to you.

Cryptocurrency Widgets – Price Ticker & Coins List

Display cryptocurrency price ticker widget, coins live price list, table, labels & coin marketcap via shortcodes.

SouthPay Crypto Payment Gateway vs Cryptocurrency Widgets – Price Ticker & Coins List