Skip to content

Commit b27311e

Browse files
U: v3/inspolicymgr/deduct/policies*
1 parent 770c3bb commit b27311e

4 files changed

Lines changed: 275 additions & 14 deletions

File tree

docs/v3/inspolicymgr/deduct/policies.yaml

Lines changed: 96 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,7 @@ post:
2929
- policy_periods
3030
- appid
3131
- openid
32+
- free_insurance
3233
properties:
3334
out_insurance_no:
3435
type: string
@@ -112,9 +113,9 @@ post:
112113
description: 保司保单号
113114
example: Coisihsiaxishishi4hihsid1ii411co
114115
plan_id:
115-
type: number
116+
type: string
116117
description: 委托代扣模板ID
117-
example: 12535
118+
example: '12535'
118119
out_contract_code:
119120
type: string
120121
description: 商户签约协议号
@@ -134,6 +135,51 @@ post:
134135
type: string
135136
description: 用户在商户公众号内的身份标识
136137
example: oYobu0MVnQfWpSMOYJz2AHPG_gQw
138+
free_insurance:
139+
type: boolean
140+
description: 是否为赠险
141+
combined_payment:
142+
type: boolean
143+
description: 是否与其它保单合并扣费
144+
payment_method:
145+
type: string
146+
description: 缴费方式
147+
enum:
148+
- PAYMENT_METHOD_OTHER
149+
- PAYMENT_METHOD_PERIOD
150+
- PAYMENT_METHOD_LUMP_SUM
151+
period_premium_mode:
152+
type: string
153+
description: 期交保费模式
154+
enum:
155+
- PERIOD_PREMIUM_MODE_EQUAL
156+
- PERIOD_PREMIUM_MODE_FIRST_DIFF
157+
- PERIOD_PREMIUM_MODE_MULTI_DIFF
158+
payment_period:
159+
type: string
160+
description: 缴费周期
161+
enum:
162+
- PAYMENT_PERIOD_DAY
163+
- PAYMENT_PERIOD_WEEK
164+
- PAYMENT_PERIOD_BIWEEKLY
165+
- PAYMENT_PERIOD_MONTH
166+
- PAYMENT_PERIOD_QUARTER
167+
- PAYMENT_PERIOD_HALF_YEAR
168+
- PAYMENT_PERIOD_YEAR
169+
first_period_amount:
170+
type: integer
171+
description: 首期保费金额
172+
example: 8000
173+
subsequent_period_amount:
174+
type: integer
175+
description: 后续每期保费金额
176+
example: 5000
177+
coverage_term_type:
178+
type: string
179+
description: 保障期限类型
180+
enum:
181+
- COVERAGE_TERM_TYPE_FIXED_DATE
182+
- COVERAGE_TERM_TYPE_LIFETIME
137183
responses:
138184
'200':
139185
schema:
@@ -152,6 +198,7 @@ post:
152198
- plan_id
153199
- out_contract_code
154200
- policy_periods
201+
- free_insurance
155202
properties:
156203
out_insurance_no:
157204
type: string
@@ -239,9 +286,9 @@ post:
239286
description: 保司保单号
240287
example: Coisihsiaxishishi4hihsid1ii411co
241288
plan_id:
242-
type: number
289+
type: string
243290
description: 委托代扣模板ID
244-
example: 12535
291+
example: '12535'
245292
out_contract_code:
246293
type: string
247294
description: 商户签约协议号
@@ -253,3 +300,48 @@ post:
253300
type: number
254301
description: 保险扣费周期编号
255302
example: 1
303+
free_insurance:
304+
type: boolean
305+
description: 是否为赠险
306+
combined_payment:
307+
type: boolean
308+
description: 是否与其它保单合并扣费
309+
payment_method:
310+
type: string
311+
description: 缴费方式
312+
enum:
313+
- PAYMENT_METHOD_OTHER
314+
- PAYMENT_METHOD_PERIOD
315+
- PAYMENT_METHOD_LUMP_SUM
316+
period_premium_mode:
317+
type: string
318+
description: 期交保费模式
319+
enum:
320+
- PERIOD_PREMIUM_MODE_EQUAL
321+
- PERIOD_PREMIUM_MODE_FIRST_DIFF
322+
- PERIOD_PREMIUM_MODE_MULTI_DIFF
323+
payment_period:
324+
type: string
325+
description: 缴费周期
326+
enum:
327+
- PAYMENT_PERIOD_DAY
328+
- PAYMENT_PERIOD_WEEK
329+
- PAYMENT_PERIOD_BIWEEKLY
330+
- PAYMENT_PERIOD_MONTH
331+
- PAYMENT_PERIOD_QUARTER
332+
- PAYMENT_PERIOD_HALF_YEAR
333+
- PAYMENT_PERIOD_YEAR
334+
first_period_amount:
335+
type: integer
336+
description: 首期保费金额
337+
example: 8000
338+
subsequent_period_amount:
339+
type: integer
340+
description: 后续每期保费金额
341+
example: 5000
342+
coverage_term_type:
343+
type: string
344+
description: 保障期限类型
345+
enum:
346+
- COVERAGE_TERM_TYPE_FIXED_DATE
347+
- COVERAGE_TERM_TYPE_LIFETIME

docs/v3/inspolicymgr/deduct/policies/{out_insurance_no}.yaml

Lines changed: 143 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,7 @@ get:
3131
- plan_id
3232
- out_contract_code
3333
- policy_periods
34+
- free_insurance
3435
properties:
3536
out_insurance_no:
3637
type: string
@@ -118,9 +119,9 @@ get:
118119
description: 保司保单号
119120
example: Coisihsiaxishishi4hihsid1ii411co
120121
plan_id:
121-
type: number
122+
type: string
122123
description: 委托代扣模板ID
123-
example: 12535
124+
example: '12535'
124125
out_contract_code:
125126
type: string
126127
description: 商户签约协议号
@@ -132,6 +133,51 @@ get:
132133
type: number
133134
description: 保险扣费周期编号
134135
example: 1
136+
free_insurance:
137+
type: boolean
138+
description: 是否为赠险
139+
combined_payment:
140+
type: boolean
141+
description: 是否与其它保单合并扣费
142+
payment_method:
143+
type: string
144+
description: 缴费方式
145+
enum:
146+
- PAYMENT_METHOD_OTHER
147+
- PAYMENT_METHOD_PERIOD
148+
- PAYMENT_METHOD_LUMP_SUM
149+
period_premium_mode:
150+
type: string
151+
description: 期交保费模式
152+
enum:
153+
- PERIOD_PREMIUM_MODE_EQUAL
154+
- PERIOD_PREMIUM_MODE_FIRST_DIFF
155+
- PERIOD_PREMIUM_MODE_MULTI_DIFF
156+
payment_period:
157+
type: string
158+
description: 缴费周期
159+
enum:
160+
- PAYMENT_PERIOD_DAY
161+
- PAYMENT_PERIOD_WEEK
162+
- PAYMENT_PERIOD_BIWEEKLY
163+
- PAYMENT_PERIOD_MONTH
164+
- PAYMENT_PERIOD_QUARTER
165+
- PAYMENT_PERIOD_HALF_YEAR
166+
- PAYMENT_PERIOD_YEAR
167+
first_period_amount:
168+
type: integer
169+
description: 首期保费金额
170+
example: 8000
171+
subsequent_period_amount:
172+
type: integer
173+
description: 后续每期保费金额
174+
example: 5000
175+
coverage_term_type:
176+
type: string
177+
description: 保障期限类型
178+
enum:
179+
- COVERAGE_TERM_TYPE_FIXED_DATE
180+
- COVERAGE_TERM_TYPE_LIFETIME
135181
patch:
136182
x-last-updated-at: 2026.01.14
137183
x-role:
@@ -232,9 +278,9 @@ patch:
232278
description: 保司保单号
233279
example: Coisihsiaxishishi4hihsid1ii411co
234280
plan_id:
235-
type: number
281+
type: string
236282
description: 委托代扣模板ID
237-
example: 12535
283+
example: '12535'
238284
out_contract_code:
239285
type: string
240286
description: 商户签约协议号
@@ -246,6 +292,51 @@ patch:
246292
type: number
247293
description: 保险扣费周期编号
248294
example: 1
295+
free_insurance:
296+
type: boolean
297+
description: 是否为赠险
298+
combined_payment:
299+
type: boolean
300+
description: 是否与其它保单合并扣费
301+
payment_method:
302+
type: string
303+
description: 缴费方式
304+
enum:
305+
- PAYMENT_METHOD_OTHER
306+
- PAYMENT_METHOD_PERIOD
307+
- PAYMENT_METHOD_LUMP_SUM
308+
period_premium_mode:
309+
type: string
310+
description: 期交保费模式
311+
enum:
312+
- PERIOD_PREMIUM_MODE_EQUAL
313+
- PERIOD_PREMIUM_MODE_FIRST_DIFF
314+
- PERIOD_PREMIUM_MODE_MULTI_DIFF
315+
payment_period:
316+
type: string
317+
description: 缴费周期
318+
enum:
319+
- PAYMENT_PERIOD_DAY
320+
- PAYMENT_PERIOD_WEEK
321+
- PAYMENT_PERIOD_BIWEEKLY
322+
- PAYMENT_PERIOD_MONTH
323+
- PAYMENT_PERIOD_QUARTER
324+
- PAYMENT_PERIOD_HALF_YEAR
325+
- PAYMENT_PERIOD_YEAR
326+
first_period_amount:
327+
type: integer
328+
description: 首期保费金额
329+
example: 8000
330+
subsequent_period_amount:
331+
type: integer
332+
description: 后续每期保费金额
333+
example: 5000
334+
coverage_term_type:
335+
type: string
336+
description: 保障期限类型
337+
enum:
338+
- COVERAGE_TERM_TYPE_FIXED_DATE
339+
- COVERAGE_TERM_TYPE_LIFETIME
249340
responses:
250341
'200':
251342
schema:
@@ -264,6 +355,7 @@ patch:
264355
- plan_id
265356
- out_contract_code
266357
- policy_periods
358+
- free_insurance
267359
properties:
268360
out_insurance_no:
269361
type: string
@@ -351,9 +443,9 @@ patch:
351443
description: 保司保单号
352444
example: Coisihsiaxishishi4hihsid1ii411co
353445
plan_id:
354-
type: number
446+
type: string
355447
description: 委托代扣模板ID
356-
example: 12535
448+
example: '12535'
357449
out_contract_code:
358450
type: string
359451
description: 商户签约协议号
@@ -365,3 +457,48 @@ patch:
365457
type: number
366458
description: 保险扣费周期编号
367459
example: 1
460+
free_insurance:
461+
type: boolean
462+
description: 是否为赠险
463+
combined_payment:
464+
type: boolean
465+
description: 是否与其它保单合并扣费
466+
payment_method:
467+
type: string
468+
description: 缴费方式
469+
enum:
470+
- PAYMENT_METHOD_OTHER
471+
- PAYMENT_METHOD_PERIOD
472+
- PAYMENT_METHOD_LUMP_SUM
473+
period_premium_mode:
474+
type: string
475+
description: 期交保费模式
476+
enum:
477+
- PERIOD_PREMIUM_MODE_EQUAL
478+
- PERIOD_PREMIUM_MODE_FIRST_DIFF
479+
- PERIOD_PREMIUM_MODE_MULTI_DIFF
480+
payment_period:
481+
type: string
482+
description: 缴费周期
483+
enum:
484+
- PAYMENT_PERIOD_DAY
485+
- PAYMENT_PERIOD_WEEK
486+
- PAYMENT_PERIOD_BIWEEKLY
487+
- PAYMENT_PERIOD_MONTH
488+
- PAYMENT_PERIOD_QUARTER
489+
- PAYMENT_PERIOD_HALF_YEAR
490+
- PAYMENT_PERIOD_YEAR
491+
first_period_amount:
492+
type: integer
493+
description: 首期保费金额
494+
example: 8000
495+
subsequent_period_amount:
496+
type: integer
497+
description: 后续每期保费金额
498+
example: 5000
499+
coverage_term_type:
500+
type: string
501+
description: 保障期限类型
502+
enum:
503+
- COVERAGE_TERM_TYPE_FIXED_DATE
504+
- COVERAGE_TERM_TYPE_LIFETIME

src/V3/Inspolicymgr/Deduct/Policies.php

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,11 +32,19 @@ public function post(array $options = [
3232
'address' => '上海市浦东新区晨晖路1001号',
3333
'policy_state' => 'POLICY_STATE_ISSUING',
3434
'policy_code' => 'Coisihsiaxishishi4hihsid1ii411co',
35-
'plan_id' => 12535,
35+
'plan_id' => '12535',
3636
'out_contract_code' => 'wxwtdk20200910100000',
3737
'policy_periods' => [1],
3838
'appid' => 'wxd678efh567hg6787',
3939
'openid' => 'oYobu0MVnQfWpSMOYJz2AHPG_gQw',
40+
'free_insurance' => true,
41+
'combined_payment' => true,
42+
'payment_method' => 'PAYMENT_METHOD_OTHER | PAYMENT_METHOD_PERIOD | PAYMENT_METHOD_LUMP_SUM',
43+
'period_premium_mode' => 'PERIOD_PREMIUM_MODE_EQUAL | PERIOD_PREMIUM_MODE_FIRST_DIFF | PERIOD_PREMIUM_MODE_MULTI_DIFF',
44+
'payment_period' => 'PAYMENT_PERIOD_DAY | PAYMENT_PERIOD_WEEK | PAYMENT_PERIOD_BIWEEKLY | PAYMENT_PERIOD_MONTH',
45+
'first_period_amount' => 8000,
46+
'subsequent_period_amount' => 5000,
47+
'coverage_term_type' => 'COVERAGE_TERM_TYPE_FIXED_DATE | COVERAGE_TERM_TYPE_LIFETIME',
4048
],
4149
'headers' => [
4250
'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
@@ -65,11 +73,19 @@ public function postAsync(array $options = [
6573
'address' => '上海市浦东新区晨晖路1001号',
6674
'policy_state' => 'POLICY_STATE_ISSUING',
6775
'policy_code' => 'Coisihsiaxishishi4hihsid1ii411co',
68-
'plan_id' => 12535,
76+
'plan_id' => '12535',
6977
'out_contract_code' => 'wxwtdk20200910100000',
7078
'policy_periods' => [1],
7179
'appid' => 'wxd678efh567hg6787',
7280
'openid' => 'oYobu0MVnQfWpSMOYJz2AHPG_gQw',
81+
'free_insurance' => true,
82+
'combined_payment' => true,
83+
'payment_method' => 'PAYMENT_METHOD_OTHER | PAYMENT_METHOD_PERIOD | PAYMENT_METHOD_LUMP_SUM',
84+
'period_premium_mode' => 'PERIOD_PREMIUM_MODE_EQUAL | PERIOD_PREMIUM_MODE_FIRST_DIFF | PERIOD_PREMIUM_MODE_MULTI_DIFF',
85+
'payment_period' => 'PAYMENT_PERIOD_DAY | PAYMENT_PERIOD_WEEK | PAYMENT_PERIOD_BIWEEKLY | PAYMENT_PERIOD_MONTH',
86+
'first_period_amount' => 8000,
87+
'subsequent_period_amount' => 5000,
88+
'coverage_term_type' => 'COVERAGE_TERM_TYPE_FIXED_DATE | COVERAGE_TERM_TYPE_LIFETIME',
7389
],
7490
'headers' => [
7591
'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',

0 commit comments

Comments
 (0)