V2Board 188Pay 支付插件

适用于 V2Board 的 188Pay EPay 支付插件。插件会跳转到 188Pay 收银台，支付成功后由 188Pay 回调 V2Board 自动完成订单。

支持的支付类型

场景	支付类型
USDT TRC20	usdt
TRX	trx
支付宝收款	fiat_alipay

未填写支付类型时默认使用 usdt。

安装

1. 下载 Token188.php
2. 上传到 V2Board 的 app/Payments/Token188.php
3. 进入 V2Board 后台 系统配置 -> 站点，确认站点网址是公网可访问地址
4. 进入 支付配置 -> 添加支付方式
5. 按下面配置保存并启用

V2Board 配置

字段	填写
显示名称	188Pay
接口文件	Token188
网关地址	https://api2.188pay.top
商户ID（PID）	188Pay 商户后台 API 密钥页面获取
商户密钥（KEY）	188Pay 商户后台 API 密钥页面获取
支付类型	默认 usdt；支付宝填 fiat_alipay；TRX 填 trx

网关地址 填 https://api2.188pay.top 即可。插件会自动拼接 /submit.php。如果你已经填了完整的 https://api2.188pay.top/submit.php，插件也会兼容。

回调要求

• V2Board 站点网址必须能被公网访问，否则 188Pay 无法回调。
• 回调地址由 V2Board 自动生成，不需要手动填写到插件里。
• 188Pay 回调成功后，V2Board 必须返回纯文本 success。当前插件已按 V2Board 支付接口要求返回。

对接协议

插件使用 188Pay EPay 协议：

GET https://api2.188pay.top/submit.php
  ?pid=商户ID
  &type=usdt
  &out_trade_no=V2Board订单号
  &money=订单金额
  &name=订单名称
  &notify_url=V2Board回调地址
  &return_url=V2Board订单页
  &sign=签名
  &sign_type=MD5

签名规则：

1. 排除 sign、sign_type，过滤空值
2. 参数名按 ASCII 升序排序
3. 拼接为 key=value&key=value
4. 末尾直接追加商户密钥，不加 &key=
5. 计算 MD5 小写值

常见问题

支付后订单没有自动完成

检查 V2Board 后台的站点网址是否为公网地址，并确认服务器没有拦截 /api/v1/guest/payment/notify/Token188/...。

签名错误

确认商户密钥填写的是 188Pay API 密钥页面的密钥，不是网关地址。旧版插件使用 &key= 签名，本版已改为 188Pay EPay 签名规则。

想使用支付宝

新增或编辑支付方式，把 支付类型 填为：

fiat_alipay

并确认 188Pay 商户后台已开通并启用支付宝通道。

相关链接

• 官网：https://www.188pay.top
• EPay 文档：https://www.188pay.top/docs/epay
• V2Board 教程：https://www.188pay.top/docs/v2board-epay
• Telegram：https://t.me/token188