提交 trxId (/payin/trxId/submit)

接口描述

商户调用此接口提交用户提供的电子钱包交易凭据（trxId），将其绑定并关联到指定的商户订单（merchantOrderNo）。

---

请求信息

• 请求 URL：/payin/trxId/submit
• 请求方式：POST
• Content-Type：application/json; charset=utf-8

---

请求头（HTTP Headers）

参数名	必填	类型	说明
merchantNo	是	String	商户号
sign	是	String	请求 Body 的 RSA 签名

---

请求 Body 参数

参数名称	是否必传	参数类型	示例值	备注
timestamp	是	Long	1772880250000	毫秒时间戳
trxId	是	String	SDIIFKISDL	trxId
merchantOrderNo	是	String	202603070001	商户单号

请求示例

{
  "timestamp": 1772880250000,
  "trxId": "SDIIFKISDL",
  "merchantOrderNo": "202603070001"
}

---

响应参数

1. 成功返回示例

{
  "code": 1,
  "msg": "success",
  "data": {}
}

2. 订单已成功响应示例

{
  "code": 0,
  "msg": "ORDER_FINISH",
  "data": {}
}

3. trxId 已使用响应示例

{
  "code": 0,
  "msg": "TRXID_IS_USED",
  "data": {}
}

4. trxId 未查到响应示例

{
  "code": 0,
  "msg": "TRXID_NOT_EXIST"
}

5. 其他报错响应示例

{
  "code": 0,
  "msg": "错误码表"
}

---

返回参数说明

参数名	必选	类型	说明
code	是	String / Integer	1 成功，0 失败
msg	是	String	消息说明
data	是	Object	业务响应数据对象（无特定数据时返回空对象 {}）
data.merchantNo	是	String	商户号
data.merchantOrderNo	是	String	商户订单号
data.platOrderNo	是	String	平台订单号
data.amount	是	String	金额
data.fee	是	String	手续费
data.expireTime	是	String	过时时间
data.payUrl	是	String	payUrl
data.status	是	String	状态，0 已创建 ，1 过期， 2 失败， 3 成功
data.payAccountNo	否	String	付款账户
data.trxId	否	String	由电子钱包系统生成的唯一交易标识，用于标识本次交易