查询
获取指定订单
接口描述:
接口地址:/{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 |