图文配置教程 · 3步完成

188Pay 独角数卡 接入指南

找到独角已有的易支付配置,直接修改商户信息即可
无需新建,无需安装插件,款项直达你的 USDT 钱包

独角数卡 1.x / 2.x
路由 /pay/yipay
协议 EPay 易支付
支持 USDT-TRC20 · TRX · 支付宝
⚠️
注意 · 图示仅供参考
本教程中的界面截图为示意图,展示的是配置流程的大概位置与步骤。 由于独角数卡版本迭代,实际界面样式、字段名称或菜单位置可能与图示有所不同,请以你实际使用的版本为准。 如遇到差异或配置问题,欢迎联系 Telegram @token188 获取支持。
📋

开始前准备

00
准备工作
获取 188pay 商户凭证商户ID + 密钥,填写独角时需要用到
API 密钥
① 复制 商户 ID → 填入独角「商户 ID」字段
620f22b6-56a8-4ac8-a5ff-a257bcb1d84b
② 复制 密钥 → 填入独角「商户密钥」字段
••••••••••••••••••••••••••••••••••
③ 复制 网关地址 → 填入独角「商户 KEY」字段
EPay 网关(独角推荐填此项)
https://api2.188pay.top/submit.php
备用网关(若上方不行可尝试)
https://api2.188pay.top
两个地址都可以尝试,不同系统适配不同,如遇问题联系 @token188
🔗
直接访问 www.188pay.top/dashboard/api-keys 复制 商户ID、密钥和网关地址,Step 03 填写独角配置时需要用到。两个网关地址都可以尝试,不同系统可能适配不同的格式。
01
第一步
进入「支付配置」左侧菜单 → 配置 → 支付配置
🔒your-shop.com/admin/payment
📊 主页
🔧 配置
支付配置 ← 点这里
🌙
Administrator
支付配置
#名称类型商户号密钥/接口地址支付路由
7Paysapi 微信 跳转商户号密钥 /pay/paysapi
14188pay 跳转eb763422-3cbe-4040-a...api2.188pay.top/submit.php /pay/yipay
02
第二步
找到易支付配置行名称含「易支付」或路由为 /pay/yipay
🔒your-shop.com/admin/payment
📊 主页
⚙️ 系统
🔧 配置
支付配置
🌙
Administrator
支付配置
🔍 找以下特征之一: ① 名称含 易支付 ② 路由列显示 /pay/yipay
#名称类型商户号密钥/接口地址支付路由
11Payjs 微信扫码 跳转商户号密钥 /pay/payjs
14188pay 跳转eb763422-3cbe...api2.188pay.top/... /pay/yipay
15 特征① 易支付微信 跳转商户号密钥 /pay/yipay 特征②
16 特征① 易支付QQ钱包 跳转商户号密钥 /pay/yipay 特征②
17PayPal 跳转商户号密钥 /pay/paypal
💡
独角的「易支付」系列配置(微信、QQ、支付宝等)都走 /pay/yipay 路由, 选任意一个修改商户信息即可,也可以多个都改成 188pay,分别对应不同支付类型(usdt / trx)。
03
第三步
点击编辑,填入 188pay 配置商户ID、商户KEY(网关)、商户密钥
🔒your-shop.com/admin/payment/14/edit
📊 主页
⚙️ 系统
📈 销售数据
📦 商品管理
🔑 卡密管理
🎁 优惠管理
🔧 配置
邮件模板配置
支付配置
系统设置
邮件测试
🌙
Administrator ● 在线
支付通道 编辑
主页 / 支付通道 / 14 / 编辑
≡ 列表
👁 查看
编辑
ID
14
* 支付名称
188pay
* 商户 ID
eb763422-3cbe-4040-ad02-d7db175f1fc4 ← 商户ID填这里
商户 KEY
* 商户密钥
返回
✓ 保存
① 商户 ID
填入 188pay 的商户ID(pid),从 API密钥页面复制
② 商户 KEY
填入https://api2.188pay.top/submit.php(支付网关,从 API密钥页面复制)
③ 商户密钥
填入 188pay 的商户密钥,从 API密钥页面复制
保存后开启启用开关,用户下单即可看到 188pay USDT 支付选项。如果支付不通,可尝试将「商户 KEY」改为 https://api2.188pay.top(系统会自动拼接 /submit.php),或联系 @token188 获取帮助。

参数速查

名称(可自定义)
188pay USDT
支付路由(不要改)
/pay/yipay
商户 ID(pid)
从 188pay 商户中心复制
商户密钥(key)
从 188pay 商户中心复制
商户 KEY(网关地址) — 两个都可尝试,不同系统适配不同
独角推荐 https://api2.188pay.top/submit.php
备用 https://api2.188pay.top (系统自动拼 /submit.php)

常见问题

❓ 有很多易支付行,改哪一个?
改任意一个即可,建议直接改名字里有「易支付」或路由是 /pay/yipay 的第一行。如果要同时接 USDT 和 TRX,可以分别改两行,商户KEY(网关)相同、商户ID与商户密钥相同,type 参数会自动传递。
❓ 如何同时接支付宝收款?
在独角支付配置里新增一条易支付配置(路由仍填 /pay/yipay),商户ID、商户密钥、网关地址与加密收款配置相同,只需将「支付标识」填写 fiat_alipay,如下图所示:
🔒your-shop.com/admin/payment/edit
📊 主页
🔧 配置
支付配置
Administrator
新增支付宝配置
* 商户 ID
eb763422-3cbe-4040-ad02-d7db175f1fc4
商户 KEY
https://api2.188pay.top/submit.php
* 商户密钥
hES9NhwspahJdOx6iiNbYRkoKaQgITnu
* 支付标识
fiat_alipay
← 填这个
* 支付场景
* 支付处理路由
/pay/yipay
✓ 提交
💡 提示:支付宝收款需先在 188pay 商户中心的「Payment」页面开启支付宝收款(填写联系方式后点击启用),否则下单时会提示通道不可用。
❓ 改完后用户看到的是旧名字,怎么改?
在编辑表单最上面的「支付名称」字段改为你想显示的名字(如 USDT 支付 / 188pay),这是前台用户看到的支付方式名称。
❓ 旧版独角自定义插件还能用吗?
旧插件走私有协议(字段名不兼容),不推荐继续使用。独角内置的易支付协议完全兼容 188pay,直接修改现有配置即可,无需任何插件。

错误排查

! 常见错误排查:
  • 网关地址填错:请确保包含 https://,推荐填完整路径 https://api2.188pay.top/submit.php,不要漏掉 /submit.php
  • 签名错误:请检查商户 ID 和商户密钥是否复制完整,粘贴时不要包含多余的空格或换行符。
  • 支付类型未生效:独角在创建订单时会自动传递「支付标识」字段的值(如 type=usdttype=trxtype=fiat_alipay),如收款地址/通道未配置或未启用,订单会报错。请先在 188pay 商户中心确认对应通道已配置并启用。
  • 支付成功但订单未自动完成:检查独角后台的 notify_url 是否可被公网访问,本地开发环境(localhost)无法收到回调,需部署到公网。
仍无法解决?联系 Telegram @token188 获取支持