PDF《乐享理财系统》

乐享理财系统 对接文档 V2.

1.2 1. 文档介绍 1.1. 阅读对象 业务系统设计人员、开发人员及测试人员;

理财业务系统设计人员、开发人员及测试人员;

其他相关业务、技术人员. 1.2. 业务术语 略 2. 通讯协议及报文(交易接口) 2.1. 通讯基本协议 ? 基于 Https 通信协议(测试环境会基于 HTTP) ;

? 采用 POST 提交方式进行数据通讯;

? 采用 json 传递数据( 申请购买(收银台) 接口见单独说明) ;

? 请求数据采用 AES(CBC 模式,24 byte key, iv=[0: 16byte])加密,确保敏感数据不会 泄露.对交易业务 json 数据采用 AES 加密后放置到 data 字段,并对 data 密文数据 进行 MD5 签名,签名信息=MD5.SIGN(交易数据密文&

渠道商秘钥) ;

? 返回数据,正常返回的数据 data 域返回信息采用同请求数据同样的加密方式;

非正 常返回的数据则 data 数据为空;

? 本通信基本协议说明只针对服务方为平台自身的交易类型接口适用,渠道端通知接 口或其他类型接口请参照具体接口说明. 2.2. 请求数据格式 请求数据统一采用 POST 提交方法,顶层数据主要包括以下几部分: 参数 类型 必需 说明 sign String Y 交易数据加密密文签名信息 merchant_id String Y 系统分配的渠道商编号 data String Y JSON 交易数据的 AES 加密密文 加密前,明文业务请求数据(注意:业务明文中不需要携带渠道商户 ID);

{ app_order_id : 2015081815555522463_TEST01 , app_redeem_id :

20150818155555224 63_REDEEM01 , is_expired :

1 , is_express :

1 , redeem_type :

1 , redeem_amount :null, ad d_amount :90.0} 密文=AES( AES/CBC/PKCS5Padding ,业务明文 JSON 数据,AES 加密密钥, UTF-8 );

密文 MD5 签名,sign=md5.sign(密文&

商户秘钥);

加密后密文请求数据: { sign : 154b3a12a681309276712f9e1e283182 , merchant_id : abc , data : 43A5B06C41 E54131F89373AD59277A3D6FE51BD8165597BF12BB46BB91BDA9A8BC59FB4FF2E8A689BD69AF 06969E587E8C241D508DC54A471D5F7C2D8F0DA1608FF2A90AF8A95C6F0F604A9B7C482F5501 87A73384EC0289342D97D2E019E88EC48BA513457E6679E7AD2A3274C9C9271CB419B8B9F7B1 95ED444B78BBE1BD755F8B1939041963E163D5B0664729C0A5E60F1ABAE586A9E81409A7AA48 CC02E84ABDE1BE8213297A8D5FD89A57946352BBCB93D4AFFB5230A5EE537417A370EB3BB82 CBD69504CE3488EC2D0608476B9 } 2.3. 返回数据格式 返回数据也采用 AES 加密,加密过程为请求数据加密的逆向过程. 正常响应处理成功的数据返回: { msgCode :

3000 , msgDes : 交易成功 , sign : 154b3a12a681309276712f9e1e283182 , merchant_id : abc , data : 43A5B06C41E 54131F89373AD59277A3D6FE51BD8165597BF12BB46BB91BDA9A8BC59FB4FF2E8A689BD69AF0 6969E587E8C241D508DC54A471D5F7C2D8F0DA1608FF2A90 } 非正常响应处理的数据返回: { msgCode :

1003 , msgDes : 订单不能重复提交 , sign :null, data :, merchant_id :null} 3. 交互流程说明 3.1. 获取产品信息 用户 理财平台 前置系统 1.调用获取产品信息接口、查询产品信息 2.返回产品明细信息 3.向用户展示产品信息 3.2. 产品购买 用户 理财平台 前置系统 1.登录理财平台 2.选择购买产品,填写支付信息,发起产 品购买 3.发起产品申请购买请求 5.返回产品申请购买结果 9.向用户展示产品购买结果 7.发起产品确认购买请求 8.返回产品确认购买结果 4.向用户下发支付短信验证码 6.用户填写支付短信验证码 10.通知用户投资结果 3.3. 产品赎回 3.3.1 用户主动发起赎回 用户 理财平台 前置系统 1.登录理财平台 2.选择已购买产品,发起产品赎回 3.发起产品赎回申请交易请求 5.返回产品赎回申请受理结果 9.向用户展示产品赎回打款到账结果 8.返回产品赎回打款到账结果 4.赎回交易处理 6.向用户展示产品赎回请求受理结果 7.赎回打款交易处理 3.3.2 乐享理财系统发起赎回 固定期限类理财产品及固定到期日理财产品, 均由乐享理财系统在产品到期日主动发起 赎回业务操作,例如固定期限产品. 用户 理财平台 前置系统 4.向用户展示产品赎回打款到账结果 3.返回产品赎回打款到账结果 1.产品赎回交易处理 2.赎回打款交易处理 3.4 取消投资 取消投资接口由理财平台根据自身平台实际业务场景按业务需求进行交易申请提交, 取 消投资后将恢复该产品销售配额. 理财平台 前置系统 3.取消投资交易申请 2.取消投资交易处理,产品配额业务处理 1.取消投资交易申请 4. 交易接口列表 4.1. 创建用户 通过本系统进行理财产品购买的用户需要在本平台创建实名用户, 用户创建成功以后才 可以通过本平台进行理财购买及支付等操作. ? 服务名 v2/user/createUser.htm ? 支持格式 json 报文 ? 请求方式 http/https ? 请求参数 节点参数名 字段 必选 类型及范围 说明 merchant_id merchant_id true string(7) 渠道商户 ID, 渠道商入网时 由系统分配 sign sign true string 签名 data app_uid true string(50) 渠道用户编号 username true string(50) 用户实名 id_card_type true int 证件类型 1- 身份证 id_card_no true string(50) 证件号码 bank_account false string(50) 银行卡号 mobile false string(50) 手机号 (说明: 银行卡号传递 时手机号为必 填,且必须为 该银行卡银行 预留手机号) version true string 接口版本号(必须填写 2.0.0 ) remark false string(256) 备注 ? 返回参数 节点参数名 字段 必须 类型 说明 msgCode msgCode true string 响应码 msgDes msgDes true string 响应信息 merchant_id merchant_id true string(7) 渠道商户 ID, 渠道商入网时 由系统分配 sign sign true string 签名 data is_new true boolean 是否该用户之 前已经存在, 还是刚刚创建 status true string(2) 开户状态. 01- 开户成功;