支持 TRON / Ethereum / BSC / Polygon / Bitcoin / Solana，接受 USDT、ETH、BNB、BTC、SOL 等主流加密货币。资金直达您自己的钱包，无中间商。

• 直接到账 - 收款直达您自己的钱包地址，无资金池，无中间商
• 多链支持 - TRON、Ethereum、BSC、Polygon、Bitcoin、Solana 六大主流公链
• 兼容易支付 - 原生兼容 EPay 协议，独角数卡 / V2Board / SSPanel 等系统可直接对接
• 5 分钟接入 - 注册 → 添加钱包 → 配置回调，三步完成
• 自动汇率 - 支持 CNY / USD / USDT 多币种计价，系统自动换算
• 回调保障 - 支付成功后自动回调，失败自动重试（最多 6 次）

• 快速开始
• 支持平台
• EPay 接口（推荐）
  • 创建订单
  • 回调通知
  • 签名算法
• 标准 JSON 接口
  • 创建订单
  • 查询订单
  • 回调通知
• 回调验证示例
• 重试策略
• 常见问题
• 联系我们

前往 188Pay 商户平台 注册账号。

登录后进入 钱包管理，添加您的区块链钱包地址：

进入 API 密钥 页面，获取：

• 商户 ID (pid) - 用于创建订单时标识身份
• 密钥 (Secret Key) - 用于签名验证，请妥善保管

根据您的平台选择对接方式：

• 独角数卡 / V2Board / SSPanel 等：使用 EPay 接口，填入网关地址 + 商户ID + 密钥即可
• 自研系统：使用 标准 JSON 接口 或 EPay 接口

以下平台可通过 EPay 协议直接对接，只需在支付配置中填写：

网关地址填写说明：

• 独角数卡：商户KEY 字段填写「API 提交地址」，即 https://你的域名/submit.php
• V2Board / SSPanel：「网关地址」填写 https://你的域名，系统会自动拼接 /submit.php

所有支持易支付 (EPay) 协议的系统都可以直接接入。

兼容易支付 (EPay) 标准协议，适用于独角数卡、V2Board、SSPanel 等平台的直接对接。

请求地址： POST/GET {网关地址}/submit.php

也可以使用 {网关地址}/epay/submit 或 {网关地址}/epay/submit.php。

请求参数：

请求示例（HTML 表单）：

<form action="https://你的域名/submit.php" method="POST">
  <input type="hidden" name="pid" value="YOUR_MERCHANT_ID">
  <input type="hidden" name="type" value="usdt">
  <input type="hidden" name="out_trade_no" value="ORDER_20260220001">
  <input type="hidden" name="money" value="100">
  <input type="hidden" name="notify_url" value="https://你的网站/callback">
  <input type="hidden" name="return_url" value="https://你的网站/return">
  <input type="hidden" name="name" value="商品购买">
  <input type="hidden" name="sign" value="签名值">
  <button type="submit">支付</button>
</form>

成功响应： 302 跳转到收银台页面。

支付成功后，系统向 notify_url 发送 GET 请求，参数通过 URL 查询字符串传递。

回调参数：

回调处理要求：

1. 验证签名（见签名算法）
2. 验证通过后处理业务逻辑（发货、开通服务等）
3. 返回 HTTP 200，响应内容为 success 或 ok
4. 不要返回 HTML 页面或其他内容，否则系统会认为回调失败并重试

EPay 模式签名步骤：

第一步：构造签名字符串

将参与签名的参数按参数名 ASCII 码从小到大排序，拼接为 key=value& 格式：

注意：sign 和 sign_type 不参与签名，参数值为空的不参与签名。

money=100&notify_url=https://你的网站/callback&out_trade_no=ORDER_001&pid=YOUR_PID&type=usdt

第二步：拼接密钥并 MD5

在拼接字符串末尾直接追加密钥（无任何分隔符），然后 MD5 取小写：

sign = MD5("money=100&notify_url=https://你的网站/callback&out_trade_no=ORDER_001&pid=YOUR_PID&type=usdt" + "YOUR_SECRET_KEY")

PHP 签名示例：

<?php
// EPay 签名生成
function epaySign($params, $secretKey) {
    // 移除 sign 和 sign_type
    unset($params['sign'], $params['sign_type']);

    // 移除空值参数
    $params = array_filter($params, function($v) { return $v !== ''; });

    // 按 ASCII 排序
    ksort($params);

    // 拼接为 key=value& 格式
    $str = urldecode(http_build_query($params));

    // 直接追加密钥（无分隔符）并 MD5
    return md5($str . $secretKey);
}

适用于自研系统的直接 API 调用。

请求地址： POST {网关地址}/pay/address

Content-Type： application/json

请求参数：

请求示例：

curl -X POST https://你的域名/pay/address \
  -H "Content-Type: application/json" \
  -d '{
    "merchantId": "YOUR_MERCHANT_ID",
    "merchantOrderId": "ORDER_20260220001",
    "amount": 100,
    "coinType": "usdt",
    "notifyUrl": "https://你的网站/callback",
    "sign": "签名值"
  }'

成功响应：

{
  "code": 0,
  "msg": "success",
  "data": {
    "orderId": "20260220143215123456",
    "walletAddress": "TRx1234...abcd",
    "actualAmount": 15.67,
    "expireAt": "2026-02-20T14:52:15.123Z",
    "cashierUrl": "https://你的域名/cashier?id=20260220143215123456"
  }
}

错误响应：

{
  "code": -1,
  "msg": "错误信息"
}

签名算法（标准模式）：

参与签名的参数：merchantId、merchantOrderId、amount、coinType、notifyUrl

签名字符串 = "amount=100&coinType=usdt&merchantId=YOUR_ID&merchantOrderId=ORDER_001&notifyUrl=https://..."
完整字符串 = 签名字符串 + "&key=YOUR_SECRET_KEY"
sign = MD5(完整字符串).toLowerCase()

请求地址： GET {网关地址}/pay/order/{orderId}

无需鉴权，公开接口。

成功响应：

{
  "code": 0,
  "data": {
    "id": "20260220143215123456",
    "status": "CREATED",
    "terminalReason": null,
    "amount": 100,
    "actualAmount": 15.67,
    "coinType": "usdt",
    "walletAddress": "TRx1234...abcd",
    "expireAt": "2026-02-20T14:52:15.123Z",
    "returnUrl": "https://你的网站/return"
  }
}

支付成功后，系统向 notifyUrl 发送 POST 请求（Content-Type: application/json）。

回调参数：

回调验证签名：

将回调参数（不含 sign 和 sign_type）按参数名 ASCII 排序，拼接为 key=value& 格式，末尾追加 &key=你的密钥，MD5 后与 sign 对比。

<?php
// 接收回调数据
$content = file_get_contents('php://input');
$data = json_decode($content, true);

// 取出签名
$receivedSign = $data['sign'];

// 移除不参与签名的字段
unset($data['sign'], $data['sign_type']);

// 移除空值
$data = array_filter($data, function($v) { return $v !== '' && $v !== null; });

// 按 ASCII 排序
ksort($data);

// 拼接签名字符串
$str = '';
foreach ($data as $k => $v) {
    $str .= $k . '=' . $v . '&';
}
$str = rtrim($str, '&');

// 追加密钥
$str .= '&key=YOUR_SECRET_KEY';

// 验证签名
$sign = md5($str);

if ($receivedSign === $sign) {
    // 签名验证通过
    // TODO: 处理业务逻辑（发货、开通服务等）
    echo 'success';
} else {
    echo 'fail';
}

const crypto = require('crypto');

function verifyCallback(body, secretKey) {
  const { sign, sign_type, ...params } = body;

  // 按 ASCII 排序，过滤空值
  const sortedStr = Object.keys(params)
    .sort()
    .filter(k => params[k] !== '' && params[k] != null)
    .map(k => `${k}=${params[k]}`)
    .join('&');

  // 追加密钥并 MD5
  const computedSign = crypto
    .createHash('md5')
    .update(sortedStr + '&key=' + secretKey)
    .digest('hex');

  return computedSign === sign;
}

// Express 路由示例
app.post('/callback', (req, res) => {
  if (verifyCallback(req.body, 'YOUR_SECRET_KEY')) {
    // TODO: 处理业务逻辑
    res.send('success');
  } else {
    res.send('fail');
  }
});

import hashlib
import json

def verify_callback(body: dict, secret_key: str) -> bool:
    received_sign = body.pop('sign', '')
    body.pop('sign_type', None)

    # 过滤空值，按 ASCII 排序
    filtered = {k: v for k, v in body.items() if v not in ('', None)}
    sorted_str = '&'.join(f'{k}={filtered[k]}' for k in sorted(filtered))

    # 追加密钥并 MD5
    sign_str = sorted_str + '&key=' + secret_key
    computed_sign = hashlib.md5(sign_str.encode()).hexdigest()

    return computed_sign == received_sign

# Flask 路由示例
@app.route('/callback', methods=['POST'])
def callback():
    data = request.get_json()
    if verify_callback(data.copy(), 'YOUR_SECRET_KEY'):
        # TODO: 处理业务逻辑
        return 'success'
    return 'fail'

回调发送失败后，系统按以下间隔自动重试：

共最多重试 6 次。全部失败后可在商户后台手动重发。

在独角数卡后台 → 支付配置 → 添加支付方式 → 选择「易支付」：

• 商户 KEY（网关地址）：填写 API 密钥页面的「API 提交地址」，即 https://你的域名/submit.php
• 商户 ID：在 188Pay 的 API 密钥页面获取
• 商户密钥：在 188Pay 的 API 密钥页面获取

注意：独角数卡的「商户KEY」字段直接作为表单提交地址，必须填写带 /submit.php 的完整地址，不能只填根域名。

在 V2Board 后台 → 支付配置 → 添加支付方式 → 选择「易支付」：

• 网关地址：填写 API 密钥页面的「EPay 网关地址」，即 https://你的域名（V2Board 会自动拼接 /submit.php）
• 商户 ID 和密钥同上

ZFAKA 需要安装专用插件，详见 ZFAKA 188Pay 插件安装教程。安装后在后台 → 支付设置 → 188Pay USDT 中配置商户ID、密钥和网关地址即可。

1. 确认回调地址可以外网访问
2. 确认回调接口返回 success 或 ok（纯文本，非 HTML 页面）
3. 在商户后台「回调记录」中查看详细的错误信息
4. 使用「测试回调」功能验证回调地址连通性

系统会根据汇率将订单金额（如 CNY）换算为加密货币数量。同时为防止同时段内多笔相同金额的订单混淆，系统会自动在金额上做微调（+0.01 递增）。

订单创建后 30 分钟内未支付将自动过期。

目前支持 TRON、Ethereum、BSC (BNB Smart Chain)、Polygon、Bitcoin、Solana 六大主流公链。

• 官网：188pay.top
• 商户平台：www.188pay.top
• Telegram：@token188
• 频道：@token188pay
• 公开群：加入公开群

BSD - Copyright (c) 2018-present, 188Pay Foundation. All rights reserved.