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 |
Configure the EPay plugin
- In the admin panel open 支付管理 (Payments) → 支付插件 (Pay plugins) and find the EPay plugin. If it is not listed, click 安装更多插件 (Install more plugins) to get it from the app store.
- Click 配置 (Configure) on the plugin, fill in the table below and save.
| Plugin setting | What to enter |
|---|---|
| 接口地址 (API URL) | https://gateway-domain. Enter just the domain; /submit.php is appended automatically |
| 商户 ID (Merchant ID) | pid |
| 商户密钥 (Merchant key) | key |
The EPay plugin comes from the app store, and field names can differ slightly between versions. Match them by meaning.
Add payment channels
Open 支付管理 → 支付接口 (Payment channels), click 添加支付 (Add payment) and fill in the table below.
| Field | What to enter |
|---|---|
| 支付名称 (Name) | The name buyers see, e.g. Alipay |
| 支付插件 (Pay plugin) | The EPay plugin you configured |
| 支付配置 (Pay config) | The configuration you saved in the previous step |
| 支付方式 (Method) | Alipay or WeChat Pay. If it is not listed, enter alipay or wxpay under 自定义Code (Custom code) |
| 显示终端 (Device) | 通用 (All) |
| 商品下单 / 会员充值 | Enable for orders and/or balance top-ups as needed |
Add one entry for Alipay and one for WeChat Pay. Only the name and method differ.
Test an order
- Order a low-priced product in your shop with the payment method you just added.
- You should land on the checkout page. Complete the payment.
- Back on the order page the card codes are shown and the order is marked paid in the admin panel.
Common problems
| Symptom | Cause and fix |
|---|---|
| “Signature verification failed” after redirect | The merchant key in the plugin is wrong or has stray spaces. Copy key again 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 nothing was delivered | The notification did not arrive. ACG-Faka's callback URL looks like https://your-domain/user/api/order/callback.plugin-id; make sure it is publicly reachable and not blocked by a firewall or CDN |
| No notifications after enabling the callback IP allowlist | If you turned on the callback IP allowlist in the admin panel, add the PoPoPay notification server IPs to it. Ask support for the list |
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