Documentation Index
Fetch the complete documentation index at: https://docs.stablepayfi.ai/llms.txt
Use this file to discover all available pages before exploring further.
This guide helps merchants quickly integrate the StablePay WooCommerce payment plugin, enabling stablecoin payment capabilities for your WooCommerce store.
1. Prerequisites
1.1 System Requirements
Before starting the integration, please ensure your WordPress environment meets the following requirements:
| Item | Minimum Version | Recommended Version |
|---|
| PHP | 7.4+ | 8.0+ |
| WordPress | 5.8+ | Latest |
| WooCommerce | 6.0+ | Latest |
- cURL (for API communication)
- JSON (for data processing)
1.2 Obtaining a StablePay Merchant Account
Please contact StablePay support to activate your merchant account. After activation:
- Log in to the StablePay Merchant Dashboard
- Navigate to Store Management, click [Create Store], select WooCommerce as the channel type, and submit for StablePay review
- Once approved, you can obtain your API Key, Secret Key, and Webhook Secret from the store list
2. Plugin Installation
2.1 Download the Plugin Package
Click to download the latest version of the plugin package:
📦 Download stablepay-woocommerce-1.0.0.zip
2.2 Method 1: WordPress Admin Installation (Recommended)
- Log in to your WordPress admin dashboard
- Navigate to Plugins → Add New → Upload Plugin
- Click Choose File and select
stablepay-woocommerce-x.x.x.zip
- Click Install Now
- After installation, click Activate Plugin
2.3 Method 2: Manual FTP Installation
- Extract
stablepay-woocommerce-x.x.x.zip
- Upload the extracted
stablepay-woocommerce directory to wp-content/plugins/ via FTP/SFTP
- Log in to your WordPress dashboard and navigate to the Plugins page
- Find StablePay for WooCommerce and click Activate
3. Plugin Configuration
3.1 Accessing the Settings Page
After activating the plugin, access the configuration page using one of the following methods:
- Method 1: WordPress Dashboard → WooCommerce → Settings → Payments → StablePay
- Method 2: WordPress Dashboard → Plugins → Installed Plugins → StablePay for WooCommerce → Settings
3.2 Basic Settings
| Configuration Item | Description | Suggested Value |
|---|
| Enable/Disable | Whether to display StablePay as a payment option at checkout | Enabled |
| Payment Title | The payment method name displayed at checkout | StablePay - Stablecoin Payment |
| Payment Description | Brief description of the payment method | Pay securely and instantly with USDT, USDC, and other stablecoins |
3.3 API Configuration
| Configuration Item | Description | Example |
|---|
| API Key | API Key obtained from the StablePay dashboard | ak_xxxxxxxx |
| Secret Key | Signature key obtained from the StablePay dashboard | sk_xxxxxxxx |
| Webhook Secret | Webhook verification key obtained from the StablePay dashboard | whsec_xxxxxxxx |
Security Notice: Secret Key and Webhook Secret are sensitive information. Do not disclose them to others.
3.4 Configuring Webhooks
Webhooks are used to receive real-time payment status notifications. Once configured, the plugin will automatically generate the Webhook URL.
Webhook URL Format:
https://your-domain.com/wp-json/stablepay/v1/webhook
- Log in to the StablePay Merchant Dashboard
- Navigate to Store Management and manage your Webhook URL
NoteThe Webhook URL must be viewed from the WordPress dashboard, not the store URL address.
3.5 Payment Options
| Configuration Item | Description | Default Value |
|---|
| Payment Timeout | Payment session validity period (minutes) | 30 |
| Order Prefix | Prefix for StablePay order numbers to help identify source | WC- |
4. Testing and Verification
After configuration, we recommend placing a small test order to confirm the payment flow works correctly.
4.1 Verification Checklist
5. Daily Operations
- Navigate to WordPress Dashboard → WooCommerce → Orders
- Click the order number to view details
- In the StablePay Payment Information section, you can view:
- Payment Session ID
- Payment Currency
- Actual Amount Received
- Transaction Hash (viewable on blockchain explorer)
5.2 Processing Refunds
- On the order details page, click Refund
- Enter the refund amount and reason
- Click Refund via StablePay
- Wait for the refund to be processed
Refund Instructions:
- Only paid orders can be refunded
- Full and partial refunds are supported
- Refund must be requested within 180 days of payment
- Refunds will be returned to the customer’s original wallet
6. Frequently Asked Questions
Q1: What should I do if the plugin fails to activate?
Checklist:
- Is PHP version ≥ 7.4?
- Is WordPress version ≥ 5.8?
- Is WooCommerce installed and activated?
- Is the cURL extension enabled?
Q2: Payment succeeded but order status not updated?
Possible Causes:
- Webhook URL not configured or incorrectly configured
- Incorrect Webhook Secret
- Server firewall blocking callback requests
Solution:
- Confirm the Webhook URL is correctly configured in the StablePay dashboard
- Verify the Webhook Secret matches
- Check server firewall settings
- Review logs to confirm webhook requests are being received
7. Technical Support
For any questions, please contact us through the following channels:
