创建订单

接口地址

https://api.yypay.io/open-api/mchOrder/createOrder

请求方式

POST

请求数据类型

application/json

请求头

sign

签名秘钥:

APPSECRET: 在商户应用端获取签名秘钥(请妥善保管)

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	备注
reqId	商户订单号	body	true	string	保证唯一性
appId	平台应用ID	body	true	string	商户端应用界面获取
mchNumber	平台商户编号	body	true	string	商户端获取的商户编号
orderType	订单类型	body	true	string	枚举值: API_PAYEE(代收), API_PAYER(代付)
chain	链类型	body	true	string	网络类型:TRC20(Tron),Ethereum(ERC20)
coin	币对类型	body	true	string	参考对应链的币对信息
amount	订单金额	body	true	string
toAddr	收款地址	body	false	string	代收不传
remark	备注	body	true	string	备注
expireTs	超时时间(秒)	body	true	string	取值区间 [600,1200]
timestamp	时间戳(毫秒)	body	true	string	请求时的时间戳，服务端验证不能超过60s
nonce	随机字符串	body	true	string	32位字符串
lang	语言	body	true	string	zh_cn
sign	签名	header	true	string	参数拼接成字符串使用appSecret签名的结果

参数示例

{
    "amount": 0.02,
    "appId": "baf2d7e716f25a26",
    "chain": "Ethereum(ERC20)",
    "coin": "ETH",
    "expireTs": 1200, // 订单20分钟过期
    "lang": "zh_cn",
    "mchNumber": "2020212330001336",
    "nonce": "tT7RfHjuM0CdGiCAJpHOnHT3NnC1oWbr",
    "orderType": "API_PAYEE",
    "remark": "remark",
    "reqId": "10850029",
    "timestamp": 1749172965057
}

响应参数:

参数名称	参数说明	类型	备注
code	状态码,0成功 500 失败	integer(int32)	integer(int32)
data	数据对象
reqId	商户订单号	string
orderId	平台订单ID	string
orderType	订单类型	string
paymentUrl	支付地址	string	代付不返回
msg	返回消息	string
success	是否成功	boolean

响应示例

{
  "code": 0,
  "data": {
    "reqId": "11854236249",
    "orderId": "P1930801341052092416",
    "orderType": "API_PAYEE",
    "paymentUrl": "https://yypay.io/payment/P1930801341052092416"
  },
  "msg": "",
  "success": true
}