API 文档

# 3、查询订单

# 查询收款订单

接口说明

通过平台订单号和商户订单号，查询对应的加密收款订单详情及状态。

请求方式

POST

请求 URL

/api/v3/wallet/query/pay

请求 Header

Content-Type: application/json;charset=utf-8
参数名 描述 示例值
access_key 商户后台获取 pFqV75X3
timestamp Unix时间戳13位 1679724896223
nonce UUID V4 794c26b0-d33c-4394-b2bb-c485eca16d9e
sign HMAC-SHA1签名 kAXyh+eerqrefyaF8dyFB0M4FVo=

请求参数（JSON）

{
  "externalOrderId": "402297358314559082",
  "orderId": "OCRYPPAID202307310902391690794159441DOCKER020000000400001108"
}

参数说明

参数名 类型 描述 是否必填
externalOrderId String 商户订单号 是
orderId String 平台生成的订单号 是

响应类型

Content-Type: application/json;charset=utf-8

响应示例

{
  "code": "200",
  "success": true,
  "msg": "成功",
  "msgEn": "SUCCESS",
  "data": [{
    "orderId": "OCRYPPAID202307310902391690794159441DOCKER020000000400001108",
    "cashierId": "OCRYPPAID202307310902391690794159250DOCKER020000000200001107",
    "orderType": 1,
    "orderResourceType": 1,
    "userId": "1663371399710216194",
    "orderStatus": 1,
    "orderTime": 1690794159000,
    "externalOrderId": "402297358314559082",
    "orderAmount": "1",
    "currencyType": "USD",
    "tokenType": "USDT",
    "chainType": "ETH",
    "exchangeRate": "0.983",
    "addressTo": "0xe072c63c1e04f8c6f36133f6629f66778147d5d8",
    "orderTypeCode": "Pay",
    "orderResourceTypeCode": "Crypto",
    "orderStatusCode": "Wait pay"
  }]
}

响应参数说明

参数名 类型 描述
orderId String 平台订单号
cashierId String 收银台 ID
orderType int64 订单类型，枚举值：1 1-收款
orderTypeCode String 订单类型文字描述
orderResourceType int64 所属业务类型，枚举值：1 1- 加密订单
orderResourceTypeCode String 业务类型文字描述
userId String 发起订单的用户 ID
orderTime int64 订单创建时间（时间戳）
externalOrderId String 商户订单号
orderAmount String 订单金额
currencyType String 法币类型（如 USD）
tokenType String 加密币种（如 USDT）
chainType String 加密主链类型（如 ETH）
exchangeRate String 创建订单时的汇率
addressTo String 支付地址（平台生成的收款地址）
orderStatusCode String 状态码描述
orderStatus int64 状态码，枚举值：1、2、4、8、16 详细说明请参考下方订单状态码说明

订单状态码说明

状态码 状态描述 是否终态 说明
1 待支付 否 订单已创建，用户尚未付款；无需处理
2 链上确认中 否 用户在收银台点击“已完成支付”，系统正在检测链上是否到账；无需处理
4 已完成 是 支付成功，系统会触发回调；商户需根据业务逻辑增加余额或完成发货等操作
8 支付金额不匹配 是 用户支付金额 ≠ 应付金额，系统会触发回调；建议按实际支付金额入账
16 超时收款 是 用户支付超时，系统不会再回调；商户如确认收款到账需手动处理
32 未支付（地址释放） 是 用户长时间未支付，地址释放；若后续支付将生成新订单

# 查询代付订单

接口说明

商户通过该接口查询指定的链上代付订单详情，包括订单状态、金额、手续费、链上交易 Hash 等。

请求方式

POST

请求 URL

/api/v3/wallet/query/transfer

请求 Header

Content-Type: application/json;charset=utf-8
参数名 描述 示例值
access_key 商户后台获取 pFqV75X3
timestamp Unix时间戳13位 1679724896223
nonce UUID V4 794c26b0-d33c-4394-b2bb-c485eca16d9e
sign HMAC-SHA1签名 kAXyh+eerqrefyaF8dyFB0M4FVo=

请求参数（JSON）

{
  "externalOrderId": "622257420681202921",
  "orderId": "OCRYPDRAW202307310902401690794160841DOCKER020000000200001109"
}

参数说明

参数名 类型 描述 是否必填
externalOrderId String(64) 商户订单号 是
orderId String 平台生成的订单号 是

响应类型

Header:

Content-Type: application/json;charset=utf-8

响应示例

{
  "code": "200",
  "success": true,
  "msg": "成功",
  "msgEn": "SUCCESS",
  "data": [{
    "orderId": "OCRYPDRAW202307310902401690794160841DOCKER020000000200001109",
    "cashierId": "",
    "orderType": 2,
    "orderResourceType": 1,
    "userId": "1663371399710216194",
    "orderStatus": 1,
    "orderTime": 1690794160000,
    "externalOrderId": "622257420681202921",
    "orderAmount": "1",
    "orderActualAmount": "1.01",
    "orderFee": "0.01",
    "currencyType": "USD",
    "tokenType": "USDT",
    "chainType": "ETH",
    "exchangeRate": "0.983",
    "addressTo": "0xa8666442fA7583F783a169CC9F5449ec660295E8",
    "tradeHash": "0xe9d043c9cbdb96ed7a71c5a0923baabe9e23316b3f1b0a01975bcd6d69b41fa3",
    "orderTypeCode": "Transfer",
    "orderResourceTypeCode": "Crypto",
    "orderStatusCode": "Accepted"
  }]
}

响应参数说明

参数名 类型 描述
orderId String 平台订单号
orderType int64 订单类型（2 = 代付）
orderResourceType int64 所属业务类型（1 = 加密订单）
userId String 发起订单的用户 ID
orderTime int64 订单创建时间（毫秒时间戳）
externalOrderId String 商户自定义订单号
orderAmount String 订单金额（商户预设）
orderActualAmount String 实际扣除金额（包含手续费）
orderFee String 平台手续费金额
currencyType String 法币类型（如 USD）
tokenType String 加密币种（如 USDT）
chainType String 链类型（如 ETH、TRON、BSC）
exchangeRate String 汇率（生成订单时使用）
addressTo String 转账目标地址（用户钱包地址）
tradeHash String 区块链交易哈希值（链上可查）
orderTypeCode String 订单类型描述（如 Transfer）
orderResourceTypeCode String 所属业务类型描述（如 Crypto）
orderStatusCode String 状态码文字描述（如 Accepted）
orderStatus int64 订单状态码，详见下方【状态码定义】

orderStatus 状态码定义

状态码 描述 是否终态 说明
1 已受理 否 订单已提交，等待链上执行
2 已完成 是 转账成功，链上已确认，可通过 hash 查看
4 出款失败 是 转账失败，平台将不再重试
8 待审批 否 风控/权限原因等待人工审核
16 拒绝出款 是 审核被拒，订单取消

← 4、查询余额 →