入款确认

按账户付款等场景，需要用户回填付款回单/凭证等场景。如果使用上游柜台，则可以不用处理该API。

接口地址

POST /v1/api/deposit/confirm

请求

请求参数

变量名	必填	类型	示例值	描述
`mcode`	是	string	`M10086`	商户 ID
`sn`	是	string	`D202608020001`	平台（我方）订单号
`ref`	是	string	`1234567`	回传跟踪码（一般都不会很长。这里限制10位长度）
`ts`	是	string	`1785138705251`	请求毫秒时间戳长度13位
`sign`	是	string	`c380be...`	签名值

请求示例

{
  "mcode": "M10086",
  "sn": "D202608020001",
  "ref": "1234567",
  "ts": "1785138705251",
  "sign": "8jPS6eaid00qyRtJoMt4kE0ZFIv8vL6xauAbQmY27HA"
}

返回参数

字段名	变量名	类型	描述
状态码	`code`	number	响应码，`0` 表示成功
响应数据	`data`	object	响应数据对象
─ 商户号	`data.mcode`	string	商户 ID
─ 平台订单号	`data.sn`	string	平台订单号
─ 商户订单号	`data.tno`	string	商户订单号
─ 订单状态	`data.sts`	string	订单状态
─ Ref数据	`data.ref`	string	Ref数据
─ 信息	`data.msg`	string	信息
─ 附加数据	`data.data`	object	附加数据。不一定有
─ 签名	`data.sign`	string	返回签名

返回示例

{
  "code": 0,
  "data": {
    "mcode": "M10086",
    "sn": "D202608020001",
    "tno": "T202608020001",
    "sts": "DS_SUCCESS",
    "data": {
      "ref": "REF202608020001"
    },
    "sign": "xxxx"
  }
}

说明

订单已回传过 ref（已确认）时，直接返回信息 已经回传确认，不会再次调上游确认。
ref 为商户回传的跟踪码，上游确认成功后同步写入订单。