WooCommerce Installation

Step-by-step guide to install LayerPay on WordPress/WooCommerce

Requirements

  • WordPress 6.0 or higher
  • WooCommerce 7.0 or higher
  • PHP 7.4 or higher
  • SSL certificate (HTTPS required for wallet connections)

Installation

Method 1: Upload via Admin Panel (Recommended)

  1. Download layerpay-woocommerce.zip
  2. Go to your WordPress admin: Plugins → Add New
  3. Click "Upload Plugin" at the top
  4. Choose the downloaded ZIP file and click "Install Now"
  5. After installation, click "Activate Plugin"

Method 2: FTP Upload

  1. Download and unzip layerpay-woocommerce.zip
  2. Upload the layerpay folder to /wp-content/plugins/
  3. Go to Plugins in WordPress admin
  4. Find "LayerPay" and click "Activate"
# Via WP-CLI
wp plugin install layerpay-woocommerce.zip --activate

Configuration

After activation, configure the plugin:

  1. Go to WooCommerce → Settings → Payments
  2. Find "LayerPay - Crypto Payments" and click "Manage"

Required Settings

Merchant Wallet Address

Enter your Ethereum wallet address (starts with 0x). This is where you'll receive all payments.

0x742d35Cc6634C0532925a3b844Bc9e7595f...
⚠️ Use a wallet you control (MetaMask, hardware wallet). Never use an exchange deposit address.

Optional Settings

Setting Description Recommended
Network Mode Test (testnet) or Live (mainnet) Start with Test
Price Margin Buffer for price volatility 2%
Price Cache Cache duration for prices 60 seconds
Debug Mode Enable for troubleshooting Off (unless needed)

Testing

Before accepting real payments, test the integration:

  1. Set Network Mode to "Test"

    This uses testnet networks with fake tokens

  2. Get testnet ETH

    Visit sepoliafaucet.com to get free Sepolia ETH

  3. Create a test order

    Add products to cart and proceed to checkout

  4. Select "Pay with Crypto"

    Choose ETH and Sepolia network

  5. Connect wallet and pay

    Use testnet ETH to complete payment

  6. Verify order status

    Order should change to "Processing" after confirmation

💡 Test with both MetaMask and WalletConnect to ensure both work correctly.

Going Live

When you're ready to accept real payments:

  1. Change Network Mode from "Test" to "Live"
  2. Double-check your Merchant Wallet Address is correct
  3. Turn Debug Mode off
  4. Save settings
✅ LayerPay is now live! Customers will see the crypto payment option at checkout.

Order Management

Crypto payments appear in WooCommerce like any other order:

  • Order Status: Changes to "Processing" when payment is confirmed
  • Transaction ID: The blockchain transaction hash is saved with the order
  • Order Notes: Details about the crypto payment (network, amount, payer address)

You can view transaction details by clicking on any order and scrolling to the "Order Notes" section, or view on the block explorer using the transaction hash.

📧 Need help? Contact us at contact@l2pay.app