Sovereign Settle – Stablecoin Gateway for WooCommerce — Documentation

General settings

Asset settings

Enable only the assets you intend to receive. Each enabled asset has its own payment rules.

The checkout displays only assets enabled and configured in your settings.

After selecting Stablecoin Payments at Classic Checkout, the customer:

1. chooses an enabled asset;
2. receives the exact payment amount, receiving address and payment deadline;
3. sends payment from their wallet and submits the transaction hash;
4. waits while CCP verifies the transaction; and
5. returns to the normal WooCommerce order-received page once payment is confirmed.

If the customer leaves before submitting a transaction hash, they can return through the normal WooCommerce order endpoint and complete payment while the payment window remains active.

How verification works

CCP verifies the transaction hash against the selected asset, expected amount, configured receiving address and required confirmation count. A transaction hash can only be submitted for one order.

Waiting for blockchain confirmations

The transaction has been found but has not yet reached the required confirmation count. The order remains on hold until verification completes or the payment window expires.

Asset, amount or recipient mismatch

CCP does not complete the order. Check the selected asset, network, destination address and transaction amount before investigating the payment manually.

Payment window expired

The customer must create a new order. The original order remains available for merchant review and is not automatically completed.

Etherscan or exchange-rate issue

Confirm the API key is saved, the transaction is visible in the relevant block explorer, and the server can make outbound requests. Stablecoin price conversion falls back safely if a rate provider is temporarily unavailable.

Use this filter only when a 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);

For a payment amount mismatch, failed blockchain transaction or timeout, Sovereign Settle normally keeps the order on hold for merchant review. Use this filter to direct those terminal states to a custom page.

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: A custom page must validate the WooCommerce order key before displaying order-specific details. This filter changes the destination only; Sovereign Settle still leaves terminal payments on hold for merchant review.