OKX USDT 私有支付系统

协议规则

本系统仅提供 OKX USDT 收款，所有下单请求的 type 必须固定为 usdt。

请求数据格式：application/x-www-form-urlencoded

返回数据格式：页面跳转或 JSON（以接口说明为准）

签名算法：MD5；字符编码：UTF-8

submit.php 页面下单

适用于浏览器通过表单提交后跳转到 USDT 订单页面。

URL：https://ic.xoxoi.cn/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://ic.xoxoi.cn/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://ic.xoxoi.cn/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://ic.xoxoi.cn/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://ic.xoxoi.cn/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://ic.xoxoi.cn/api.php?act=orders&pid={商户ID}&key={商户密钥}

请求方式：GET

字段	必填	说明
act	是	固定填写 `orders`
pid	是	商户 ID
key	是	商户密钥；示例仅使用占位符
limit	否	每页数量，最大 50，默认 20
page	否	页码，默认 1

返回 JSON；code=1 表示查询成功，订单列表位于 data 字段。