权益卡
本文档仅限接入京东健康保险业务参考，未经京东健康允许禁止以任何形式外传！#
一、权益卡领取#
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": "操作失败"}