Self-Hosted Crypto Payments: SHKeeper with WooCommerce Guide

SHKeeper is a self-hosted cryptocurrency payment processor that integrates directly with WooCommerce through a free plugin. It supports 19-plus cryptocurrencies and stablecoins across multiple networks, charges zero platform fees (network fees still apply), and is fully non-custodial. Here is how to deploy it and connect it to your WordPress store.

Prerequisites

• A VPS or dedicated server: 2 cores, 6GB RAM, 20GB SSD minimum
• Docker and Docker Compose installed
• A WordPress site with WooCommerce (self-hosted)
• A domain pointing to your server

Step 1: Deploy SHKeeper

Clone the SHKeeper repository and deploy:

git clone https://github.com/vsys-host/shkeeper.io
cd shkeeper.io
docker compose up -d

Step 2: Configure Wallets

Open the SHKeeper admin panel. Go to Wallets. Add a wallet for each cryptocurrency you want to accept. SHKeeper generates wallet addresses or connects to existing wallets. Configure auto-withdrawals to send funds to a cold wallet at set intervals or when a balance threshold is reached. This keeps the bulk of your funds in cold storage while the hot wallet handles daily transactions.

Step 3: Install the WooCommerce Plugin

In your WordPress admin panel, go to Plugins, Add New. Upload the SHKeeper plugin ZIP file (available free from the SHKeeper GitHub). Activate it. Go to WooCommerce, Settings, Payments. Enable SHKeeper. Enter your SHKeeper instance URL and API key.

At checkout, customers now see a Pay with Cryptocurrency option. They select their preferred coin, and SHKeeper displays the wallet address and QR code. The customer sends the payment, and SHKeeper confirms it on the blockchain. Payment status updates automatically in WooCommerce.

Step 4: Configure Exchange Rates and Commissions

SHKeeper fetches live exchange rates from multiple price sources. You can add a markup percentage if you want to cover exchange costs or add a small commission. The default is 0 percent, meaning your customer pays exactly the market rate. You can also set a fixed rate to lock in a price regardless of market fluctuations.

Step 5: Test a Transaction

Before going live, switch SHKeeper to testnet mode. Place a test order on your WooCommerce store. Pay with testnet coins. Verify that the payment is detected, the order status updates, and auto-withdrawals work as configured. Switch back to mainnet when testing is complete.

What You Can Accept

With SHKeeper deployed, your WooCommerce store can accept:

• Bitcoin: On-chain and Lightning Network
• Stablecoins: USDT and USDC on ERC20, TRC20, BEP-20, Polygon, Avalanche, Arbitrum, Optimism, and TON
• Other crypto: ETH, LTC, DOGE, XMR, XRP, TRX, BNB, SOL, MATIC, AVAX, TON, DAI, PYUSD

All with zero platform fees (network fees still apply). All non-custodial. All going directly from your customer to your wallet with no intermediary.

VPS1 deploys SHKeeper with WooCommerce integration and wallet configuration. We handle the Docker setup, the blockchain nodes, and the plugin integration. You start accepting crypto with zero platform fees.