保险商户小程序预签约API

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

Content-Type 　必填　string

请设置为application/json

Wechatpay-Serial 　必填　string

请求参数中的敏感字段，需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引，也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引

body 包体参数

appid 　必填 string(32)

【应用ID】 商户在微信申请的公众号或移动应用AppID

openid 　选填 string

【用户在直连商户应用下的用户标示】 JSAPI和小程序签约必填，对应的用户需与实际在微信客户端中进行签约的用户一致。OpenID获取详见

plan_id 　必填 integer

【委托代扣模板ID】 委托代扣模板ID，申请见接入指引中的接入流程相关内容。

out_contract_code 　必填 string(32)

【商户签约协议号】 商户侧的签约协议号，商户侧需保证唯一性。只能是数字、大小写字母的组合

insured_display_name 　必填 string(32)

【被保人的展示名称】 保险被保人的姓名掩码，由商户传入，用于在签约页面展示。如为个人保单，则只保留最后一个字符，除最后一个字符外全部字符（包括“.”等符号）均使用替代；如姓名长度大于4个字符，统一用3个“”+1位明文展示，如***G，如为家庭或者团体保单，传入的格式为“多人保单-**明等”。固定前缀为“多人保单-”，后面为投保人代表的姓名掩码及“等”字

contract_notify_url 　必填 string(256)

【签约结果通知地址】 接收微信支付异步通知回调地址，通知URL必须为HTTPS且可直接可访问的URL，不能携带参数。

policy_start_date 　必填 string(32)

【保险保单的开始日期】 保险保单的开始日期 ，遵循rfc3339标准格式，格式为yyyy-MM-DD，yyyy-MM-DD表示年月日，例如：2015-05-20表示，北京时间2015年5月20日。

policy_end_date 　必填 string(32)

【保险保单的结束日期】 保险保单的结束时间，遵循rfc3339标准格式，格式为yyyy-MM-DD，yyyy-MM-DD表示年月日，例如：2015-05-20表示，北京时间2015年5月20日。

policy_periods 　必填 array[PolicyPeriodBasicInfo]

【保单的扣费周期列表】 商户在与用户签约时，指定的若干个扣费周期，最多支持360个。进行纯签约或者支持自动重新投保/自动续保的签约中支付场景，至少传入1个扣费周期。不支持自动重新投保/自动续保的签约中支付场景，至少传入2个扣费周期。后续需要按照周期中的预计扣款时间和预计扣款金额进行预约扣款和扣款。预计扣款时间需要随着编号的递增而递增，编号较大的预计扣款时间不能早于编号较小的预计扣款时间。相邻编号的预计扣费时间间隔需要匹配委托代扣模板ID指定的扣费频率。若商户希望在进行签约后立即进行首期自动续费，首期的预计扣费日期必须等于调用本接口的日期，首期的预计扣费金额必须等于调用本接口的扣费金额信息。

	属性
	policy_period_id 　必填 integer 【保险扣费周期编号】 商户侧自定义的每个扣费周期的唯一ID，大于0的数字。 estimated_deduct_date 　必填 string(32) 【预计扣费的日期】 预计扣费的日期，遵循rfc3339标准格式，格式为yyyy-MM-DD，yyyy-MM-DD表示年月日，例如：2015-05-20表示，北京时间2015年5月20日。 estimated_deduct_amount 　必填 object 【预计扣费金额】 预计扣款金额 属性 total 　必填 integer 【金额】 总金额，单位为分，只能为整数。 currency 　选填 string 【货币类型】 枚举类型，符合ISO 4217标准的三位字母代码，默认为CNY，目前只支持CNY。 可选取值 CNY: 扣费货币类型-人民币

amount 　选填 object

【扣费金额信息】 若商户希望在进行签约后立即进行首期自动续费，必须传入扣费金额信息，必须等于首个扣费周期的的预约金额。

	属性
	total 　必填 integer 【金额】 总金额，单位为分，只能为整数。 currency 　选填 string 【货币类型】 枚举类型，符合ISO 4217标准的三位字母代码，默认为CNY，目前只支持CNY。 可选取值 CNY: 扣费货币类型-人民币

out_trade_no 　选填 string(32)

【商户订单号】 若商户希望在进行签约后立即进行首期自动续费，必须传入商户系统内部订单号。只能是数字、大小写字母且在同一个商户号下唯一

description 　选填 string(127)

【商品描述】 若商户希望在进行签约后立即进行首期自动续费，必须传入商品描述。

transaction_notify_url 　选填 string(256)

【支付结果通知地址】 若商户希望在进行签约后立即进行首期自动续费，必须传入异步接收微信支付结果通知的回调地址，通知URL必须为外网可访问的URL，不能携带参数。 公网域名必须为HTTPS，如果是走专线接入，使用专线NAT IP或者私有回调域名可使用HTTP

out_user_code 　选填 string(64)

【商户侧用户标识】 在多账号签约场景下使用。一个用户微信账号可能会在商户系统中存在多个账号，并开通多个签约协议。商户可以使用商户侧用户标识区分商户系统中的不同用户账号。注：使用多账号签约规则时，微信支付系统将限制相同的商户侧用户标识只能与同一个委托代扣模板签署一份生效中的协议。一个用户的微信账号在同一个模版下最多签约10份协议。

goods_tag 　选填 string(32)

【订单优惠标记】 在进行首期自动续费时，可选择使用优惠能力，传入在订单优惠标记。

attach 　选填 string(128)

【附加数据】 在进行首期自动续费时，可选择传入附加数据，在查询交易结果API和支付通知中原样返回，可作为自定义参数使用

can_auto_insure 　选填 boolean

【是否自动续保】 指扣费计划到期后，商家按照最新费率为用户续保，续保保证成功，成功后沿用旧保单号。是否自动续保与是否自动重新投保不能同时设置。

can_auto_reinsure 　选填 boolean

【是否自动重新投保】 指扣费计划到期后，商家按照最新费率为用户重新投保，不保证投保成功，投保成功后将生成新的保单号。是否自动续保与是否自动重新投保不能同时设置。

real_identity 　选填 object

【用户实名信息】 商家可选择指定用户实名信息。指定用户实名信息后，微信支付系统会校验商户指定的用户实名信息跟用户在微信支付侧的实名信息是否一致。信息一致时才可进行签约，若信息不一致，不能进行本次签约。注：因实名信息不一致导致无法进行签约，微信支付将不会通知签约结果，也不会产生协议或订单信息。

	属性
	real_name 　必填 string(512) 【自然人姓名】 经过加密后的自然人姓名信息 id_card_number 　必填 string(512) 【自然人身份证号码】 经过加密后的自然人身份证号码信息 identity_type 　选填 string 【实名验证类型】 默认是ID_CARD，目前仅支持ID_CARD 可选取值 ID_CARD: 身份证

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/papay/insurance-sign/contracts/pre-entrust-sign/mini-program \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  \
6  -H "Content-Type: application/json" \
7  -d '{
8    "appid" : "wxd678efh567hg6787",
9    "openid" : "oYobu0MVnQfWpSMOYJz2AHPG_gQw",
10    "plan_id" : 12535,
11    "out_contract_code" : "wxwtdk20200910100000",
12    "insured_display_name" : "*明",
13    "contract_notify_url" : "https://yourapp.com/notify",
14    "policy_start_date" : "Fri Nov 22 08:00:00 CST 2019",
15    "policy_end_date" : "Sun Nov 22 08:00:00 CST 2020",
16    "policy_periods" : [
17      {
18        "policy_period_id" : 1,
19        "estimated_deduct_date" : "Fri Nov 22 08:00:00 CST 2019",
20        "estimated_deduct_amount" : {
21          "total" : 1,
22          "currency" : "CNY"
23        }
24      }
25    ],
26    "amount" : {
27      "total" : 1,
28      "currency" : "CNY"
29    },
30    "out_trade_no" : "1217752501201407033233368018",
31    "description" : "Image形象店-深圳腾大-QQ公仔",
32    "transaction_notify_url" : "https://www.qq.com/",
33    "out_user_code" : "用户昵称",
34    "goods_tag" : "DISCOUNTS",
35    "attach" : "自定义数据",
36    "can_auto_insure" : true,
37    "can_auto_reinsure" : false,
38    "real_identity" : {
39      "real_name" : "OEimkKuua8igpd+0YDgqF2Z61leeGD7x87j3PhzsBhAK+/lltXENEOf6ThgV7niChzIpDujIpefE2JFZCJFurf6IV5rxNWBbjFeHYyUGAbf8zDx2Wbi7y7BGjApltIhsxAk+LhQ648Kcw4FMidL/79Gh3nHUfSGX+nEl3gtNi24Ilt8Vu0MMXhA1suDzlpbNDDrYnAhb1eeMziSu8jW7lDouwJXjGh9zgFPUuTxfOpteJIZSy8HWR+QPugdXBNouEezDPN8kojKbJHRtjaBJY3n3agkXShI5yvnc+DCYM+4VgNWZpTx9D0w3KAylJPKAAluYMzj4VXzZurjpruDg2A==",
40      "id_card_number" : "1axtI9EZUr0343c89xQznxau+cRWPKP4YhVAoj/mEoNSgJh0nvuqQJ1cdXZHGUzyBjOtuLeVq+OLOaWGUScSM8+QLBk+kOK8QyR1TUo44YrmIl5KkjWLa3dpNJt+nIkpN1e7yr2mxO9LGqJdeQXDCHvOiUTK6lnAVxWY0ZrF4OQFmHqOCvqTaF3VxD5a8AT3gxyayF04IJSfPV0NheZvWFBHIUeRPf1/WQmJ/wXu2MfAuESB0dLBglT85i0Rws2GopaTUNiBuJBHdg01bR+YZvSYv8EJPyxuyYVh5bg/wSotNTYnVp13OUzMBKu25yOW5+RnunesXwq9ogPnSj7EDA==",
41      "identity_type" : "ID_CARD"
42    },
43    "combined_deduct_period_count" : 2    
44  }'
45

200 OK

pre_entrustweb_id 　必填 string(128)

【预签约ID】 委托代扣签约会话ID，十分钟内有效，用于跳转签约流程的传入参数。

redirect_appid 　必填 string

【跳转签约小程序的AppID】 用于调用navigateToMiniProgram，进行跳转签约流程的传入参数。

redirect_path 　必填 string

【跳转签约小程序的路径】 用于调用navigateToMiniProgram，进行跳转签约流程的传入参数。

应答示例

200 OK

1{
2  "pre_entrustweb_id" : "5778aadY9nltAsZzXixCkFIGYnV2V",
3  "redirect_appid" : "wxbd687630cd02ce1d",
4  "redirect_path" : "pages/PwdExemptContract/index"
5}
6