使用指南 · FAQ
188Pay 常见问题
商户对接中最常见的问题解答，快速找到您需要的答案
快速开始
只需 3 步：
1. 注册商户账号并登录
2. 在「钱包管理」添加您的区块链收款地址，配置回调 URL
3. 在「API 密钥」获取商户 ID 和密钥，配置到您的系统中
详细步骤请参考 GitHub 上的 API 对接文档。
所有支持易支付 (EPay) 协议的系统都可以直接对接，包括但不限于：
• 独角数卡
• V2Board
• SSPanel
• WHMCS
• 风铃发卡
• ZFAKA
• 鲸发卡
自研系统可使用标准 JSON API 或 EPay 协议对接。
在独角数卡后台 → 支付配置 → 添加支付方式 → 选择「易支付」：
• 商户 KEY（网关地址）：填写 API 密钥页面的「API 提交地址」（以 /submit.php 结尾）
• 商户 ID：在 API 密钥页面获取
• 商户密钥：在 API 密钥页面获取
注意：独角数卡的「商户KEY」字段直接作为表单提交地址，必须填完整的 /submit.php 地址，不能只填根域名。
📖 查看独角数卡图文配置教程 →
在 V2Board 后台 → 支付配置 → 添加支付方式 → 选择「易支付」，填入与独角数卡相同的三项信息即可。SSPanel 配置方式类似。
支付相关
目前支持 6 大主流公链：
• TRON — USDT (TRC20)、TRX
• Ethereum — USDT (ERC20)、ETH
• BSC — USDT (BEP20)、BNB
• Polygon — USDT、MATIC
• Bitcoin — BTC
• Solana — USDT (SPL)、SOL
此外还支持支付宝收款，无需加密货币钱包，详见下方问题。
支持。买家通过支付宝扫码付款，无需持有加密货币。
接入方式：
• EPay 协议：将 type 参数设置为 fiat_alipay
• 标准 JSON API：将 paymentMethod 参数设置为 fiat_alipay
• 独角数卡：在支付配置的「支付标识」字段填写 fiat_alipay
需要先在 188pay 商户中心的「Payment」页面开启支付宝收款（填写联系方式后点击启用），平台统一处理收款，无需上传收款码或绑定账号。
两个原因：
1. 汇率换算：系统会根据配置的汇率将订单金额（如 CNY）换算为加密货币数量
2. 金额防碰撞：同一钱包在同一时段如果有多笔相同金额的待支付订单，系统会自动在金额上做微调（+0.01 递增），以确保每笔订单的链上转账金额唯一，便于自动匹配
订单创建后 30 分钟内未检测到链上支付将自动过期。过期后用户需要重新发起支付。
在添加钱包时可以设置系统币种（CNY/USD/USDT）和汇率：
• 如系统币种为 CNY，汇率设为 6.38，则 100 CNY 的订单实际支付约 15.67 USDT
• 如系统币种为 USDT，则订单金额即为加密货币金额，无需汇率换算
• 留空汇率则使用系统默认汇率
订单折扣可以对用户实际支付金额打折。例如设置 95%，则 100 元的订单用户只需支付 95 元对应的加密货币。常用于促销或手续费补贴。
回调通知
请依次检查：
1. 回调地址是否可外网访问（不能是 localhost 或内网地址）
2. 回调接口是否返回 HTTP 200 状态码
3. 响应内容是否为纯文本 "success" 或 "ok"（不能是 HTML 页面）
4. 服务器是否有防火墙或 WAF 拦截了 POST 请求
可在「回调记录」页面查看详细错误信息，或使用「测试回调」功能验证连通性。
188Pay 的回调请求携带以下 HTTP 头信息，您可以据此配置白名单：
• User-Agent: 188Pay-Webhook/1.0
• X-Webhook-Source: 188pay
• X-Webhook-Id: 通知唯一标识
• Content-Type: application/json
如果您的服务器使用了 Cloudflare、宝塔面板、Nginx WAF 等防火墙，请按以下方式处理：
1. Cloudflare：在「安全」→「WAF」→「自定义规则」中添加放行规则，匹配 User-Agent 包含 "188Pay-Webhook" 的请求
2. 宝塔面板：在防火墙白名单中放行 User-Agent 为 "188Pay-Webhook/1.0" 的 POST 请求
3. Nginx：在回调路径的 location 中关闭速率限制或添加 User-Agent 白名单
也可以将回调接口路径加入防火墙白名单，例如放行 POST /callback 路径。
是的，系统会按照以下时间间隔自动重试，共最多 6 次：
15 秒 → 1 分钟 → 5 分钟 → 10 分钟 → 30 分钟 → 60 分钟
全部失败后可在回调记录页面手动重发。
推荐使用「集成测试」页面进行完整的 E2E 测试：
1. 创建测试订单
2. 点击「模拟支付」
3. 查看回调通知是否成功到达
也可以在「回调」页面使用「测试回调」功能直接发送测试数据。
请检查：
1. 密钥是否正确（在 API 密钥页面查看）
2. 签名参数是否按 ASCII 排序
3. 空值参数是否已排除
4. 拼接格式是否为 key=value& 格式
5. 最后是否追加了 &secret_key=你的密钥
6. MD5 结果是否转为小写
详见「开发者文档」页面的签名算法说明和代码示例。
账户与安全
可以。您可以添加多个不同链、不同币种的钱包，每个钱包可以独立配置回调地址、汇率和折扣。系统会自动轮询选择可用钱包。建议给每个钱包设置标签以便区分。
188Pay 不托管任何资金，所有支付直接到达您自己的钱包地址。系统只负责监控链上交易并通知您的系统。您的密钥仅用于签名验证，请妥善保管不要泄露。