本接口用于在开通ETC自动扣费前上传一些必要的信息。

接口说明

支持商户： 【普通服务商】

请求方式： 【POST】

请求URL： /v3/vehicle/etc/preopen

请求域名：【主域名】 "https://api.mch.weixin.qq.com"

请求参数

Header HTTP头参数
Authorization 必填 string
请参考 签名认证 生成认证信息
Accept 必填 string
请设置为 application/json
Content-Type 必填 string
请设置为 application/json
Wechatpay-Serial 必填 string
【微信支付平台证书序列号】 请求参数中的敏感字段，需要使用微信支付平台证书公钥加密。请设置为该证书的证书序列号。详见敏感信息加解密

Body 包体参数
sp_appid 必填 string(32)
【服务商AppID】 服务申请的公众号ID
sub_appid 选填 string(32)
【子AppID】 微信支付分配的公众账号ID
sub_mchid 选填 string(32)
【特约商户ID】 特约商户号，由微信支付生成并下发。
openid 必填 string(128)
【用户标识】 用户标识，此参数为微信用户在商户对应AppID或sub_appid下的唯一标识
plan_id 必填 string(32)
【ETC授权扣费模板ID】 ETC授权扣费模板ID，商户申请后由微信侧提供
etc_device_id 选填 string
【etc设备号】 ETC设备号
plate_number 选填 string(32)
【车牌号】 车牌号
identify 必填 UserIdentify
【实名信息】 实名信息
• 属性
bank_card_no 选填 string(2048)
【用户开通etc时绑定的银行卡】 用户开通etc时绑定的银行卡

请求示例

POST

应答参数

200OK
preopen_id 必填 string
【预开通ID】 预开通ID

应答示例

200 OK

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅 接口规则
401	SIGN_ERROR	验证不通过	请参阅 签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
500	SYSTEM_ERROR	系统错误	请稍后原付款单号重试
404	RESOURCE_NOT_EXISTS	签约模板不存在或已停用	请修改后再试
400	CONTRACT_NOT_EXIST	ETC绑定信息不存在	请引导用户进行绑定
400	RESOURCE_ALREADY_EXISTS	用户已绑定该ETC设备，不可重复绑定	-