权益卡
#
本文档仅限接入京东健康保险业务参考,未经京东健康允许禁止以任何形式外传!#
一、权益卡领取#
1)方案说明三方保司页面跳转到京东健康保险权益卡页时,URL中携带加密后的权益卡参数,京东健康平台进行验证以及解密处理并进行相应权益发放。
跳转地址:(注:channelNo由京东提供)
https://jdh-insurance.jd.com/?channelNo=xxx&reqType=outUrl¶m=密文
渠道编号:京东下发(例如:10114717431431169)
服务类型代码: 京东下发
加密秘钥:京东下发;例如:(e5q9E9H2n6C5&7a2)
加密算法:AES[AES/ECB/PKCS5Padding] 在线工具:https://tool.lmeee.com/jiami/aes
#
2)常见问题1、外部卡号(cardNo)是唯一的,每个渠道每张卡只能同一个人领取使用。
2、URL地址中reqType=outUrl 参数必填切不能填错;否则会出现领卡失败,并且无任何报错。
#
3)请求参数字段名 | 字段描述 | 类型 | 必填 |
---|---|---|---|
clientId | 渠道编码channelNo(京东下发) | String | 是 |
serviceType | 服务类型代码(京东下发) | String | 是 |
userId | 外部用户ID | String | 否 |
cardNo | 外部卡号/单号/个人凭证号(唯一标识) | String | 是 |
pass | 卡密 | String | 否 |
userName | 使用人姓名(张三) | String | 否 |
gender | 性别;MALE-男;FEMALE-女(枚举) | String | 否 |
mobile | 使用人手机号(151*4511) | String | 否 |
idNo | 使用人身份号(130430*1514) | String | 否 |
birthday | 使用人生日(yyyyMMdd) | String | 否 |
createTime | 权益卡生效时间(yyyyMMddHHmmss) | String | 是 |
注:手机号以及身份证号可以推送脱敏后的数据
#
(1)加密前注:标准JSON格式
{ "clientId":"11105067096571905","userId":"U0001","cardNo":"N10034103234321","pass":"wfRvd3e&f!221A","serviceType":"TEST_TYPE","userName":"张三","gender":"MALE","mobile":"151*4511","idNo":"130430*1514","birthday":"19950101","createTime":"20211123190910"}
#
(2)加密后MLyyPLAYrtsMYptk4K0xwKzHLcGFwn1g9VqSu/xYlHL8lHsZQOQ/QYDT/j4grYn2e9gcwUjsBHQlw1SclLacXshHV2V6pGPHiuJxWwlweFQEIZUWXdVmHQ4t+UxRYGfGsxVD/1hByhzvL3mmk4au8LOYTehH8vmFUZPebsn/zb+Ftxer3bQL/g2FRj8N/MUSNfp30YuJXRdNMRbeeBKUS8/wJ04XKR5YEJwFdjFJw50uzjYPBrVj1erGAl1ULa2b8eIwAyGHsC3zJRZZ2Usn/7aF4L5O+0FPzZ4vbN5yWy10BIrFdQBecVBWPBVyoy/wxdHh9rJ9V+98T7mDLcRItiFUZNYN5JfMtRlwKziPjtxRTJTGe8kKreNPZ4yHHLj7Qqz3k6VTsjhF8ah/G8Lrrw==
#
(3)urlEncode编码后注:密文存在特殊字符,需要进行urlEncode编码
URLEncoder.encode("XXXXXXXXXXX","UTF-8");
编码后:MLyyPLAYrtsMYptk4K0xwKzHLcGFwn1g9VqSu%2FxYlHL8lHsZQOQ%2FQYDT%2Fj4grYn2e9gcwUjsBHQlw1SclLacXshHV2V6pGPHiuJxWwlweFQEIZUWXdVmHQ4t%2BUxRYGfGsxVD%2F1hByhzvL3mmk4au8LOYTehH8vmFUZPebsn%2Fzb%2BFtxer3bQL%2Fg2FRj8N%2FMUSNfp30YuJXRdNMRbeeBKUS8%2FwJ04XKR5YEJwFdjFJw50uzjYPBrVj1erGAl1ULa2b8eIwAyGHsC3zJRZZ2Usn%2F7aF4L5O%2B0FPzZ4vbN5yWy10BIrFdQBecVBWPBVyoy%2FwxdHh9rJ9V%2B98T7mDLcRItiFUZNYN5JfMtRlwKziPjtxRTJTGe8kKreNPZ4yHHLj7Qqz3k6VTsjhF8ah%2FG8Lrrw%3D%3D
#
(4)H5地址示例https://jdh-insurance.jd.com/?channelNo=11105067096571905&reqType=outUrl¶m=MLyyPLAYrtsMYptk4K0xwKzHLcGFwn1g9VqSu%2FxYlHL8lHsZQOQ%2FQYDT%2Fj4grYn2e9gcwUjsBHQlw1SclLacXshHV2V6pGPHiuJxWwlweFQEIZUWXdVmHQ4t%2BUxRYGfGsxVD%2F1hByhzvL3mmk4au8LOYTehH8vmFUZPebsn%2Fzb%2BFtxer3bQL%2Fg2FRj8N%2FMUSNfp30YuJXRdNMRbeeBKUS8%2FwJ04XKR5YEJwFdjFJw50uzjYPBrVj1erGAl1ULa2b8eIwAyGHsC3zJRZZ2Usn%2F7aF4L5O%2B0FPzZ4vbN5yWy10BIrFdQBecVBWPBVyoy%2FwxdHh9rJ9V%2B98T7mDLcRItiFUZNYN5JfMtRlwKziPjtxRTJTGe8kKreNPZ4yHHLj7Qqz3k6VTsjhF8ah%2FG8Lrrw%3D%3D
#
(5)小程序对接原始id:gh_2c730f1ca10a
Appid:wx86d0797d34f56442
Path:pages/login/wv-common/wv-common?h5_url=H5地址 URLRencode后
APP跳转微信小程序开发文档
https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Launching_a_Mini_Program/Launching_a_Mini_Program.html
#
二、权益卡查询#
1) 对接流程(必读)1、需要注册京东开放平台账号;
注册地址:https://jos.jd.com/
实名认证:注册并实名认证后提供账号名称以及应用名称,进行信息审核;
注册流程: https://jos.jd.com/commondoc?listId=128
2、联系京东对接人员为账号分配接口权限;
3、开方平台API调用方法:
https://open.jd.com/home/home#/doc/common?listId=890
4、开发平台接口地址:
生产:https://api.jd.com/routerjson
测试(预发):https://api-dev.jd.com/routerjson
5、开放平台可以下载SDK,SDK中包含所有已授权的接口;--推荐SDK对接
#
2)请求参数卡券查询接口时,整体报文使用AES加密。数据类型为json格式。
接口文档地址:
https://jos.jd.com/apilist?apiGroupId=727&apiId=18472&apiName=jingdong.jdh.insurance.out.rightsorder.query
字段名 | 字段描述 | 类型 | 必填 |
---|---|---|---|
channelNo | 渠道号(京东下发) | String | 是 |
param | 业务请求参数加密后的密文 | String | 是 |
请求参数(param)
字段名 | 字段描述 | 类型 | 必填 |
---|---|---|---|
cardNo | 外部卡号/单号/个人凭证号(唯一标识) | String[60] | 是 |
userId | 保司用户ID | String[60] | 否 |
明文示例:{ "cardNo": "卡号", "createTime": "2021-09-03","userId":"21321421"}
#
3)响应报文(1)成功:
{"success":0,"msg": "查询成功", "secretInfo":密文...}(如果信息不存在则secretInfo为空)
回应参数
(secretInfo解密后是JSON格式,其中各参数说明如下)
字段名 | 字段描述 | 类型 | 必填 |
---|---|---|---|
serviceType | 服务类型代码 | String | 是 |
userId | 外部用户ID | String | 否 |
cardNo | 外部卡号/单号/个人凭证号(唯一标识) | String | 是 |
createTime | 权益卡生效(兑换)时间 (YYYY-MM-dd HH:mm:ss) | String | 是 |
cardStatus | 保司权益卡状态;1-有效,2-无效,4-冻结 | int | 是 |
receiveStatus | 权益激活状态;1-待激活,2-已激活 | int | 是 |
rightsPackageInfoDTOList | 服务包状态 | List | 否 |
RightsPackageInfoDTO:
字段名 | 字段描述 | 类型 | 必填 |
---|---|---|---|
packageName | 服务包名称 | String | 是 |
useStatus | 是否使用;1-未使用,2-已使用 | int | 是 |
packageStatus | 服务包状态;1-未过期(已生效)、2-已过期、3-已作废(已退款)、4-待生效、5-已用完、6-已作废、7-已冻结 | int | 是 |
(2)失败:
{"success":1,"msg": "操作失败"}