银行流水状态更新

状态机

原始状态	可更新状态
待处理-pending	已作废-obsoleted
已作废-obsoleted	待处理-pending

注意

作废/取消作废接口只支持待处理和已作废之间的变更，否则报错：不允许变更状态xxxx
如果不填biz_key,将更新所有code相同且符合状态机更新状态的流水

单条更新

接口：common/v2/transSerialDeliveries/updateStatus
Method：PUT
数据格式：JSON
接口说明：银行流水更新状态(单条)接口

请求参数

字段名称	字段类型	字段描述	是否必填	长度限制(字节)
bizId	String	业务唯一识别码	是	64
timestamp	long	时间戳	是	13
data.biz_key	String	流水唯一标识	是	64
data.code	String	交易流水号	否	64
data.status	String	状态	是	4

示例

{
  "timestamp": 1647241391000,
  "bizId": "xxx",
  "data": {
    "biz_key": "xxxxxxxxxxxx",
    "code": "xxxxxxxxxx",
    "status": "pending"
  }
}

返回参数

字段名称	字段类型	字段描述
resCode	String	状态码
resMsg	String	描述
bizId	String	业务唯一标识
data.validatorErrors	String	错误信息
data.updated	String	更新数据信息

示例

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "1915125a-f7f3-4449-bf72-a35c725c08ea",
  "data": {
    "validatorErrors": {},
    "updated": "此次请求更新成功了1条数据"
  }
}

批量更新

接口：common/v2/transSerialDeliveries/batchUpdateStatus
Method：PUT
数据格式：JSON
接口说明：银行流水更新状态(批量)接口

请求参数

字段名称	字段类型	字段描述	是否必填	长度限制(字节)
bizId	String	业务唯一识别码	是	64
timestamp	long	时间戳	是	13
data.biz_key	String	流水唯一识别	是	64
data.code	String	交易流水号	否	64
data.status	String	状态	是	4

示例

{
  "timestamp": 1650935852000,
  "bizId": "1915125a-f7f3-4449-bf72-a35c725c08ea",
  "data": [
    {
      "biz_key": "xxxxxxxx",
      "code": "xxxx",
      "status": "obsoleted"
    },
    {
      "biz_key": "xxxxxxxx",
      "code": "xxxx",
      "status": "obsoleted"
    }
  ]
}

返回参数

字段名称	字段类型	字段描述
resCode	String	状态码
resMsg	String	描述
bizId	String	业务唯一标识
data.validatorErrors	String	错误信息
data.updated	String	更新数据信息

示例

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "1915125a-f7f3-4449-bf72-a35c725c08ea",
  "data": {
    "validatorErrors": {},
    "updated": "此次请求更新成功了2条数据"
  }
}

results matching ""

No results matching ""