How to Accept USDT and USDC on WooCommerce with StacoGate
A practical guide to adding USDT and USDC payments to WooCommerce with the StacoGate Payments plugin and hosted checkout.
WooCommerce merchants can add stablecoin payments without rebuilding their store around crypto.
With the StacoGate Payments plugin, your existing WooCommerce store keeps its normal product pricing and order flow while customers can choose to complete payment in supported stablecoins such as USDT or USDC.
StacoGate handles the hosted crypto payment step. Your store remains focused on WooCommerce orders, products and customers.
What StacoGate adds to WooCommerce
The StacoGate Payments plugin connects your WooCommerce store to your StacoGate merchant account.
When a customer selects StacoGate during checkout:
- WooCommerce creates the order.
- The customer is redirected to the secure StacoGate hosted checkout.
- StacoGate shows the exact supported stablecoin amount, network and payment details.
- The customer completes the payment.
- StacoGate sends a signed payment update back to your WooCommerce store.
- The customer is returned to the WooCommerce order-confirmation page.
Your WordPress site does not need to generate wallet addresses or handle private keys.
What you need before installing the plugin
Before connecting WooCommerce to StacoGate, you need:
- a WordPress site running WooCommerce 8.3 or newer
- PHP 8.1 or newer on your hosting
- an active StacoGate merchant account
- your StacoGate Secret key
- your Webhook signing secret
The plugin checks its basic requirements and will remain unavailable if required dependencies or credentials are missing.
Step 1: Install StacoGate Payments
You can download the current StacoGate Payments plugin directly from StacoGate.
In WordPress:
- Go to Plugins → Add New → Upload Plugin.
- Upload the StacoGate Payments ZIP.
- Click Install Now.
- Activate the plugin.
If WooCommerce is not active, or your PHP version is too old, the plugin displays a notice explaining what needs to be fixed.
Step 2: Open the WooCommerce payment settings
Go to:
WooCommerce → Settings → Payments
Then open StacoGate.
The settings screen includes:
- General settings for enabling the payment method and choosing what customers see at checkout
- Connection settings for your StacoGate credentials
- Connection and diagnostics for testing the saved connection and troubleshooting issues
Step 3: Connect your StacoGate merchant account
In the StacoGate connection settings:
- Copy your Secret key from your StacoGate merchant account.
- Paste it into the WooCommerce Secret key field.
- Copy your Webhook signing secret.
- Paste it into the Webhook signing secret field.
- Save the WooCommerce settings.
Secret fields are intentionally not shown again after they are saved.
If you leave an existing secret field blank and save, the plugin keeps the previously stored value. You only need to enter it again when replacing the credential.
Step 4: Test the saved connection
After saving your credentials, use Test saved connection in the Connection and diagnostics section.
A successful test confirms that WooCommerce can connect to the intended StacoGate merchant and shop.
If the test fails, check:
- that the Secret key was copied in full
- that there are no leading or trailing spaces
- that the credential belongs to the environment you intend to use
- that the StacoGate merchant account is active
The connection test validates the saved Secret key. It does not validate the Webhook signing secret, which is used separately to verify incoming payment callbacks.
Step 5: Enable stablecoin payments at checkout
Once the connection test succeeds:
- Tick Enable StacoGate.
- Set the payment title shown to customers.
- Set the checkout description.
- Save the settings.
The default checkout wording is:
Stablecoin payment
with the description:
Pay securely with supported stablecoins through StacoGate.
You can customize those customer-facing labels without changing how StacoGate processes the payment.
What the customer sees
The customer still starts on your normal WooCommerce checkout page.
After choosing StacoGate and placing the order, the customer is sent to StacoGate's hosted checkout.
There, StacoGate displays the payment amount and the available stablecoin/network choices. Once a payment option is selected, the customer receives the exact amount and deposit details needed to complete the transaction.
After the required payment confirmations are received, StacoGate marks the payment as complete and redirects the customer back to the merchant store.
The WooCommerce order is then updated from the signed StacoGate callback.
Your WooCommerce store can keep its normal currency
Your store does not need to price products in USDT or USDC.
WooCommerce can continue using a supported store currency while StacoGate calculates the corresponding stablecoin amount shown to the customer.
This is useful when you want the storefront and accounting side of WooCommerce to remain familiar while adding stablecoin payments as another checkout option.
You can see the current store and invoice pricing currencies on the supported countries and currencies page.
Customers can see the stablecoin amount after payment
After a successful StacoGate payment, WooCommerce can show the amount the customer paid in stablecoins alongside the original order total.
For example, an order can display its normal store total together with the amount paid in USDT or USDC.
The order details can also include a View blockchain transaction link so the payment can be inspected on the relevant blockchain explorer.
How payment confirmation reaches WooCommerce
StacoGate does not rely only on the customer's browser redirect.
When the payment completes, StacoGate sends a signed callback to the WooCommerce store.
The plugin verifies the callback before updating the order.
This means the StacoGate merchant account remains the payment source of truth, while WooCommerce receives the verified status it needs to move the order forward.
Troubleshooting the connection
If StacoGate does not appear at checkout, check the following first.
Connection setup required
The Secret key may not have been saved, or the last connection test may have failed.
Save the correct credential and run the connection test again.
Connection test fails
Confirm that:
- the complete Secret key was copied
- there are no extra spaces
- the key belongs to the correct StacoGate environment
- the merchant account is active
Payment method disappears from checkout
If the required StacoGate connection is missing or invalid, the plugin can make the payment method unavailable rather than leaving customers with a broken payment option.
Enable Debug logging when troubleshooting and inspect:
WooCommerce → Status → Logs
for StacoGate diagnostic entries.
The debug log is intended to record sanitized technical events and not your API secrets or authorization headers.
Can the merchant keep the payment in stablecoins?
Yes.
StacoGate supports keeping eligible funds in stablecoins instead of requesting a local-bank payout.
Where bank payout is supported, the merchant can also request payout through the available local-bank flow.
Bank-payout coverage and store pricing currency support are separate concepts, so check the supported countries and currencies page for current availability.
Do I need a separate crypto checkout inside WordPress?
No.
The purpose of the StacoGate Payments plugin is to connect WooCommerce to the StacoGate hosted checkout rather than make your WordPress installation responsible for the full blockchain payment flow.
Your store handles WooCommerce.
StacoGate handles the stablecoin payment experience and sends the verified result back to the store.
Ready to add USDT and USDC to WooCommerce?
If your StacoGate merchant account is ready, install the plugin and connect your WooCommerce store.
For the full plugin settings walkthrough, read the StacoGate Payments setup and help guide.