BoltUtil Payments for WooCommerce

BoltUtil connects WooCommerce to the BoltUtil payment service. Customers select a stablecoin and network, place an order, and continue to BoltUtil Hosted Checkout. BoltUtil creates the payment, displays the receiving address and exact payable amount, monitors the network, and reports the confirmed result to WooCommerce. The plugin does not receive cryptocurrency or store wallet private keys or recovery phrases.

USDT supports TRON (TRC20), Ethereum (ERC20), BNB Smart Chain (BEP20), Polygon PoS, and Solana. Native USDC supports Ethereum, Polygon PoS, and Solana; Binance-Peg USDC supports BNB Smart Chain (BEP20). These routes require activation by BoltUtil. Checkout offers only routes enabled in the service and plugin, with an active merchant receiving wallet. Existing installations default to USDT only. Base supports native USDC and Bridged USDT; other assets and networks are not supported.

Only WooCommerce stores using USD are supported. The USD numeric order total is the stablecoin invoice basis; this release does not provide a live exchange-rate quote or lock. The exact stablecoin amount displayed on BoltUtil Hosted Checkout is the amount to pay. Network transaction fees are charged by the customer’s wallet or network, separately from the invoice amount.

BoltUtil is an external service required for this plugin. Merchants must register a BoltUtil account, create a LIVE API key, configure receiving wallets and an active Webhook, and enter the key and Webhook secret in the gateway settings. A free order allowance is available each day; subscription plans have no daily order limit. Current allowances, plan benefits and fees are described at https://boltutil.com/pricing . The service, rather than plugin code, enforces account limits.

When a customer checks out, the plugin sends the order amount, USD currency, selected USDT or USDC token, selected network, a store-specific external order ID, the store’s return URL, and a merchant reference to BoltUtil over HTTPS. It sends the merchant API key and a signed request; it does not send the customer’s wallet private key. The plugin receives signed payment events and queries BoltUtil to verify status before completing a WooCommerce order. See https://boltutil.com/privacy and https://boltutil.com/terms for BoltUtil service policies. The merchant remains responsible for their store’s own privacy notice and payment disclosures.

1. Install and activate WooCommerce, then install this plugin.
2. Set the WooCommerce store currency to USD.
3. In BoltUtil, create a LIVE API key, enable a receiving wallet for each desired network, and create an active Webhook using the URL shown in WooCommerce > Settings > Payments > BoltUtil Payments.
4. Enter the LIVE API key and the matching Webhook secret in the gateway settings. Select stablecoins and networks backed by active receiving wallets, enable the gateway, and save.
5. Place an unpaid order to check the network choice, BoltUtil redirect, amount, address, and return link. Returning to the store does not mark the order paid.

1. 

   Real demo Checkout Blocks: select USDT and one of six available networks.

2. 

   Switch to USDC and see five eligible networks, including native USDC on Base.

3. 

   WooCommerce merchant setup guide and daily free allowance information; no secret credential inputs are shown.

4. 

   Public BoltUtil Studio demonstration shop with small digital products. Purchases use real funds.

0.6.1

• Use WordPress.org language packs in the directory edition; bundled catalogs remain available in the GitHub installation package.
• Describe daily free allowances and unlimited daily subscription orders without hardcoding a quota; link to the current BoltUtil plans.
• Use documented CC0 network artwork and an original GPL Base network illustration for directory distribution.
• Reject malformed Webhook event IDs without a PHP type error.
• Align the WordPress minimum with the required WooCommerce 11.1 release.

0.6.0

• Let buyers choose USDT or USDC first, then show only eligible payment networks.
• Preserve the selected network when switching coins where that combination is available.
• Keep coin and network choices through classic checkout refreshes; validate routes server-side.
• Restore the Solana black circular mark and gradient bars.

0.5.3

• Replace Polygon, BNB Chain and Base illustrations with unchanged SVGs from their official brand resources.
• Preserve logo proportions and improve contrast and clear space in classic and block checkout.
• Version network icon URLs so upgrades do not display cached legacy artwork.
• Record official asset sources and distinguish their usage terms from CC0 artwork.

0.5.2

• Add service-enabled Base native USDC and Bridged USDT routes with explicit labels.
• Add an original GPL generic network illustration for Base.

0.5.1

• Add service-enabled Binance-Peg USDC on BNB Smart Chain (BEP20) and explicit representation labels in classic and block checkout.
• Preserve API symbols and USDT-only upgrade defaults.

0.5.0

• Add merchant-controlled stablecoin selection and server-authoritative network/asset routes.
• Support native USDC on service-enabled Ethereum, Polygon PoS and Solana routes.
• Preserve old USDT orders and settings; verify stored asset identity in Webhooks and reconciliation.
• Add the CC0 USDC icon and update multilingual configuration guidance.

0.4.21

• Log a safe WooCommerce warning when a payment status check cannot be verified, so merchants can investigate orders that remain On hold.

0.4.20

• Continue scheduled status checks for unpaid orders until BoltUtil reports a verified final status. The previous check mistakenly treated its own running Action Scheduler task as a pending follow-up.

0.4.19

• Declare tested WooCommerce 11.1 compatibility for HPOS and Cart and Checkout Blocks.
• Prepare the WordPress.org listing and release checks. Payment creation, monitoring, and Webhook behavior are unchanged.

0.4.18

• Publish source documentation and the GPL license, with comments explaining API signing, retries, decimal comparison, and Webhook verification. Payment behavior is unchanged.

0.4.17

• Package the CC0 icon license as a text file recognized by WordPress Plugin Check.

0.4.16

• Replace the network and USDT images with CC0 artwork distributed with a source and license notice.
• Send LIVE payment API requests only to the official BoltUtil API origin, including on upgraded stores.
• Clean release packages of editor backup files and keep credentials out of distributable ZIPs.

0.4.15

• Remove the square WooCommerce Blocks side rails around the BoltUtil payment option and use light network cards with a clear selected state.
• Add pricing, documentation, terms, and support links to the BoltUtil settings menu and installed-plugin row.

0.4.14

• Match the BoltUtil checkout network choices with chain and USDT image badges in Classic Checkout and Checkout Blocks.
• Keep the network names visible so the payment options remain identifiable when images cannot load, and show a masked credential hint without submitting it as a new key.

0.4.13

• Register WooCommerce gateway hooks once so status reconciliation does not duplicate the BoltUtil details panel or manual order actions.

0.4.12

• Mark an unpaid WooCommerce order Failed after a merchant-scoped BoltUtil status read verifies EXPIRED, FAILED, or CANCELLED, while retaining the status in an order note.
• Keep amount discrepancies for merchant review and preserve the existing completion verification path.

0.4.11

• Added bundled translations for Spanish, Brazilian Portuguese, Russian, Vietnamese, Turkish, Japanese, Korean, Arabic, French, and Hindi, alongside English source text and Simplified Chinese.
• Interface language follows the WordPress locale; English remains the fallback when a translation is unavailable.

0.4.10

• Added a complete Simplified Chinese PO/MO language pack and a bundled translation path for ZIP installations.
• Let WordPress translations control the display language, including Traditional Chinese and future community translations.

0.4.9

• Clarified a translated payment-status placeholder and removed obsolete manual text-domain loading.
• Hardened secret-field input handling and escaped the Webhook event table identifier in SQL.

0.4.8

• Prepared WordPress.org release metadata and documented the current USDT scope and external service requirements.
• Kept the existing WooCommerce gateway ID and payment behavior unchanged.
• Replaced bundled chain and token artwork with text badges for clear distribution rights.
• Made English interface strings available to standard WordPress translation tools.