入款查询

接口地址

POST /v1/api/deposit/query

请求

请求参数

变量名	必填	类型	示例值	描述
`mcode`	是	string	`M10086`	商户 ID
`sn`	是	string	`D202608020001`	平台订单号
`tno`	是	string	`T202608020001`	商户订单号
`ts`	是	string	`1785138705251`	请求毫秒时间戳长度13位
`sign`	是	string	`c380be...`	签名值

请求示例

{
  "mcode": "M10086",
  "sn": "D202608020001",
  "tno": "T202608020001",
  "ts": "1785138705251",
  "sign": "9a9cba2119075ff01b2ed2050f52f42d"
}

返回参数

字段名	变量名	类型	描述
状态码	`code`	number	响应码，`0` 表示成功
响应数据	`data`	object	响应数据对象
─ 商户号	`data.mcode`	string	商户 ID
─ 平台订单号	`data.sn`	string	平台订单号
─ 商户订单号	`data.tno`	string	商户订单号
─ 金额	`data.amt`	string	订单金额
─ 手续费	`data.fee`	string	手续费
─ 渠道编码	`data.chnl`	string	渠道编码
─ 订单类型	`data.stp`	string	订单类型/渠道类型
─ 订单状态	`data.sts`	string	订单状态
─ 通知状态	`data.n_sts`	string	异步通知状态
─ 创建时间	`data.ctm`	string	创建时间
─ 签名	`data.sign`	string	返回签名

返回示例

{
  "code": 0,
  "data": {
    "mcode": "M10086",
    "sn": "D202608020001",
    "tno": "T202608020001",
    "amt": "50.00",
    "fee": "1.00",
    "chnl": "cscn_cspb",
    "stp": "cashier",
    "sts": "DS_SUCCESS",
    "n_sts": "NS_SUCCESS",
    "ctm": "2026-08-02T12:00:01+08:00",
    "sign": "xxxx"
  }
}

入款订单状态说明

状态值	说明
`DS_SUBMIT`	提交成功
`DS_PAYING`	支付中
`DS_FAIL`	支付失败
`DS_SUCCESS`	成功
`DS_CLOSE`	关闭