淘宝开放平台

登录
文档中心 > API类目 > 场景金融保险

场景金融保险

qimen.alibaba.finance.insurance.policy.modify (场景金融保险批改交互接口)

场景金融通过该接口向机构批改保单信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
identifier String 必须 123 唯一识别id，幂等字段
productCode String 可选 CES 产品码
modifyId String 可选 010101004178221080402170019 阿里侧业务批改单号
policyNo String 必须 TESTNO 保司侧保单号
modifyTime String 必须 2021-08-04 15:23:28 批改时间 yyyy-MM-dd HH:mm:ss
modifyAmount String 可选 19.22 批改保额 单位：元/美元 四舍五入保留两位小数
modifyPremium String 可选 1.11 批改保费 单位：元/美元 四舍五入保留两位小数
modifyType String 必须 QUIT 保额批改类型 REDUCE_INSURE_AMOUNT、INCREASE_INSURE_AMOUNT、QUIT
currency String 必须 CNY 币种
attrs Attrs 可选 扩展信息
  • └ paymentChannelVoucher
  • String
  • 可选
  • 2022082910002001230531335960
  • 批改对应的支付流水号
  • └ payTime
  • String
  • 可选
  • 2024-01-01 12:00:08
  • 支付时间 yyyy-MM-dd HH:mm:ss
access_token String 可选 $^%&(^gjgJHGGF token
insureId String 可选 010**** 阿里保单号

响应参数

名称 类型 示例值 描述
responseCode String SUCCESS 错误码
context Context 返回内容
  • └ modifyNo
  • String
  • PLM31243
  • 机构侧批改单号
errorMessage String OK 错误描述
success String true 请求是否成功

请求示例

{"modifyType":"QUIT","access_token":"$^%&(^gjgJHGGF","identifier":"123","productCode":"CES","modifyTime":"2021-08-04 15:23:28","modifyId":"010101004178221080402170019","modifyAmount":"19.22","modifyPremium":"1.11","insureId":"010****","policyNo":"TESTNO","currency":"CNY","attrs":{"payTime":"2024-01-01 12:00:08","paymentChannelVoucher":"2022082910002001230531335960"}}

响应示例

{
    "responseCode":"SUCCESS",
    "context":{
        "modifyNo":"PLM31243"
    },
    "errorMessage":"OK",
    "success":"true"
}

验签示例

{"success":"不等于true","errorMessage":"Illegal request","responseCode":"sign-check-failure"}

错误码解释

错误码 错误描述 解决方案
parameter-type-error
isp.http-read-timeout
response-body-parse-error

API工具

错误码查询工具 SDK下载

FAQ

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