查询

获取指定订单

接口描述:

接口地址:/{context}/bill/{SN}

请求方式GET

consumes:``

produces:["*/*"]

请求参数

参数名称 参数说明 in 是否必须 数据类型 schema
SN 订单号/调用方流水号/支付渠道流水号 path true string

响应示例:

{
  "amount": 0,
  "bankSN": "",
  "batch": "",
  "callerSN": "",
  "canceled": 0,
  "createTime": "",
  "currency": "",
  "expiryTime": "",
  "id": 0,
  "notes": "",
  "organId": 0,
  "originalSN": "",
  "payTime": "",
  "payType": "",
  "payload": {
    "key": "value"
  },
  "qrCord": "",
  "refund": 0,
  "remark": "",
  "sn": "",
  "terminalSN": "",
  "type": "",
  "overdue": 0,
  "userId": 0
}

响应参数:

参数名称 参数说明 类型 schema
amount 金额,单位:元 number
bankSN 支付渠道流水号,如:各个银行流水号或业务主键 string
batch 批次/账期 string
callerSN 调用方流水号,如:HIS 流水号 string
canceled 撤单金额,单位:元 number
createTime 创建时间 string(date-time) string(date-time)
currency 货币 string
expiryTime 失效时间 string(date-time) string(date-time)
id 标识,修改时必须 integer(int32) integer(int32)
notes 交易标题、描述或说明 string
organId 所属机构标识 integer(int32) integer(int32)
organName 所属机构名称 string
originalSN 原单流水号,退费时记录原支付流水号 string
payTime 支付时间 string(date-time) string(date-time)
payType 支付方式,参见:约定字典 string
payload 负载的其它业务数据, JSON 格式 object
qrCord 支付码 string
refund 退费金额,单位:元 number
remark 备注/描述 string
sn string
state 状态 integer(int32) integer(int32)
overdue 是否超期,超期指超过该笔订单最长可退款时间,1:是,0否,默认为0 integer(int32) integer(int32)
terminalSN 终端流水号,如:POS 机流水号/凭证号(建行 OCX 返回) string
type 订单类型,0:支付;1:退费;2:撤单;3:转账,可用值:支付单,退费单,撤销单,转账单 string
userId 创建人标识,关联账号标识 integer(int32) integer(int32)
userName 创建人名称 string

响应状态:

状态码 说明 schema
200 OK 支付单
401 Unauthorized
403 Forbidden
404 Not Found

根据第三方流水号查询订单

接口描述:

接口地址:/{context}/bill/callersn/{callerSN}

请求方式GET

consumes:``

produces:["*/*"]

请求参数

参数名称 参数说明 in 是否必须 数据类型 schema
callerSN 调用方流水号,如:HIS 流水号 path true string
billType 订单类型,枚举:支付单, 退费单, 撤销单, 转账单 query true string

响应示例:

{
  "amount": 0,
  "bankSN": "",
  "batch": "",
  "callerSN": "",
  "canceled": 0,
  "createTime": "",
  "currency": "",
  "expiryTime": "",
  "id": 0,
  "notes": "",
  "organId": 0,
  "originalSN": "",
  "payTime": "",
  "payType": "",
  "payload": {
    "key": "value"
  },
  "qrCord": "",
  "refund": 0,
  "remark": "",
  "sn": "",
  "terminalSN": "",
  "type": "",
  "overdue": 0,
  "userId": 0
}

响应参数:

参数名称 参数说明 类型 schema
amount 金额,单位:元 number
bankSN 支付渠道流水号,如:各个银行流水号或业务主键 string
batch 批次/账期 string
callerSN 调用方流水号,如:HIS 流水号 string
canceled 撤单金额,单位:元 number
createTime 创建时间 string(date-time) string(date-time)
currency 货币 string
expiryTime 失效时间 string(date-time) string(date-time)
id 标识,修改时必须 integer(int32) integer(int32)
notes 交易标题、描述或说明 string
organId 所属机构标识 integer(int32) integer(int32)
organName 所属机构名称 string
originalSN 原单流水号,退费时记录原支付流水号 string
payTime 支付时间 string(date-time) string(date-time)
payType 支付方式,参见:约定字典 string
payload 负载的其它业务数据, JSON 格式 object
qrCord 支付码 string
refund 退费金额,单位:元 number
remark 备注/描述 string
sn string
state 状态 integer(int32) integer(int32)
overdue 是否超期,超期指超过该笔订单最长可退款时间,1:是,0否,默认为0 integer(int32) integer(int32)
terminalSN 终端流水号,如:POS 机流水号/凭证号(建行 OCX 返回) string
type 订单类型,0:支付;1:退费;2:撤单;3:转账,可用值:支付单,退费单,撤销单,转账单 string
userId 创建人标识,关联账号标识 integer(int32) integer(int32)
userName 创建人名称 string

响应状态:

状态码 说明 schema
200 OK 支付单
401 Unauthorized
403 Forbidden
404 Not Found

分页获取订单

接口描述:

接口地址:/{context}/bill/

请求方式GET

consumes:``

produces:["*/*"]

请求参数

参数名称 参数说明 in 是否必须 数据类型 schema
SN 订单号 query false string
callerSN 调用方流水号 query false string
eDate 结束时间 格式:yyyy-MM-dd HH:mm:ss query false string
orderTypes 订单类型,0:支付;1:退款;2:撤销;3:转账 query false array integer
page 第几页 query false integer
payType 支付类型 query false string
rows 每页几条记录 query false integer
sDate 开始时间 格式:yyyy-MM-dd HH:mm:ss query false string
states 状态集,1:初始化;2:交易中;3:成功;4:失败 query false array integer

响应示例:

{
  "firstPage": true,
  "lastPage": true,
  "list": [
    {
      "amount": 0,
      "bankSN": "",
      "batch": "",
      "callerSN": "",
      "canceled": 0,
      "createTime": "",
      "currency": "",
      "expiryTime": "",
      "id": 0,
      "notes": "",
      "organId": 0,
      "originalSN": "",
      "payTime": "",
      "payType": "",
      "payload": {
        "key": "value"
      },
      "qrCord": "",
      "refund": 0,
      "remark": "",
      "sn": "",
      "terminalSN": "",
      "type": "",
      "overdue": 0,
      "userId": 0
    }
  ],
  "pageNumber": 0,
  "pageSize": 0,
  "totalPage": 0,
  "totalRow": 0
}

响应参数:

参数名称 参数说明 类型 schema
firstPage 是否第一页 boolean
lastPage 是否最后一页 boolean
list 数据集 array 支付单
pageNumber 当前页码 integer(int32) integer(int32)
pageSize 每页记录数 integer(int32) integer(int32)
totalPage 总页数 integer(int32) integer(int32)
totalRow 总记录数 integer(int32) integer(int32)

schema 属性说明

订单

参数名称 参数说明 类型 schema
amount 金额,单位:元 number
bankSN 支付渠道流水号,如:各个银行流水号或业务主键 string
batch 批次/账期 string
callerSN 调用方流水号,如:HIS 流水号 string
canceled 撤单金额,单位:元 number
createTime 创建时间 string(date-time)
currency 货币 string
expiryTime 失效时间 string(date-time)
id 标识,修改时必须 integer(int32)
notes 交易标题、描述或说明 string
organId 所属机构标识 integer(int32)
organName 所属机构名称 string
originalSN 原单流水号,退费时记录原支付流水号 string
payTime 支付时间 string(date-time)
payType 支付方式,参见:约定字典 string
payload 负载的其它业务数据, JSON 格式 object
qrCord 支付码 string
refund 退费金额,单位:元 number
remark 备注/描述 string
sn string
state 状态 integer(int32)
overdue 是否超期,超期指超过该笔订单最长可退款时间,1:是,0否,默认为0 integer(int32) integer(int32)
terminalSN 终端流水号,如:POS 机流水号/凭证号(建行 OCX 返回) string
type 订单类型,0:支付;1:退费;2:撤单;3:转账,可用值:支付单,退费单,撤销单,转账单 string
userId 创建人标识,关联账号标识 integer(int32)
userName 创建人名称 string

响应状态:

状态码 说明 schema
200 OK 分页«支付单»
401 Unauthorized
403 Forbidden
404 Not Found

results matching ""

    No results matching ""