Sovereign Settle – Stablecoin Gateway for WooCommerce

API and network

Stablecoin discount

Optionally apply a percentage discount when the customer selects Sovereign Settle and show a Save X% badge beside the gateway name. The discounted WooCommerce order total is used for the crypto quote.

Enable only the assets you intend to receive. Each asset has its own wallet and risk settings.

Checkout displays only the assets enabled and configured for the active network mode.

At Classic Checkout, the customer selects Sovereign Settle and completes the normal WooCommerce checkout details. The payment card then guides them through the blockchain payment:

1. select an enabled asset;
2. review the exact amount, receiving address, network and remaining payment time;
3. scan the QR code or copy the payment details into their wallet;
4. send payment and submit the transaction hash; and
5. wait while the transaction is checked and reaches the required confirmations.

The payment and confirmation card uses WooCommerce’s native order-received and customer order endpoints. A customer who leaves before submitting the hash can return through the protected WooCommerce order link while the payment opportunity remains valid.

A transaction hash cannot be accepted for more than one order. Review the order notes and Stablecoin Payment Details panel before making any manual decision about an unmatched payment.

Refunds

WooCommerce can record the commercial refund, but Sovereign Settle cannot reverse or send a blockchain transaction. Independently verify the return address and amount before sending any cryptocurrency from the merchant wallet.

Deactivation

Normal deactivation leaves settings and WooCommerce order records available for later reactivation.

Plugin deletion

Deleting the plugin runs its uninstall cleanup for current and pre-rename settings, schedules, locks and plugin-owned WooCommerce order metadata. Back up the site before deletion when historical payment data must be retained.

Sovereign Settle contacts external services only when required to quote or verify a configured payment. It does not add advertising or analytics tracking.

The WooCommerce order stores payment-related data including the selected asset, quoted amount, receiving address, exchange rate, transaction hash, confirmation state and verification timestamps. Describe this processing and the relevant external services in your own privacy information where required.

Etherscan API Terms · Etherscan Privacy Policy · Blockscout Privacy Policy · CoinGecko API Terms · CoinGecko Privacy Policy

Confirm WooCommerce is active, Sovereign Settle is enabled under WooCommerce → Settings → Payments, and at least one asset is enabled with a valid receiving address. Version 1 requires Classic Cart and Checkout.

Use a complete EVM address beginning with 0x followed by 40 hexadecimal characters. Current release 1.0.11 supports valid lowercase, uppercase and mixed-case hexadecimal addresses. Confirm that the address belongs to the intended network.

Confirm the transaction is visible on the correct network, has not failed, and is gaining confirmations. Check the required confirmation setting, Etherscan API key and scheduled processing. Browser polling, WooCommerce Action Scheduler and WordPress Cron may all participate without completing the same order twice.

Compare the order’s selected asset, token contract, receiving address and expected amount with the transfer recorded inside the submitted transaction receipt. Review the configured over-pay and under-pay tolerance. Do not complete the order merely because the wallet has received a different historical transfer.

Confirm the WooCommerce order total after selecting the gateway. The stablecoin discount is applied to the WooCommerce total before the crypto quote is calculated. A customized checkout may require its normal refresh before displaying the discount, although the resulting order total remains authoritative.

Refresh the protected order page to request a current quote if the price-freeze period expired but the overall payment window remains active. If the complete payment timeout has expired, create a new order rather than sending against the old quote.

Confirm the Etherscan key is valid and the server can make outbound HTTPS requests. If appropriate, enable the disclosed Blockscout fallback for supported live networks. CoinGecko pricing is cached and uses safe stablecoin fallback behavior during temporary rate-provider failures.

Use this filter only when the site has a non-standard post-payment route. It receives the normal WooCommerce return URL and the order object.

add_filter('sovsettle_completion_url', function ($url, $order) {
    return $url;
}, 10, 2);

Mismatch, failed and timeout states normally remain on hold for merchant review. This filter can change the customer destination without changing that order behavior.

add_filter('sovsettle_terminal_payment_url', function ($url, $order, $status) {
    if (!in_array($status, ['mismatch', 'failed', 'timeout'], true)) {
        return $url;
    }

    return add_query_arg([
        'order_id' => $order->get_id(),
        'key'      => $order->get_order_key(),
        'reason'   => $status,
    ], home_url('/order-failed/'));
}, 10, 3);

Important: the custom page must validate the WooCommerce order key before displaying order-specific information.