Skip to content

Commit f6b8750

Browse files
TheNorthMemoryTheNorthMemory
committed
U: v3/[combine-transactions|merchant-service]/* 
1 parent f0c0f65 commit f6b8750

13 files changed

Lines changed: 175 additions & 19 deletions

File tree

‎docs/v3/combine-transactions/app.yaml‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
post:
2-
x-last-updated-at: 2025.05.29
2+
x-last-updated-at: 2025.09.02
33
x-role:
44
- 电商平台
55
- 服务商
@@ -160,12 +160,18 @@ post:
160160
example: 6B46824C852FA29AAC3DCE6BFD852E27
161161
time_start:
162162
type: string
163+
format: rfc3339
163164
description: 交易起始时间
164165
example: '2019-12-31T15:59:60+08:00'
165166
time_expire:
166167
type: string
168+
format: rfc3339
167169
description: 交易结束时间
168170
example: '2019-12-31T15:59:60+08:00'
171+
prepay_id:
172+
type: string
173+
description: 预支付交易会话标识
174+
example: wx201410272009395522657a690389285100
169175
notify_url:
170176
type: string
171177
description: 通知地址

‎docs/v3/combine-transactions/out-trade-no/{combine_out_trade_no}.yaml‎

Lines changed: 85 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
get:
2-
x-last-updated-at: 2024.10.22
2+
x-last-updated-at: 2025.09.02
33
x-role:
44
- 电商平台
55
- 服务商
@@ -75,10 +75,21 @@ get:
7575
type: string
7676
description: 交易类型
7777
example: JSAPI
78+
enum:
79+
- NATIVE
80+
- JSAPI
81+
- APP
82+
- MWEB
7883
trade_state:
7984
type: string
8085
description: 交易状态
8186
example: SUCCESS
87+
enum:
88+
- SUCCESS
89+
- REFUND
90+
- NOTPAY
91+
- CLOSED
92+
- PAYERROR
8293
bank_type:
8394
type: string
8495
description: 付款银行
@@ -112,6 +123,79 @@ get:
112123
type: string
113124
description: 用户子标识
114125
example: oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
126+
promotion_detail:
127+
type: array
128+
description: 优惠信息列表
129+
items:
130+
type: object
131+
properties:
132+
coupon_id:
133+
type: string
134+
description: 券ID
135+
name:
136+
type: string
137+
description: 优惠名称
138+
scope:
139+
type: string
140+
description: 优惠范围
141+
enum:
142+
- GLOBAL #全场代金券
143+
- SINGLE #单品优惠
144+
type:
145+
type: string
146+
description: 优惠类型
147+
enum:
148+
- CASH #充值
149+
- NOCASH #预充值
150+
amount:
151+
type: integer
152+
description: 优惠券面额
153+
stock_id:
154+
type: string
155+
description: 活动批次ID
156+
wechatpay_contribute:
157+
type: integer
158+
description: 微信出资
159+
merchant_contribute:
160+
type: integer
161+
description: 商户出资
162+
other_contribute:
163+
type: integer
164+
description: 其他出资
165+
currency:
166+
type: string
167+
description: 优惠币种
168+
example: CNY
169+
goods_detail:
170+
type: array
171+
description: 单品列表
172+
items:
173+
type: object
174+
required:
175+
- goods_id
176+
- quantity
177+
- unit_price
178+
properties:
179+
goods_id:
180+
type: string
181+
description: 商品编码
182+
example: 商品编码
183+
quantity:
184+
type: integer
185+
description: 商品数量
186+
example: 1
187+
unit_price:
188+
type: integer
189+
description: 商品单价
190+
example: 828800
191+
discount_amount:
192+
type: integer
193+
description: 商品优惠金额
194+
example: 1
195+
goods_remark:
196+
type: string
197+
description: 商品备注
198+
example: 商品备注信息
115199
amount:
116200
type: object
117201
description: 订单金额

‎docs/v3/combine-transactions/out-trade-no/{combine_out_trade_no}/close.yaml‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
post:
2-
x-last-updated-at: 2024.10.22
2+
x-last-updated-at: 2025.09.02
33
x-role:
44
- 电商平台
55
- 服务商
@@ -8,7 +8,7 @@ post:
88
- 收付通∙合单
99
- 收付通∙个人收款
1010
summary: 合单关闭订单API
11-
description: 合单支付订单只能使用此合单关单api完成关单。[官方文档](https://pay.weixin.qq.com/docs/merchant/apis/personal-collections/close-order.html) [官方文档](https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/pay/combine/chapter3_4.shtml)
11+
description: 合单支付订单只能使用此合单关单api完成关单。合单支付关单接口不支持关闭部分商品单， 关单的平台商户号、交易单订单号、商品单个数、商品单发起商户号、商品单订单号必须与下单时完全一致。
1212
parameters:
1313
- name: combine_out_trade_no
1414
in: path
@@ -22,6 +22,7 @@ post:
2222
type: object
2323
required:
2424
- combine_appid
25+
- sub_orders
2526
properties:
2627
combine_appid:
2728
type: string

‎docs/v3/merchant-service/complaint-notifications.yaml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
post:
2-
x-last-updated-at: 2024.09.11
2+
x-last-updated-at: 2025.08.28
33
x-role: [直连商户, 服务商, 渠道商]
44
tags:
55
- 风险合规∙消费者投诉
@@ -34,7 +34,7 @@ post:
3434
description: 通知地址
3535
example: https://www.xxx.com/notify
3636
get:
37-
x-last-updated-at: 2024.09.11
37+
x-last-updated-at: 2025.08.28
3838
x-role: [直连商户, 服务商, 渠道商]
3939
tags:
4040
- 风险合规∙消费者投诉
@@ -57,7 +57,7 @@ get:
5757
description: 通知地址
5858
example: https://www.xxx.com/notify
5959
put:
60-
x-last-updated-at: 2024.09.11
60+
x-last-updated-at: 2025.08.28
6161
x-role: [直连商户, 服务商, 渠道商]
6262
tags:
6363
- 风险合规∙消费者投诉
@@ -92,7 +92,7 @@ put:
9292
description: 通知地址
9393
example: https://www.xxx.com/notify
9494
delete:
95-
x-last-updated-at: 2024.09.11
95+
x-last-updated-at: 2025.08.28
9696
x-role: [直连商户, 服务商, 渠道商]
9797
tags:
9898
- 风险合规∙消费者投诉

‎docs/v3/merchant-service/complaints-v2.yaml‎

Lines changed: 24 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
get:
2-
x-last-updated-at: 2024.09.11
2+
x-last-updated-at: 2025.09.02
33
x-role:
44
- 服务商
55
- 渠道商
@@ -66,6 +66,7 @@ get:
6666
example: '200201820200101080076610000'
6767
complaint_time:
6868
type: string
69+
format: rfc3339
6970
description: 投诉时间
7071
example: '2015-05-20T13:29:35.120+08:00'
7172
complaint_detail:
@@ -76,6 +77,10 @@ get:
7677
type: string
7778
description: 投诉单状态
7879
example: PENDING
80+
enum:
81+
- PENDING
82+
- PROCESSING
83+
- PROCESSED
7984
complainted_mchid:
8085
type: string
8186
description: 被诉商户号
@@ -125,6 +130,11 @@ get:
125130
type: string
126131
description: 支付分服务单状态
127132
example: DOING
133+
enum:
134+
- DOING
135+
- REVOKED
136+
- WAITPAY
137+
- DONE
128138
complaint_media_list:
129139
type: array
130140
description: 投诉资料列表
@@ -165,14 +175,23 @@ get:
165175
type: string
166176
description: 问题类型
167177
example: REFUND
178+
enum:
179+
- REFUND
180+
- SERVICE_NOT_WORK
181+
- OTHERS
168182
apply_refund_amount:
169183
type: integer
170184
description: 申请退款金额
171185
example: 10
172186
user_tag_list:
173187
type: array
174188
description: 用户标签列表
175-
example: '[TRUSTED]'
189+
items:
190+
type: string
191+
example: TRUSTED
192+
enum:
193+
- TRUSTED
194+
- HIGH_RISK
176195
additional_info:
177196
type: object
178197
description: 补充信息
@@ -181,18 +200,20 @@ get:
181200
type: string
182201
description: 补充信息类型
183202
example: SHARE_POWER_TYPE
203+
enum:
204+
- SHARE_POWER_TYPE
184205
share_power_info:
185206
type: object
186207
description: 充电宝投诉相关信息
187208
properties:
188209
return_time:
189210
type: string
211+
format: rfc3339
190212
description: 归还时间
191213
example: '2015-05-20T13:29:35+08:00'
192214
return_address_info:
193215
type: object
194216
description: 归还地点信息
195-
required: []
196217
properties:
197218
return_address:
198219
type: string

‎docs/v3/merchant-service/complaints-v2/{complaint_id}.yaml‎

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
get:
2-
x-last-updated-at: 2024.09.11
2+
x-last-updated-at: 2025.08.28
33
x-role:
44
- 服务商
55
- 渠道商
@@ -36,6 +36,7 @@ get:
3636
example: '200201820200101080076610000'
3737
complaint_time:
3838
type: string
39+
format: rfc3339
3940
description: 投诉时间
4041
example: '2015-05-20T13:29:35.120+08:00'
4142
complaint_detail:
@@ -46,6 +47,10 @@ get:
4647
type: string
4748
description: 投诉单状态
4849
example: PENDING
50+
enum:
51+
- PENDING
52+
- PROCESSING
53+
- PROCESSED
4954
complainted_mchid:
5055
type: string
5156
description: 被诉商户号
@@ -139,14 +144,23 @@ get:
139144
type: string
140145
description: 问题类型
141146
example: REFUND
147+
enum:
148+
- REFUND
149+
- SERVICE_NOT_WORK
150+
- OTHERS
142151
apply_refund_amount:
143152
type: integer
144153
description: 申请退款金额
145154
example: 10
146155
user_tag_list:
147156
type: array
148157
description: 用户标签列表
149-
example: '[TRUSTED]'
158+
items:
159+
type: string
160+
example: TRUSTED
161+
enum:
162+
- TRUSTED
163+
- HIGH_RISK
150164
additional_info:
151165
type: object
152166
description: 补充信息
@@ -155,12 +169,15 @@ get:
155169
type: string
156170
description: 补充信息类型
157171
example: SHARE_POWER_TYPE
172+
enum:
173+
- SHARE_POWER_TYPE
158174
share_power_info:
159175
type: object
160176
description: 充电宝投诉相关信息
161177
properties:
162178
return_time:
163179
type: string
180+
format: rfc3339
164181
description: 归还时间
165182
example: '2015-05-20T13:29:35+08:00'
166183
return_address_info:

‎docs/v3/merchant-service/complaints-v2/{complaint_id}/complete.yaml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
post:
2-
x-last-updated-at: 2024.09.11
2+
x-last-updated-at: 2025.09.01
33
x-role:
44
- 服务商
55
tags:

‎docs/v3/merchant-service/complaints-v2/{complaint_id}/negotiation-historys.yaml‎

Lines changed: 26 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
get:
2-
x-last-updated-at: 2024.09.11
2+
x-last-updated-at: 2025.08.28
33
x-role:
44
- 服务商
55
- 渠道商
@@ -79,6 +79,31 @@ get:
7979
type: string
8080
description: 操作类型
8181
example: USER_CREATE_COMPLAINT
82+
enum:
83+
- USER_CREATE_COMPLAINT #用户提交投诉
84+
- USER_CONTINUE_COMPLAINT #用户继续投诉
85+
- USER_RESPONSE #用户留言
86+
- PLATFORM_RESPONSE #平台留言
87+
- MERCHANT_RESPONSE #商户留言
88+
- MERCHANT_CONFIRM_COMPLETE #商户申请结单
89+
- USER_CREATE_COMPLAINT_SYSTEM_MESSAGE #用户提交投诉系统通知
90+
- COMPLAINT_FULL_REFUNDED_SYSTEM_MESSAGE #投诉单发起全额退款系统通知
91+
- USER_CONTINUE_COMPLAINT_SYSTEM_MESSAGE #用户继续投诉系统通知
92+
- USER_REVOKE_COMPLAINT #用户主动撤诉（只存在于历史投诉单的协商历史中）
93+
- USER_COMFIRM_COMPLAINT #用户确认投诉解决（只存在于历史投诉单的协商历史中）
94+
- PLATFORM_HELP_APPLICATION #平台催办
95+
- USER_APPLY_PLATFORM_HELP #用户申请平台协助
96+
- MERCHANT_APPROVE_REFUND #商户同意退款申请
97+
- MERCHANT_REFUSE_RERUND #商户拒绝退款申请, 此时操作内容里展示拒绝原因
98+
- USER_SUBMIT_SATISFACTION #用户提交满意度调查结果,此时操作内容里会展示满意度分数
99+
- SERVICE_ORDER_CANCEL #服务订单已取消
100+
- SERVICE_ORDER_COMPLETE #服务订单已完成
101+
- COMPLAINT_PARTIAL_REFUNDED_SYSTEM_MESSAGE #投诉单发起部分退款系统通知
102+
- COMPLAINT_REFUND_RECEIVED_SYSTEM_MESSAGE #投诉单退款到账系统通知
103+
- COMPLAINT_ENTRUSTED_REFUND_SYSTEM_MESSAGE #投诉单受托退款系统通知
104+
- USER_APPLY_PLATFORM_SERVICE #用户申请平台协助
105+
- USER_CANCEL_PLATFORM_SERVICE #用户取消平台协助
106+
- PLATFORM_SERVICE_FINISHED #客服结束平台协助
82107
operate_details:
83108
type: string
84109
description: 操作内容

‎docs/v3/merchant-service/complaints-v2/{complaint_id}/response.yaml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
post:
2-
x-last-updated-at: 2024.09.11
2+
x-last-updated-at: 2025.09.01
33
x-role:
44
- 服务商
55
tags:

0 commit comments

Comments
 (0)