淘宝开放平台

登录
文档中心 > API类目 > 天猫优品

天猫优品

qimen.taobao.tmyp.cts.policy.surrender (天猫优品退保接口)

天猫优品给第三方保司提交退保申请（例如人保等）

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tmypPolicyNo String 必须 209718 天猫优品保单号
insuranceCompanyPolicyNo String 必须 XXX 保司保单号
surrenderReasonCode String 可选 testCode 退保原因代码
surrenderReasonDesc String 可选 测试退保原因 退保原因描述
extParamList ExtParam [] 必须
  • 最大列表长度：999
    		•  扩展参数,双方约定的扩展字段,k-v格式
    • └ key
    • String
    • 必须
    • k1
    • key
    • └ value
    • String
    • 必须
    • v1
    • value

    响应参数

    名称 类型 示例值 描述
    success Boolean true 系统参数，本次调用是否成功
    returnCode String success 返回Code,签名错误:sign-check-failure 其他:由实现方确定
    returnMsg String 投保成功 返回信息,通常为对应于returnCode的文本描述，例如错误原因
    refundInsuranceFee String 6700 实际应退保费-分

    请求示例

    {"insuranceCompanyPolicyNo":"XXX","surrenderReasonCode":"testCode","tmypPolicyNo":"209718","extParamList":[{"value":"v1","key":"k1"}],"surrenderReasonDesc":"测试退保原因"}

    响应示例

    {
    "success":true,
    "returnCode":"success",
    "returnMsg":"投保成功",
    "refundInsuranceFee":"6700"
}

    验签示例

    {"returnCode":"sign-check-failure","returnMsg":"Illegal request","success":"false"}

    错误码解释

    错误码 错误描述 解决方案

    API工具

    错误码查询工具 SDK下载

    FAQ

    有用( 0 ) 我要提问
    返回
    顶部