Xboard / V2Board EPay Setup Guide

Xboard and V2Board both ship with an EPay payment interface, so no code changes are needed. Add a payment method in the admin panel and enter the PoPoPay gateway URL, merchant ID and key.

  • Xboard
  • V2Board
  • EPay V1
  • Updated

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.

ValueNotes
Gateway domainThe 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

  1. In plugin management, make sure the EPay plugin is enabled. It is bundled with Xboard.
  2. Open the payment settings, add a payment method, choose EPay as the interface, then fill in the table below and save.
FieldWhat 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.

FieldWhat to enter
URLhttps://gateway-domain with no trailing /; /submit.php is appended automatically
PIDpid
KEYkey

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

  1. Sign in as a regular user and order the cheapest plan.
  2. Choose the payment method you just added. You should land on the checkout page.
  3. After paying, return to the panel. If the order is completed and the plan is active, the setup works.

Common problems

SymptomCause and fix
“Signature verification failed” after redirectThe key is wrong or has stray spaces. Copy key again and save. See Fixing signature errors
404 after redirect, with //submit.php in the addressThe 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 activatedThe 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