五洲接口

ol环境信息

生产域名： cloud.ekcib.com

测试测试： admintcc.ekcib.com

headers

key	value
Authorization	调用token接口返回access_token值
Content-Type	application/json;charSet=utf-8;

token获取接口

地址：https://{环境}/api/token/platform_token
请求方式：post
参数类型：application/json

body

字段	类型	备注
appKey	String	五洲提供
appSecret	String	五洲提供

请求示例

{
  "appKey": "QKw4Yw73aiye8YKa",
  "appSecret": "fJbMGXAbQcsedzneT75Sjmpw7Wt6jY6F"
}

返回示例

{
    "code": 200,
    "msg": "获取Token成功！",
    "data": {
        "access_token": "c2b5c6f2-a3b9-4dd7-ad70-c6beeef40e9",
        "expires_in": 86400
    }
}

投保接口

地址：https://{环境}/api/capi/standard/insure
方法：post
参数类型：application/json

body

字段	类型	必须	描述
applicantInfo	Object	是	投保人信息
baseInfo	Object	是	基本信息
riskGroupInfoList	List	是	标的信息

applicantInfo 投保人信息

字段	类型	必须	描述
name	String	是	姓名
certificateType	String	是	证件类型01:身份证、02:护照、03:军人证、04:港澳通行证、05:驾驶证、06:港澳回乡证或台胞证 17:军官证 10:台湾通行证、99:其他、L:户口本 O:外国人永久居留身份证
certificateNo	String	是	证件号码
mobileTelephone	String	是	电话号码
email	String	否	电子邮箱有些保司用于接收电子保单
sexCode	String	否	M-男、F-女
age	String	否	年龄
birthday	String	否	出生日期 yyyy-MM-dd 非身份证的时候某些场景必传
age	String	否	年龄非身份证的时候某些场景必传
personnelType	String	否	个团标志[1个人，0团体]

baseInfo 基本信息

字段	类型	必须	描述
productCode	String	是	产品编码
insuranceBeginDate	String	否	保险起期（yyyy-MM-dd HH:mm:ss）
insuranceEndDate	String	否	保险止期（yyyy-MM-dd HH:mm:ss）
totalActualAmount	String	是	保额
totalActualPremium	String	是	保费
transactionNo	String	是	流水号订单号

riskGroupInfoList 标的信息

字段	类型	必须	描述
riskPersonInfoList	List	是	被保人信息
planInfoList	List	否	自选险种

riskPersonInfoList 被保人信息

字段	类型	必须	描述
name	String	是	姓名
certificateType	String	是	证件类型01:身份证、02:护照、03:军人证、04:港澳通行证、05:驾驶证、06:港澳回乡证或台胞证 17:军官证 10:台湾通行证、99:其他、L:户口本 O:外国人永久居留身份证
certificateNo	String	是	证件号码
mobileTelephone	String	是	电话号码
email	String	否	电子邮箱
address	String	否	被保人地址
sexCode	String	是	M-男、F-女
age	String	是	年龄
birthday	String	否	出生日期 yyyy-MM-dd
relationshipWithApplicant	String	是	被保人与投保人关系（被保人与投保人关系：1-本人、2-配偶、3-子女 10-父母
riskLevel	String	是	1-低风险 2-<font style="color:rgb(0,0,0);">中低风险</font> <font style="color:rgb(0,0,0);">3-中风险</font> <font style="color:rgb(0,0,0);">4-中高分新概念</font> <font style="color:rgb(0,0,0);">5-高风险</font>
isSpecificMT	String	是	0-否 1-是

planInfoList 方案信息

字段	类型	必须	描述
planCode	String	是	方案编码

请求报文示例

{
    "baseInfo": {
        "productCode": "MP01111111",
        "totalActualPremium": "165",
        "recallId": "202406111514232146ce75ec",
        "transactionNo": "CIB20240611151225573038",
        "totalActualAmount": "0",
        "insuranceEndDate": "2025-09-25 23:59:59",
        "insuranceBeginDate": "2024-09-26 00:00:00"       
    },
    "applicantInfo": {
        "sexCode": "M",
        "mobileTelephone": "13566669999",
        "personnelType": "1",
        "name": "测试",
        "certificateNo": "510105199309308387",
        "certificateType": "07"
    },   
    "riskGroupInfoList": [
        {
            "planInfoList": [
                {
                    "planCode": "FA2024051051244296"
                }
            ],
            "riskPersonInfoList": [
                {
                    "birthday": "1975-10-18",
                    "totalActualPremium": 18,
                    "certificateNo": "510105199309308387",
                    "sexCode": "F",                  
                    "name": "被保人1", 
                    "certificateType": "01",
                    "relationshipWithApplicant": "1"
                },
                {
                    "birthday": "1975-10-18",
                    "totalActualPremium": 18,
                    "certificateNo": "510105199309308387",
                    "sexCode": "F",                  
                    "name": "被保人2", 
                    "certificateType": "01",
                    "relationshipWithApplicant": "1"
                }
            ]
        }
    ]
}

响应

字段	类型	必须	描述
code	int	是	200成功 500错误
msg	String	是	描述
data	object	是	数据

请求成功

{
    "code": 200,
    "msg": "成功",
    "data": {
        "applyPolicyNo": "投保单号",
        "premium": "保费",
        "productCode": "产品编码",
        "transactionNo": "投保申请流水号",
        "payUrl":"支付链接地址"
    }
}

请求失败

{
    "code": 500,
    "msg": "该投保单即时生效,保险起期 2023-12-28 00:00:00，应在[2024-01-03 11:00:00 ~ 2024-03-03 10:59:59]之间",
    "data": null
}

保单回传

地址：合作方提供如回传接收失败五洲按5分钟频率重试3次
请求方式：post
参数类型：application/json

body

字段	类型	必须	描述
policyNo	String	是	保单号
transactionNo	String	是	投保时的流水订单号
paymentTime	String	是	支付成功时间
insuranceBeginDate	String	是	起保时间 yyyy-MM-dd HH:mm:ss
insuranceEndDate	String	是	终保时间 yyyy-MM-dd HH:mm:ss
status	String	是	1-承保成功,-1-承保失败
riskPersonInfoList	List	是	被保人列表

riskPersonInfoList 被保人信息

字段	类型	必须	描述
name	String	是	姓名
certificateType	String	是	证件类型01:身份证、02:护照、03:军人证、04:港澳通行证、05:驾驶证、06:港澳回乡证或台胞证 17:军官证 10:台湾通行证、99:其他、L:户口本 O:外国人永久居留身份证
certificateNo	String	是	证件号码

请求示例

{
    "transactionNo": "CIB2024011407351660001652",
    "paymentTime": "2024-12-07 00:00:00",
    "insuranceBeginDate": "2024-12-07 00:00:00",
    "insuranceEndDate": "2025-12-07 00:00:00",
    "status": "1",
    "policyNo": "P1209596600566214802",
    "riskPersonInfoList": [
        {
            "birthday": "1975-10-18",
            "totalActualPremium": 18,
            "certificateNo": "510105199309308387",
            "sexCode": "F",
            "name": "被保人1",
            "certificateType": "01",
            "relationshipWithApplicant": "1"
        },
        {
            "birthday": "1975-10-18",
            "totalActualPremium": 18,
            "certificateNo": "510105199309308387",
            "sexCode": "F",
            "name": "被保人2",
            "certificateType": "01",
            "relationshipWithApplicant": "1"
        }
    ]
}

请求成功

{
    "code": 200,
    "msg": "成功"
}

请求失败

{
    "code": 500,
    "msg": "原因"
}

保单批改回传（退保）

地址：合作方提供如回传接收失败五洲按5分钟频率重试3次
请求方式：post
参数类型：application/json

body

字段	类型	必须	描述
policyNo	String	是	保单号
<font style="color:#000000;">reTime</font>	<font style="color:#000000;">String</font>	<font style="color:#000000;">是</font>	<font style="color:#000000;">退保时间</font>
<font style="color:#000000;">reTotalPremium</font>	<font style="color:#000000;">String</font>	<font style="color:#000000;">是</font>	<font style="color:#000000;">退保总金额</font>
<font style="color:#000000;">riskPersonInfoList</font>	<font style="color:#000000;">Array</font>	<font style="color:#000000;">是</font>	<font style="color:#000000;">被保人信息</font>

riskPersonInfoList 被保人信息

字段	类型	必须	描述
name	String	是	姓名
certificateType	String	是	证件类型01:身份证、02:护照、03:军人证、04:港澳通行证、05:驾驶证、06:港澳回乡证或台胞证 17:军官证 10:台湾通行证、99:其他、L:户口本 O:外国人永久居留身份证
certificateNo	String	是	证件号码
<font style="color:#000000;">rePremium</font>	<font style="color:#000000;">String</font>	是	退保金额

请求示例

{
  "policyNo": "PA202506130001",
  "reTime": "2024-12-07 00:00:00",         
  "reTotalPremium": "500",    
  "riskPersonInfoList": [
    {
      "name": "李四",
      "certificateType": "01",  // 身份证
      "certificateNo": "110101199202022345",
      "rePremium": "500",
    }
  ]
}

请求成功

{
    "code": 200,
    "msg": "成功"
}

请求失败

{
    "code": 500,
    "msg": "原因"
}

ol环境信息

headers

token获取接口

body

请求示例

返回示例

投保接口

body

applicantInfo 投保人信息

baseInfo 基本信息

riskGroupInfoList 标的信息

请求报文示例

响应

请求成功

请求失败

保单回传

body

请求示例

请求成功

请求失败

保单批改回传（退保）

body

请求示例

请求成功

请求失败

推荐阅读更多精彩内容