⚠️

注意 · 图示仅供参考

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

📋

开始前准备

进入 www.188pay.top/dashboard/api-keys 复制商户ID（PID）和密钥（KEY）
用管理员账号登录 V2Board 管理后台
确认收款钱包已在 188pay 添加并启用 USDT 或 TRX

准备工作

获取 188pay 商户凭证PID + KEY，填写 V2Board 时需要用到

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

API 密钥

① 复制商户 ID（PID） → 填入 V2Board「PID」字段

              a1b2c3d4-e5f6-7890-abcd-ef1234567890
            

② 复制密钥（KEY） → 填入 V2Board「KEY」字段

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

③ 记录网关地址（URL） → 填入 V2Board「URL」字段

              https://api2.188pay.top
            

V2Board EPay 驱动会自动拼接 /submit.php，URL 字段 不要带 /submit.php，也不要有末尾斜杠

🔗

直接访问 www.188pay.top/dashboard/api-keys 复制 商户ID（PID）和密钥（KEY），后续步骤填写 V2Board 时需要用到。

第一步（重要前提）

确认「系统配置」→ 站点网址回调地址依赖此配置，必须正确

🔒your-v2board.com/admin#/setting

站点 ← 在这个 Tab

安全

邀请&佣金

个性化

节点

邮件

站点名称

用于显示需要站点名称的地方

站点网址 ⚠️

当前网站最新网址，将会在邮件等需要用于网址处体现

必须先填写！回调地址依赖此值。填你的域名或 IP（末尾加 /）

强制 HTTPS

当站点没有使用 HTTPS、CDN 或反代开启强制 HTTPS 时需要开启

⚠️

站点网址决定回调地址。 如果填错或留空，188pay 无法将支付成功通知发回 V2Board，订单将无法自动完成。填写格式：https://your-domain.com/（末尾带斜杠）。

第二步

进入「支付配置」，点击添加左侧菜单 → 设置 → 支付配置

🔒your-v2board.com/admin#/payment

+ 添加支付方式 ← 点这里

ID	启用	显示名称	支付接口	通知地址	操作
≡ 1		188pay	EPay	https://your-v2board.com/api/v1/guest/payment/notify/EPay/vLQevtlD	编辑删除

🆕 首次接入

点击「+ 添加支付方式」，进入 Step 03 填写配置

✏️ 已有配置

找到 188pay 那一行，点「编辑」修改即可，无需重新添加

💡

列表中「通知地址」列显示的 URL（如 /api/v1/guest/payment/notify/EPay/xxxxx）是 V2Board 自动生成的回调接收地址，188pay 支付成功后会向此地址发送通知，无需手动填写。

第三步

填写 188pay 配置信息选 EPay 接口，填入 URL / PID / KEY

🔒your-v2board.com/admin#/payment

+ 添加支付方式

ID	启用	显示名称	支付接口	通知地址	操作
≡ 1		188pay	EPay	…/notify/EPay/vLQevtlD	编辑

① 接口文件

下拉选择 EPay（易支付），不要选 Stripe / PayPal 等其他驱动

② URL（网关地址）

填 https://api2.188pay.top
不带 /submit.php，不带末尾 /

③ PID（商户 ID）

从 188pay 商户中心复制的商户 ID

④ KEY（商户密钥）

从 188pay 商户中心复制的商户密钥，不是网关地址

✅

保存后回到支付配置列表，确认启用开关已打开（蓝色）。用户下单时即可看到 188pay USDT 支付选项。如果支付页面报错，请先检查 URL 是否带了多余的路径或斜杠，或联系 @token188 获取帮助。

第四步

确认启用，完成接入列表中开关打开即生效

🔒your-v2board.com/admin#/payment

+ 添加支付方式

ID	启用	显示名称	支付接口	通知地址 ⓘ	操作
≡ 1	已启用 ✓	188pay	EPay	https://your-v2board.com/api/v1/guest/payment/notify/EPay/vLQevtlD	编辑删除

🎉

配置完成！用户在订单结算页会看到 188pay 支付选项，付款后 V2Board 自动收到回调并完成订单。「通知地址」列显示的 URL 就是 V2Board 生成的回调地址，188pay 会自动向该地址发送支付结果通知，无需手动填写。

建议：保存后验证配置

1 用一个测试账号在 V2Board 前台下单，结算页应能看到 188pay 支付选项

2 选择支付后应跳转至 188pay 收银台，显示 USDT 收款地址和金额

3 完成支付后，V2Board 订单状态应自动变为「已支付」— 若未自动更新，检查站点网址配置是否可公网访问

参数速查

显示名称（可自定义）

188pay

接口文件（必须选此项）

EPay

URL（网关地址）— 不带 /submit.php，不带末尾斜杠

常见问题

❓ URL 应该填什么？要加 /submit.php 吗？

V2Board 的 EPay 驱动会自动在 URL 后拼接 /submit.php，所以填 https://api2.188pay.top 即可，不需要手动加 /submit.php，也不要加末尾斜杠。

❓ 支付成功了，但订单还是待支付状态？

检查「系统配置 → 站点网址」是否填了正确的公网域名或 IP，并且 V2Board 可以被公网访问。本地或内网环境无法收到 188pay 的支付回调。回调地址在支付配置列表的「通知地址」列可以查看。

❓ 支付页面提示「签名错误」？

请检查 PID 和 KEY 是否从 188pay 完整复制，粘贴时不要包含多余的空格或换行符。也可以尝试重新生成密钥后再填一次。

❓ 用户看不到 188pay 支付选项？

确认支付配置列表中 188pay 的启用开关已打开（蓝色状态）。另外检查该支付方式对应的订阅套餐是否有关联的支付配置限制。

错误排查

! 常见错误排查：

• URL 格式错误：只填 https://api2.188pay.top，不要加 /submit.php，也不要末尾斜杠。
• 站点网址未配置：「系统配置 → 站点网址」必须是可公网访问的真实域名或 IP，否则 188pay 无法回调。
• 接口文件选错：请确认下拉选了「EPay」，而不是其他驱动（Stripe、PayPal 等协议不兼容）。
• 收款地址未配置：在 188pay 商户中心确认已添加 USDT（TRC20）或 TRX 收款地址，并已启用对应币种。
• PID / KEY 带有空格：复制时可能夹带多余空格，粘贴后仔细检查首尾是否干净。

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

188Pay V2Board 接入指南

开始前准备

参数速查

常见问题

错误排查