协议规则
本系统仅提供 OKX USDT 收款，所有下单请求的 type 必须固定为 usdt。
请求数据格式：application/x-www-form-urlencoded
返回数据格式：页面跳转或 JSON（以接口说明为准）
签名算法：MD5；字符编码：UTF-8
submit.php 页面下单
适用于浏览器通过表单提交后跳转到 USDT 订单页面。
URL：https://pay.usdtt.top/submit.php
请求方式：POST（推荐）或 GET
| 字段 | 必填 | 示例 | 说明 |
|---|---|---|---|
| pid | 是 | 1001 | 商户 ID |
| type | 是 | usdt | 固定填写 usdt |
| out_trade_no | 是 | ORDER_202601010001 | 商户订单号，商户系统内唯一 |
| notify_url | 是 | https://merchant.example/notify | 服务器异步通知地址 |
| return_url | 是 | https://merchant.example/return | 页面返回地址 |
| name | 是 | 示例订单 | 订单名称，最长 127 字节 |
| money | 是 | 100.00 | 订单计价金额，最多两位小数；系统按首次汇率换算并冻结 USDT 金额 |
| param | 否 | order-source | 业务扩展参数，通知时原样返回 |
| sign | 是 | {签名结果} | 按本文 MD5 规则生成 |
| sign_type | 是 | MD5 | 固定填写 MD5 |
mapi.php 接口下单
适用于商户服务器创建 USDT 订单，成功后返回订单页面地址。
URL：https://pay.usdtt.top/mapi.php
请求方式：POST
| 字段 | 必填 | 示例 | 说明 |
|---|---|---|---|
| pid | 是 | 1001 | 商户 ID |
| type | 是 | usdt | 固定填写 usdt |
| out_trade_no | 是 | ORDER_202601010001 | 商户订单号，商户系统内唯一 |
| notify_url | 是 | https://merchant.example/notify | 服务器异步通知地址 |
| return_url | 否 | https://merchant.example/return | 页面返回地址 |
| name | 是 | 示例订单 | 订单名称，最长 127 字节 |
| money | 是 | 100.00 | 订单计价金额，最多两位小数 |
| clientip | 是 | 192.0.2.10 | 发起请求的用户 IP |
| device | 否 | pc | 仅支持 pc、mobile、jump，默认 pc |
| param | 否 | order-source | 业务扩展参数，通知时原样返回 |
| sign | 是 | {签名结果} | 按本文 MD5 规则生成 |
| sign_type | 是 | MD5 | 固定填写 MD5 |
成功返回示例：
{
"code": 1,
"msg": "success",
"trade_no": "2026010100010001",
"payurl": "https://pay.usdtt.top/pay/submit/2026010100010001/"
}payurl 为本次 USDT 订单页面地址。
设备类型
| 调用值 | 说明 |
|---|---|
| pc | 电脑浏览器 |
| mobile | 手机浏览器 |
| jump | 仅返回订单页面地址 |
支付结果通知
系统在确认 OKX 内部转账或 TRC20 充值到账后，通过 GET 请求通知 notify_url；如设置了 return_url，页面返回时使用同组参数。
| 字段 | 必有 | 示例 | 说明 |
|---|---|---|---|
| pid | 是 | 1001 | 商户 ID |
| trade_no | 是 | 2026010100010001 | 系统订单号 |
| out_trade_no | 是 | ORDER_202601010001 | 商户订单号 |
| type | 是 | usdt | 固定为 usdt |
| name | 是 | 示例订单 | 订单名称 |
| money | 是 | 100.00 | 下单时提交的计价金额 |
| trade_status | 是 | TRADE_SUCCESS | 仅 TRADE_SUCCESS 表示成功 |
| param | 否 | order-source | 下单时提交的扩展参数 |
| sign | 是 | {签名结果} | 通知参数签名 |
| sign_type | 是 | MD5 | 固定为 MD5 |
商户须先验签、核对订单号与金额，并保证订单处理幂等。处理成功后输出纯文本 success；未返回 success 时系统将按策略重试通知。
MD5 签名
- 移除
sign、sign_type以及值为空的参数。 - 按参数名 ASCII 码从小到大排序，并拼接为
a=b&c=d&e=f；参数值不做 URL 编码。 - 在待签名字符串末尾直接拼接商户密钥，再计算 MD5，结果使用小写。
sign = md5(待签名字符串 + {商户密钥})
密钥仅应保存在商户服务器，不得发送到浏览器、日志或公开代码仓库。
api.php：查询商户信息
URL：https://pay.usdtt.top/api.php?act=query&pid={商户ID}&key={商户密钥}
请求方式：GET
| 字段 | 必填 | 说明 |
|---|---|---|
| act | 是 | 固定填写 query |
| pid | 是 | 商户 ID |
| key | 是 | 商户密钥；示例仅使用占位符 |
成功时返回 code、pid、active、money、orders、order_today、order_lastday 等商户与订单统计字段。
api.php：查询单笔订单
URL：https://pay.usdtt.top/api.php?act=order&pid={商户ID}&key={商户密钥}&out_trade_no={商户订单号}
请求方式：GET
| 字段 | 必填 | 说明 |
|---|---|---|
| act | 是 | 固定填写 order |
| pid | 是 | 商户 ID |
| key | 是 | 商户密钥；示例仅使用占位符 |
| trade_no | 二选一 | 系统订单号 |
| out_trade_no | 二选一 | 商户订单号；两者同时传入时以 trade_no 为准 |
成功时返回订单的 trade_no、out_trade_no、api_trade_no、type、money、status、addtime、endtime 等字段。type 固定为 usdt，api_trade_no 用于记录 OKX 到账标识或链上 TXID。
api.php：批量查询订单
URL：https://pay.usdtt.top/api.php?act=orders&pid={商户ID}&key={商户密钥}
请求方式：GET
| 字段 | 必填 | 说明 |
|---|---|---|
| act | 是 | 固定填写 orders |
| pid | 是 | 商户 ID |
| key | 是 | 商户密钥；示例仅使用占位符 |
| limit | 否 | 每页数量，最大 50，默认 20 |
| page | 否 | 页码，默认 1 |
返回 JSON；code=1 表示查询成功，订单列表位于 data 字段。