文档中心 > API类目 > 阿里健康保险-信息交互

qimen.alibaba.alihealth.insurance.policy.installment.payment (保司对用户保单进行续期)

同步保险公司针对用户对应保单续期请求

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	描述
instPolicyId	String	必须	ZA523452435243524523	保司保单编号
extras	String	必须	{"channelCode":"A11111"}	拓展信息，类型是jsonString
bills	Struct	必须		续保保期
└ premium Number 必须 20000 保额，单位：分 └ installmentNo Number 必须 2 保期 └ payTime String 必须 2021-07-16 19:57:56 支付时间 └ instPayOrderId String 必须 1111 保司需要保证一个 instPayOrderId 只能用于一次投保或者一次续期
policyBillsId	String	必须	1111	请求号

响应参数

名称	类型	示例值	描述
status	String	SUCCESS	指令接收状态
data	Boolean	true	处理结果，true：续保成功，false：续保失败
errorCode	String	错误编码	错误编码
errorMessage	String	错误信息	错误信息

请求示例

{"policyBillsId":"1111","instPolicyId":"ZA523452435243524523","extras":"{\"channelCode\":\"A11111\"}","bills":{"instPayOrderId":"1111","premium":20000,"payTime":"2021-07-16 19:57:56","installmentNo":2}}

响应示例

{
    "status":"SUCCESS",
    "data":true,
    "errorCode":"错误编码",
    "errorMessage":"错误信息"
}

验签示例

{"errorMessage":"Illegal request","errorCode":"不等于null","status":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部