ACG-Faka EPay Setup Guide

ACG-Faka connects to EPay through a pay plugin: enter the PoPoPay gateway and key in the plugin, then add Alipay and WeChat Pay under payment channels. The admin panel is in Chinese, so the original labels are shown alongside.

  • ACG-Faka
  • EPay plugin
  • 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

Configure the EPay plugin

  1. 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.
  2. Click 配置 (Configure) on the plugin, fill in the table below and save.
Plugin settingWhat 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.

FieldWhat 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

  1. Order a low-priced product in your shop with the payment method you just added.
  2. You should land on the checkout page. Complete the payment.
  3. Back on the order page the card codes are shown and the order is marked paid in the admin panel.

Common problems

SymptomCause and fix
“Signature verification failed” after redirectThe 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 deliveredThe 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 allowlistIf 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