商户可通过该接口创建保险订单。

接口说明

支持商户：

【普通商户】

请求方式：

【POST】/v3/hire-power-bank/insurance-orders

请求域名：

【主域名】

https://api.mch.weixin.qq.com

使用该域名将访问就近的接入点

【备域名】

https://api2.mch.weixin.qq.com

使用该域名将访问异地的接入点 ，指引点击查看

请求参数

Header HTTP头参数
Authorization 必填 string
请参考 签名认证 生成认证信息
Accept 必填 string
请设置为 application/json
Content-Type 必填 string
请设置为 application/json

Body 包体参数
out_order_no 必填 string(32)
【商户保险订单号】 商户创建保险订单时的凭据号，同一个商户号下必须唯一，要求32个字符内，只能是数字、大小写字母_-|*
openid 必填 string(128)
【用户标识】 微信用户在商户对应appid下的唯一标识。
notify_url 必填 string(256)
【通知商户URL】 用于接收保险订单状态变化通知。须使用https。
service_id 选填 string(128)
【支付分服务ID】 商户在支付分服务下对应的服务ID。

请求示例

POST

应答参数

200OK
order_id 必填 string(32)
【保险订单id】 租借充电宝隔夜归还保险订单号，唯一标识一笔保险订单。
out_order_no 必填 string(32)
【商户保险订单号】 商户创建保险订单时的凭据号，同一个商户号下必须唯一，要求32个字符内，只能是数字、大小写字母_-|*
openid 必填 string(128)
【用户标识】 微信用户在商户对应appid下的唯一标识。
max_claim_count 必填 integer
【最大理赔次数】 一笔保险订单对应的最大理赔次数。
claimed_count 必填 integer
【已理赔次数】 一笔保险订单对应的已理赔次数。
order_receive_time 必填 string(32)
【保险订单领取时间】 保险订单领取时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。
order_receive_state 必填 string
【保险订单领取状态】 保险订单领取状态。
可选取值：

• RECEIVING: 领取中。用户领取保险订单，但微保尚未确认是否领取成功。
• RECEIVED: 已领取。用户领取保险订单，微保确认领取成功。
• FAILED: 领取失败。用户领取保险订单，微保确认该保险订单领取失败。
order_begin_time 选填 string(32)
【保险订单开始时间】 保险订单开始时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。
order_end_time 选填 string(32)
【保险订单结束时间】 保险订单结束时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。

应答示例

200 OK

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	用户已投保	请确认用户是否已领取保险订单
400	INVALID_REQUEST	该订单号已被使用	请更换订单号再重试
403	NOAUTH	商户不支持领取隔夜保险	请确认是否支持隔夜归还
403	NOTENOUGH	用户领取保险订单次数达到上限	请确认用户是否达到领取上限
403	PARAM_ERROR	请检查请求参数再试	请检查请求参数再试
403	USER_ERROR	用户被保险公司风控策略拦截	请确认用户是否符合领取要求
500	SYSTEMERROR	系统异常，请稍后重试	系统异常，请稍后重试