提交订单

在接入链路中的位置

提交法币金额和网络，返回本笔 cryptoAmount 与 payUrl。付款金额以本次 data.cryptoAmount 为准。

POST/api/public/order/apply

请求类型：application/json

请求参数

字段名称	类型	必填	签名	示例	说明
`appId`	string(12-16)	是	是	`k-mch8x2k1p4q9`	APP ID
`merchantOrderNo`	string(5-32)	是	是	`ORD-20260822-0001`	商户订单号，商户侧保证唯一
`network`	string	是	是	`TRC`	网络，见参数查询
`asset`	string	是	是	`USDT`	收款资产，目前TRC 只支持 USDT，见参数查询
`amount`	string	是	是	`10.99`	法币金额
`currency`	string(3)	是	是	`USD`	法币 ISO 代码，取值见参数查询
`notifyUrl`	string	是	是	`https://merchant.example.com/ucashier/notify`	异步通知地址，须可公网访问
`attach`	string	否	否	—	自定义数据，回调时原样返回
`redirectUrl`	string	否	否	`https://merchant.example.com/orders/thank-you`	支付成功后的前端跳转地址
`signature`	string(32)	是	否	`07BA8514788F143D2437E0D6F4C028D0`	数据签名，见签名算法

返回值 data 参数

字段名称	类型	说明
`appId`	string	APP ID
`orderNo`	string	平台订单号
`merchantOrderNo`	string	商户订单号
`exchangeRate`	string	接口返回的汇率信息
`asset`	string	本单资产，见参数查询
`cryptoAmount`	string	本笔最终应付金额，币种见 asset，付款以此字段为准
`status`	string	订单状态，见参数查询
`payUrl`	string	收银台地址

请求示例

{
  "appId": "k-mch8x2k1p4q9",
  "merchantOrderNo": "ORD-20260822-0001",
  "network": "TRC",
  "asset": "USDT",
  "amount": "10.99",
  "currency": "USD",
  "notifyUrl": "https://merchant.example.com/ucashier/notify",
  "redirectUrl": "https://merchant.example.com/orders/thank-you",
  "attach": "custom",
  "signature": "07BA8514788F143D2437E0D6F4C028D0"
}

响应示例

{
  "code": "100000",
  "message": "Success",
  "data": {
    "appId": "k-mch8x2k1p4q9",
    "orderNo": "U260830162530123456",
    "merchantOrderNo": "ORD-20260822-0001",
    "exchangeRate": "1.0000",
    "asset": "USDT",
    "cryptoAmount": "10.99",
    "status": "pending",
    "payUrl": "https://pay.ucashier.ink/#/payment/order?..."
  },
  "requestId": "..."
}