– WordPress 5.0 or higher
– WooCommerce 5.0 or higher
– PHP 7.4 or higher
– A cryptocurrency wallet for each supported coin (e.g., Exodus Wallet, MetaMask, Trust Wallet, or hardware wallets)
# Comprehensive Guide: Setting Up Crypto Merchant Account (CMA) for the First Time
This guide provides a detailed, step-by-step process for installing and configuring the Crypto Merchant Account (CMA) plugin on your WordPress site. CMA enables your WooCommerce store to accept cryptocurrency payments, including BTC, ETH, LTC, SOL, XRP, DOGE, PLS, USDC on Ethereum, USDT on Ethereum, USDC on Base, and USDT on Base. The setup is designed to be straightforward, requiring basic familiarity with WordPress. Estimated time: 10 minutes.
**Prerequisites:**
– A functional WordPress website.
– WooCommerce installed and activated (a free plugin for e-commerce functionality).
– Access to cryptocurrency wallets for receiving payments.
– Free API keys for payment verification (required for certain cryptocurrencies).
If you encounter any issues, refer to the plugin’s support resources or WordPress documentation.
## Step 1: Install and Activate WooCommerce
CMA integrates with WooCommerce to handle payments in your online store.
1. Log in to your WordPress dashboard (yourwebsite.com/wp-admin).
2. Navigate to **Plugins** > **Add New**.
3. Search for “WooCommerce” in the search bar.
4. Locate the WooCommerce plugin (developed by Automattic) and click **Install Now**.
5. Once installed, click **Activate**.
6. Follow the WooCommerce setup wizard to configure basic store settings, such as your location, currency (recommend USD for compatibility), and payment options. This typically takes a few minutes.
If WooCommerce is already installed, proceed to the next step.
## Step 2: Download the CMA Plugin
– Visit the official download page for CMA (e.g., BullseyeIndicators.com/software).
– Download the plugin as a ZIP file (e.g., crypto-merchant-account.zip).
– Save the file to an easily accessible location on your computer.
## Step 3: Install and Activate the CMA Plugin
1. In your WordPress dashboard, go to **Plugins** > **Add New**.
2. Click **Upload Plugin** at the top of the page.
3. Select the ZIP file you downloaded and click **Install Now**.
4. After installation, click **Activate Plugin**.
CMA is now active. If prompted about WooCommerce, ensure it is installed as per Step 1.
## Step 4: Prepare Cryptocurrency Wallets
To receive payments, you need wallet addresses for each supported cryptocurrency. Wallets are digital accounts for storing and managing crypto assets. Use reputable wallet providers for security.
Recommended wallets:
– **Multi-currency options:** Trust Wallet (mobile app) for BTC, LTC, SOL, XRP, DOGE.
– **EVM-compatible (ETH, Base, PLS):** MetaMask (browser extension or mobile app).
1. **Create Wallets:**
– Install Trust Wallet from trustwallet.com or MetaMask from metamask.io.
– Create a new wallet and securely back up your recovery phrase (a series of words—store it offline and never share it).
2. **Generate Addresses:**
– **BTC:** In Trust Wallet, select Bitcoin and tap “Receive” to copy the address (starts with “bc1” or “1”).
– **ETH:** In MetaMask (on Ethereum Mainnet), copy your address (starts with “0x”).
– **LTC:** In Trust Wallet, select Litecoin (starts with “L” or “M”).
– **SOL:** In Trust Wallet, select Solana (long alphanumeric string).
– **XRP:** In Trust Wallet, select XRP (starts with “r”).
– **DOGE:** In Trust Wallet, select Dogecoin (starts with “D”).
– **PLS:** In MetaMask, add the PulseChain network (RPC URL: https://rpc.pulsechain.com, Chain ID: 369), then copy your address.
– **USDC/USDT on Ethereum:** Use your ETH address in MetaMask (add tokens via “Import Tokens” if needed for visibility).
– **USDC/USDT on Base:** In MetaMask, add the Base network (RPC URL: https://mainnet.base.org, Chain ID: 8453), then copy your address.
3. **Verify Wallets:** Send a small test amount to each address from another source to confirm receipt. This ensures everything is set up correctly.
Note: Addresses for ETH, Base, and PLS are the same across these EVM-compatible chains, but always confirm the network when sending.
## Step 5: Configure CMA Settings
Access the settings to input your wallet addresses and API keys.
1. In the WordPress dashboard, go to **Settings** > **Crypto Payments** (or search for “Crypto Merchant Account Settings”).
2. **Wallet Addresses Section:**
– Enter the corresponding wallet address for each cryptocurrency you wish to support (e.g., paste your BTC address into “BTC Wallet Address”).
– Leave fields blank for unsupported currencies.
– Save changes at the bottom.
3. **API Keys Section:**
API keys allow CMA to automatically verify payments. They are free and required for ETH/Base-related currencies, LTC, and DOGE.
– **Etherscan API Key (for ETH, USDC_ETH, USDT_ETH, and Base chains):**
– Sign up at etherscan.io (free account).
– Log in, navigate to your profile > API-KEYs.
– Create a new key and copy it.
– Paste into the “Etherscan API Key” field.
– Use the same key for “Basescan API Key” (unified under Etherscan V2).
– **BlockCypher API Key (for LTC and DOGE):**
– Sign up at blockcypher.com (free).
– In your dashboard, create a new API token and copy it.
– Paste into the “BlockCypher API Key” field.
4. Click **Save Changes**.
For other currencies (BTC, SOL, XRP, PLS), no API keys are needed as CMA uses public endpoints.
## Step 6: Enable CMA as a Payment Gateway in WooCommerce
1. Go to **WooCommerce** > **Settings** > **Payments**.
2. Locate “Crypto Payments” (or “Pay with Cryptocurrency”).
3. Enable it by toggling the switch.
4. Optionally, edit the title (e.g., “Pay with Crypto”) or description visible to customers.
5. Save changes.
CMA is now available at checkout. Customers can select a cryptocurrency and proceed.
## Step 7: Test the Setup
To ensure everything works, perform a test transaction.
1. Add a low-cost test product to your store via **Products** > **Add New** in WooCommerce.
2. Visit your site as a customer: Add the product to cart, go to checkout, select a cryptocurrency (e.g., BTC), and place the order.
3. On the order confirmation page, note the payment amount, wallet address, and QR code.
4. From your wallet, send a small test amount matching the displayed value.
5. Wait 5-15 minutes (CMA checks every 5 minutes).
6. Check the order status in **WooCommerce** > **Orders**. It should update to “Processing” upon confirmation.
7. If issues arise, review error logs via **WooCommerce** > **Status** > **Logs** or enable debug mode in WordPress.
**Common Troubleshooting:**
– **Payment not detected:** Verify API keys and wallet addresses. Test with a different cryptocurrency.
– **No QR code:** Ensure PHP GD extension is enabled (contact your host).
– **Errors during checkout:** Confirm WooCommerce is up to date and no plugin conflicts exist (deactivate others temporarily).
– For advanced help, consult the plugin documentation or support.
Your store is now equipped to accept cryptocurrency payments securely and without intermediaries. Monitor transactions in your wallets and WooCommerce dashboard. If you expand support to additional currencies, revisit the settings to add them. For any questions, refer to the plugin’s support channels.