4.1 批量查询支付单明细
# 4.1 批量查询支付单明细
# 接口URL
{开放平台域名地址}/openApi/open/order/getList
# HTTP请求方式
POST
# 公共参数
| 字段 | 类型 | 是否必填 | 中文意描述 |
|---|---|---|---|
| access_token | String | 是 | 授权访问凭证 |
| timestamp | String | 是 | 毫秒级时间戳 防止重复攻击 |
| sign | String | 是 | 签名 |
| version | String | 否 | 业务接口版本号，如1.0.0 |
# body参数
| 字段 | 类型 | 是否必填 | 中文意描述 |
|---|---|---|---|
| paySnList | Array | 是 | 支付单号集合 单次最多20条 |
# 请求示例
POST /openApi/open/order/getList?access_token=abc×tamp=1597300776947&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1 Content-Type: application/json Cache-Control: no-cache { "paySnList": ["217132502617316312401131698"] }1
2
3
4
5
6
# 返回参数说明
| 字段 | 类型 | 中文意描述 |
|---|---|---|
| code | String | 返回码 |
| data | ResponseData | 相应报文 |
| msg | String | 如果错误，返回错误信息 |
ResponseData：
| 字段 | 类型 | 中文意描述 |
|---|---|---|
| sn | String | 支付单号 |
| channelSn | String | 订单号 |
| channel | Byte | 支付频道 |
| dispatchWay | String | 配送方式 |
| dispatchTime | String | 配送时间 |
| dispatchCost | BigDecimal | 配送费用（单位分） |
| serviceFee | BigDecimal | 服务费（单位分） |
| status | Byte | 支付状态，1未支付;3支付成功;5取消订单;8支付超时 |
| amount | BigDecimal | 订单总金额（单位分） |
| realAmount | BigDecimal | 实际支付总额（单位分） |
| paidAmount | BigDecimal | 已经支付金额（单位分） |
| startPayTime | String | 开始支付时间 格式 yyyy-MM-dd HH:mm:ss |
| endPayTime | String | 结束支付时间（也就是最终支付成功时间） 格式 yyyy-MM-dd HH:mm:ss |
| expiredAt | String | 订单超时时间 格式 yyyy-MM-dd HH:mm:ss |
| createdAt | String | 订单创建时间 格式 yyyy-MM-dd HH:mm:ss |
| receiver | String | 收货人 |
| userId | Long | 用户id |
| bfdAccount | String | 百福得帐号 |
| goodsList | OrderItemResponseVO | 商品明细 |
| payWayList | OrderPayWayResponseVO | 支付流水明细 |
| refundOrderList | OrderReturnResponseVO | 退款单明细（一个支付单可能有多个退款单，一个退款单可能有多个退款流水明细） |
OrderItemResponseVO：
| 字段 | 类型 | 中文意描述 |
|---|---|---|
| goodsId | Integer | 商品ID |
| name | String | 商品名称 |
| num | Integer | 商品数量 |
| price | BigDecimal | 商品单价 |
| logo | String | 商品logo |
OrderPayResponseVO：
| 字段 | 类型 | 中文意描述 |
|---|---|---|
| payWay | String | 支付方式：1东福点卡，2东福次卡；3支付宝，7支付宝WAP，15支付宝web，16支付宝wap，18支付宝APP；4微信扫码，6微信JSAPI，8企业微信JSAPI，14微信小程序支付，17微信H5，19微信APP；5银联；25企业代付（福豆）；23三方积分；27客户收银台 |
| cardId | String | 卡号/账户ID/三方支付流水号 |
| startPayTime | String | 开始支付时间 格式 yyyy-MM-dd HH:mm:ss |
| endPayTime | String | 结束支付时间 格式 yyyy-MM-dd HH:mm:ss |
| amount | BigDecimal | 支付金额，单位：次卡-次，点卡-点，三方支付-人民币分，三方/企业积分-积分数量 |
| deduction | BigDecimal | 抵扣金额（单位分） |
| status | Byte | 状态: 1未支付成功，2支付成功 |
| dispatchCost | BigDecimal | 支付的运费（单位分） |
| serviceFee | BigDecimal | 支付的服务费（单位分） |
OrderReturnResponseVO：
| 字段 | 类型 | 中文意描述 |
|---|---|---|
| sn | String | 退款单号 |
| payOrderSn | String | 支付单号 |
| payOrderAmount | BigDecimal | 支付单金额（单位分） |
| refundAmount | BigDecimal | 退款金额（单位分） |
| refundReason | String | 退款原因 |
| status | Byte | 退款状态 |
| createdAt | String | 创建时间 格式 yyyy-MM-dd HH:mm:ss |
| updatedAt | String | 退款时间 格式 yyyy-MM-dd HH:mm:ss |
| refundWayList | OrderRefundWayResponseVO | 退款流水明细 |
OrderRefundWayResponseVO：
| 字段 | 类型 | 中文意描述 |
|---|---|---|
| refundOrderSn | String | 退款单号 |
| payWay | String | 支付方式：1东福点卡，2东福次卡；3支付宝，7支付宝WAP，15支付宝web，16支付宝wap，18支付宝APP；4微信扫码，6微信JSAPI，8企业微信JSAPI，14微信小程序支付，17微信H5，19微信APP；5银联；25企业代付（福豆）；23三方积分；27客户收银台 |
| refundAccount | String | 卡号/账户ID/三方支付流水号 |
| refundVal | BigDecimal | 支付金额，单位：次卡-次，点卡-点，三方支付-人民币分，三方/企业积分-积分数量 |
| deduction | BigDecimal | 抵扣金额（单位分） |
| status | Byte | 状态：1未成功，2已成功 |
| createdAt | String | 创建时间 格式 yyyy-MM-dd HH:mm:ss |
| refundTime | String | 退款成功时间 格式 yyyy-MM-dd HH:mm:ss |
# 返回示例
success:
{
"code": "0",
"data": [
{
"sn": "217132502617316312401131698",
"channelSn": "21240416145100175435",
"channel": 0,
"dispatchWay": "2",
"dispatchTime": "工作日／周末／假日均可 ",
"dispatchCost": 0,
"serviceFee": 0,
"status": 3,
"amount": 150190,
"realAmount": 150190,
"paidAmount": 150190,
"startPayTime": "2024-04-16 14:51:02",
"endPayTime": "2024-04-16 14:52:03",
"expiredAt": "2024-04-16 15:21:01",
"createdAt": "2024-04-16 14:51:02",
"receiver": "17602110454",
"userId": 63124011,
"bfdUserId": "13900003010",
"bfdAccount": "13900003010",
"goodsList": [
{
"goodsId": 2244725,
"name": "【2022必测】普通商品多规格",
"price": 500,
"num": 9,
"logo": "https://scm-goods-dev.oss-cn-shanghai.aliyuncs.com/merchantSpu/picture/9c63ce0c7b514359b255d580d9e47b05.jpg",
"virtual": null
},
{
"goodsId": 142012,
"name": "CP正大食品 盐水鸭500g",
"price": 5890,
"num": 1,
"logo": "https://image.dongfangfuli.com/2019/10/16/6cf2a23a0755eaeddae5a9939570a5f019f0c7dcd2338faaf0626dcf0737765c.jpg",
"virtual": null
},
{
"goodsId": 141940,
"name": "日本 TOFFY 复古单层烤箱",
"price": 69900,
"num": 2,
"logo": "https://image.dongfangfuli.com/2019/10/14/d6ac390c9677e215abbc714b60ed11b97a01c52b1f8379028e69afb422494c86.jpg",
"virtual": null
}
],
"payWayList": [
{
"payWay": 23,
"cardId": "bfd17132502688855332438828",
"startPayTime": "2024-04-16 14:51:09",
"endPayTime": "2024-04-16 14:51:09",
"amount": 150000,
"deduction": 150000,
"status": 2,
"dispatchCost": null,
"serviceFee": null
},
{
"payWay": 6,
"cardId": "4200002195202404163221496242",
"startPayTime": "2024-04-16 14:51:58",
"endPayTime": "2024-04-16 14:52:03",
"amount": 190,
"deduction": 190,
"status": 2,
"dispatchCost": null,
"serviceFee": null
}
],
"refundOrderList": [
{
"sn": "317132503736916312401179168",
"payOrderSn": "217132502617316312401131698",
"payOrderAmount": 150190,
"refundAmount": 4500,
"refundReason": "主动取消",
"status": 5,
"createdAt": "2024-04-16 14:52:54",
"updatedAt": "2024-04-16 14:53:14",
"refundWayList": [
{
"refundOrderSn": "317132503736916312401179168",
"payWay": 6,
"refundAccount": "4200002195202404163221496242",
"refundVal": 190,
"deduction": 190,
"status": 2,
"createdAt": "2024-04-16 14:52:54",
"refundTime": "2024-04-16 14:53:15"
},
{
"refundOrderSn": "317132503736916312401179168",
"payWay": 23,
"refundAccount": "bfd17132502688855332438828",
"refundVal": 4310,
"deduction": 4310,
"status": 2,
"createdAt": "2024-04-16 14:52:54",
"refundTime": "2024-04-16 14:52:55"
}
]
},
{
"sn": "317132503778006312401185411",
"payOrderSn": "217132502617316312401131698",
"payOrderAmount": 150190,
"refundAmount": 5890,
"refundReason": "主动取消",
"status": 5,
"createdAt": "2024-04-16 14:52:58",
"updatedAt": "2024-04-16 14:52:58",
"refundWayList": [
{
"refundOrderSn": "317132503778006312401185411",
"payWay": 23,
"refundAccount": "bfd17132502688855332438828",
"refundVal": 5890,
"deduction": 5890,
"status": 2,
"createdAt": "2024-04-16 14:52:58",
"refundTime": "2024-04-16 14:52:58"
}
]
},
{
"sn": "317132503827646312401148859",
"payOrderSn": "217132502617316312401131698",
"payOrderAmount": 150190,
"refundAmount": 139800,
"refundReason": "主动取消",
"status": 5,
"createdAt": "2024-04-16 14:53:03",
"updatedAt": "2024-04-16 14:53:03",
"refundWayList": [
{
"refundOrderSn": "317132503827646312401148859",
"payWay": 23,
"refundAccount": "bfd17132502688855332438828",
"refundVal": 139800,
"deduction": 139800,
"status": 2,
"createdAt": "2024-04-16 14:53:03",
"refundTime": "2024-04-16 14:53:04"
}
]
}
]
}
],
"msg": "success",
"errMsg": null
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
fail:
{
"code": "10016",
"data": null,
"msg": "签名错误"
}
1
2
3
4
5
2
3
4
5