图文配置教程 · 4步完成

188Pay ZFAKA 发卡接入指南

上传 188Pay 专属插件，简单配置即可收款
支持 USDT (TRC20) / TRX，款项直达你的钱包

ZFAKA v1.4.x

插件 epay188

协议 EPay 易支付

支持 USDT-TRC20 · TRX · 支付宝

⚠️

注意 · 图示仅供参考

本教程中的界面截图为示意图，展示的是配置流程的大概位置与步骤。由于 ZFAKA 版本迭代，实际界面样式、字段名称或菜单位置可能与图示有所不同，请以你实际使用的版本为准。如遇到差异或配置问题，欢迎联系 Telegram @token188 获取支持。

📋

开始前准备

已安装 ZFAKA 发卡系统（v1.4.x）
已注册 188Pay 商户账号并添加了收款钱包
拥有 ZFAKA 服务器的 SSH 或 FTP 访问权限

准备工作

获取 188pay 商户凭证商户ID + 密钥 + 网关地址

🔒www.188pay.top/dashboard/api-keys ↗ 点击直达

API 密钥

① 复制商户 ID → 填入 ZFAKA「商户ID」字段

              620f22b6-56a8-4ac8-a5ff-a257bcb1d84b
            

② 复制密钥 → 填入 ZFAKA「商户密钥」字段

••••••••••••••••••••••••••••••••••

③ 复制网关地址 → 填入 ZFAKA「网关地址」字段

              https://api2.188pay.top
            

ZFAKA 插件使用此地址，不需要加 /submit.php

🔗

直接访问 www.188pay.top/dashboard/api-keys 复制 商户ID、密钥和网关地址，Step 03 填写 ZFAKA 配置时需要用到。

第一步

安装 188Pay 插件上传文件 + 一键安装

Terminal — SSH

# 进入 ZFAKA 安装目录
cd /你的zfaka目录

# 克隆 188Pay 插件
git clone https://github.com/utgpay2/zfakausdt.git /tmp/zfakausdt

# 复制插件文件到 ZFAKA
cp -r /tmp/zfakausdt/application/* application/
cp -r /tmp/zfakausdt/public/* public/

# 复制一键安装脚本到 ZFAKA 根目录
cp /tmp/zfakausdt/install_188pay.php .

# 设置文件权限
chmod 755 application/library/Pay/epay188/epay188.php

🚀 一键安装（推荐）

文件上传后，在浏览器中访问一键安装脚本，自动完成数据库配置：

          http://你的域名/install_188pay.php
        

脚本会自动读取 ZFAKA 的数据库配置并添加支付渠道记录，无需手动操作数据库。
⚠️ 安装完成后请立即删除 install_188pay.php 以确保安全！

📁 插件文件结构

application/
├── library/Pay/epay188/
│   └── epay188.php     ← 核心
└── modules/.../tpl/
    └── epay188.html    ← 后台模板
public/res/images/pay/
    └── 188pay.png      ← 图标

🔧 手动安装（备选）

如果一键安装不可用，可手动执行 SQL：

-- 在 t_payment 表插入一条记录
INSERT INTO t_payment
  (payment, payname, alias, ...)
VALUES
  ('188Pay USDT',
   'USDT(TRC20)',
   'epay188', ...);
-- 完整 SQL 见 install.sql

💡

插件源码在 GitHub：github.com/utgpay2/zfakausdt。如果没有 SSH 权限，也可以通过 FTP 手动上传文件和安装脚本。手动执行 SQL 可使用 phpMyAdmin 等数据库管理工具。

第二步

确认站点地址 (weburl)设置中心 → 配置中心 → weburl

🔒your-shop.com/goadmin/configure/edit/weburl

配置中心

编辑

配置名

weburl

值

http://你的域名:端口

备注

当前网站地址,用于支付站点异步返回，务必修改正确

确认修改

⚠️ 关键！末尾不要带斜杠

http://example.com:8080/ ✗
http://example.com:8080 ✓

💡 为什么 weburl 很重要？

ZFAKA 用此地址拼接回调 URL：
weburl + /product/notify/?paymethod=epay188

💡

在「设置中心 → 配置中心」找到 weburl 配置项，点击「编辑」。填入正确的站点地址（含端口），末尾不要带 /，否则回调 URL 会出现双斜杠导致 404。

第三步

配置 188Pay 支付参数支付设置 → 编辑 188Pay

🔒your-shop.com/goadmin/payment/edit/188Pay

支付设置

编辑 - 188Pay

188Pay USDT/TRX 支付配置
异步回调地址: http://你的域名/product/notify/?paymethod=epay188
同步跳转地址: http://你的域名/query/auto/{订单号}.html

支付渠道

188Pay USDT

显示名称

USDT(TRC20)

前台展示给买家的名称

商户ID

620f22b6-56a8-4ac8-a5ff-a2...

188Pay后台的商户ID (pid)

商户密钥

ucm3ICWVQvCsxCxxUxAen...

188Pay后台的Secret Key

网关地址

https://api2.188pay.top

如 https://api2.188pay.top

币种

收款币种

是否激活

激活

取消

超时(秒)

600

订单超时时间(秒), 建议600

确认修改

① 商户 ID

填入 188pay 的商户ID (pid)，从 API密钥页面复制

② 商户密钥

填入 188pay 的Secret Key 密钥，从 API密钥页面复制

③ 网关地址

填入https://api2.188pay.top

✅

填写完毕后点击「确认修改」，确保「是否激活」选择了「激活」。用户下单时即可看到 USDT 支付选项。如遇问题请联系 @token188 获取帮助。

第四步

测试支付创建测试商品，验证完整流程

创建测试商品

在 ZFAKA 后台「商品管理」创建一个测试商品，价格设为 0.10

前台下单，选择 USDT 支付

下单后页面应 跳转到 188Pay 收银台，显示钱包地址和待付金额

完成链上转账

向收银台显示的地址转入对应金额的 USDT

ZFAKA 自动发卡

支付成功后 188Pay 回调 ZFAKA，自动完成发卡，可在「订单管理」查看状态

🎉

如果测试商品能成功完成支付并自动发卡，说明配置完全正确！现在可以添加正式商品开始收款了。

参数速查

商户 ID（pid）

从 188pay 商户中心复制

商户密钥（Secret Key）

从 188pay 商户中心复制

网关地址

https://api2.188pay.top

币种

USDT (TRC20) 或 TRX

超时时间

600 秒（10 分钟）

插件标识（alias）

epay188

weburl（站点地址） — 务必正确配置，影响回调

正确 http://example.com:8080 （末尾无斜杠）

错误 http://example.com:8080/ （多了 / 会导致回调 404）

常见问题

❓ 安装后在支付设置里看不到 188Pay？

请确认已执行一键安装脚本（install_188pay.php），或手动执行 install.sql。这会在 t_payment 表插入一条记录。如果使用 Docker，确保在 ZFAKA 的容器内操作。

❓ 点击支付后跳转 404？

检查后台支付设置中的「网关地址」是否已填写（如 https://api2.188pay.top）。如果为空，跳转 URL 会指向 ZFAKA 自身而非 188Pay。

❓ 回调失败（支付成功但未自动发卡）？

1. 确认「设置中心 → 配置中心」的 weburl 配置正确，且末尾不要带 /
2. 确认回调地址 http://你的域名/product/notify/?paymethod=epay188 能从外网访问
3. 查看 ZFAKA 日志：log/yewu/ 目录下的日志文件

❓ 如何同时支持 USDT 和 TRX？

在数据库中再插入一条 t_payment 记录，将 configure4 字段改为 trx（默认是 usdt），支付名称改为 TRX 相关名称即可。

错误排查

! 常见错误排查：

• 网关地址为空：必须填写 https://api2.188pay.top，否则点击支付会 404（跳到 ZFAKA 自身而非 188Pay）。
• 回调地址 404：weburl 末尾带了 / 会导致回调 URL 出现双斜杠 //product/notify/，去掉尾部斜杠即可。
• 签名错误：请检查商户 ID 和商户密钥是否复制完整，粘贴时不要包含多余的空格或换行符。
• 插件文件未生效：确认 application/library/Pay/epay188/epay188.php 文件存在且权限正确（755），否则 ZFAKA 找不到支付类。
• 支付成功但订单未完成：检查 notify_url 是否可被公网访问。本地 localhost 无法收到回调，需部署到公网。

仍无法解决？联系 Telegram @token188 获取支持

188Pay ZFAKA 发卡 接入指南

开始前准备

参数速查

常见问题

错误排查

188Pay ZFAKA 发卡接入指南