Before you start
First ask official support to open an integration app. You will get the three values below; every system on this site uses the same set.
| Value | Notes |
|---|---|
| Gateway domain | The payment gateway from support, e.g. https://gateway-domain |
Merchant ID (pid) | Your app's merchant ID |
Merchant key (key) | Your app's key, used for MD5 signing. Keep it secret |
Xboard
- In plugin management, make sure the EPay plugin is enabled. It is bundled with Xboard.
- Open the payment settings, add a payment method, choose
EPayas the interface, then fill in the table below and save.
| Field | What to enter |
|---|---|
| 支付网关地址 (Gateway URL) | https://gateway-domain, including https:// and with no trailing /; /submit.php is appended automatically |
| 商户ID (Merchant ID) | pid |
| 通信密钥 (Key) | key |
| 支付类型 (Payment type) | alipay or wxpay. Leave blank to send buyers to the checkout page to choose |
To let buyers pick Alipay or WeChat Pay inside the panel, add two payment methods with the payment type set to alipay and wxpay. Adding a single method with the type left blank also works.
V2Board
Open the payment settings in the admin panel, add a payment method, choose EPay as the interface file, then fill in the table below and save.
| Field | What to enter |
|---|---|
| URL | https://gateway-domain with no trailing /; /submit.php is appended automatically |
| PID | pid |
| KEY | key |
V2Board's EPay interface does not send a payment method, so buyers land on the PoPoPay checkout page and choose Alipay or WeChat Pay there. One payment method is enough.
Notify URL
Both panels generate the notify URL automatically, in the form https://your-panel-domain/api/v1/guest/payment/notify/EPay/an-id. You do not enter it anywhere; just make sure it is reachable from the public internet.
Leave the custom notify domain empty in most cases. Fill it in only if your public panel domain cannot receive callbacks and another domain has to take them.
Both panels place orders by page redirect (/submit.php), so no API IP allowlist is needed.
Test an order
- Sign in as a regular user and order the cheapest plan.
- Choose the payment method you just added. You should land on the checkout page.
- After paying, return to the panel. If the order is completed and the plan is active, the setup works.
Common problems
| Symptom | Cause and fix |
|---|---|
| “Signature verification failed” after redirect | The key is wrong or has stray spaces. Copy key again and save. See Fixing signature errors |
404 after redirect, with //submit.php in the address | The gateway URL has a trailing /. Remove it and save |
| “No product configured for payment method xxx” | That method is not enabled yet, or its code is wrong (WeChat Pay is wxpay, not wechat). If the code is right, ask support to enable it |
| Paid, but the order is not activated | The notification did not arrive. Make sure the panel domain is publicly reachable and the notify path is not blocked by a firewall or CDN. See Missing notifications |
For other errors see Troubleshooting; for protocol details see Signing and Async notification.
More integration docs
Get your merchant ID and key
Contact official support to open an integration app. Your gateway URL, pid and key are issued directly, with hands-on help during testing.
Contact support