WooCommerce 安装指南

This guide helps merchants quickly integrate the StablePay WooCommerce payment plugin to add stablecoin payment capabilities to your WooCommerce store.

Before integration, ensure your WordPress environment meets the following requirements:

Please contact StablePay support to set up your merchant account. Once your account is ready:

1. Log in to StablePay Merchant Portal
2. Navigate to "Developer Settings" to obtain the following credentials (keep them secure):

Click to download the latest plugin package:

📦 Download stablepay-woocommerce-1.0.0.zip

1. Log in to WordPress Admin Dashboard
2. Go to "Plugins" → "Add New" → "Upload Plugin"
3. Click "Choose File" and select stablepay-woocommerce-x.x.x.zip
4. Click "Install Now"
5. Click "Activate Plugin" after installation

1. Extract stablepay-woocommerce-x.x.x.zip
2. Upload the extracted stablepay-woocommerce folder to wp-content/plugins/ via FTP/SFTP
3. Log in to WordPress Admin and go to "Plugins"
4. Find "StablePay for WooCommerce" and click "Activate"

After activation, access the configuration page via:

• Method 1: WordPress Admin → WooCommerce → Settings → Payments → StablePay
• Method 2: WordPress Admin → Plugins → Installed Plugins → StablePay for WooCommerce → Settings

⚠️ Security Notice: Secret Key and Webhook Secret are sensitive credentials. Do not share them with others.

Webhook is used to receive real-time payment status notifications. After configuration, the plugin will automatically generate a Webhook URL.

Configure this URL in StablePay Merchant Portal:

1. Log in to StablePay Merchant Portal
2. Go to "Developer Settings" → "Webhook Configuration"
3. Add the Webhook URL
4. Select event types to receive (recommended: select all)
5. Save configuration

After configuration, it's recommended to place a small test order to verify the payment flow.

• [ ] StablePay payment method is visible on checkout page
• [ ] Selecting StablePay redirects to the checkout page correctly
• [ ] After payment, user is redirected back to merchant site
• [ ] Order status automatically updates to "Processing"
• [ ] Order details page shows StablePay payment information

1. Go to WordPress Admin → WooCommerce → Orders
2. Click on an order number to view details
3. In the "StablePay Payment Information" section, you can view:
   • Payment Session ID
   • Payment Currency
   • Amount Received
   • Transaction Hash (viewable on blockchain explorer)

1. Click "Refund" on the order details page
2. Enter refund amount and reason
3. Click "Refund via StablePay"
4. Wait for refund processing to complete

Refund Notes:

• Only paid orders can be refunded
• Full and partial refunds are supported
• Refund period is within 180 days after payment
• Refunds are returned to the customer's wallet

Check the following:

• PHP version is 7.4 or higher
• WordPress version is 5.8 or higher
• WooCommerce is installed and activated
• cURL extension is enabled

Possible causes:

• Webhook URL not configured or incorrect
• Webhook Secret is incorrect
• Server firewall blocking callback requests

Solutions:

1. Verify Webhook URL is correctly configured in StablePay Portal
2. Check Webhook Secret matches
3. Check server firewall settings
4. Check logs to confirm if Webhook request was received

For any questions, please contact us through:

• Website: https://stablepay.co
• Merchant Portal: https://portal.stablepay.co
• Support Email: support@stablepay.co
• Documentation: https://docs.stablepay.co