logo资料库

平安银行电商见证宝2.0接口文档v1.93.doc

第1页 / 共202页
第2页 / 共202页
第3页 / 共202页
第4页 / 共202页
第5页 / 共202页
第6页 / 共202页
第7页 / 共202页
第8页 / 共202页
资料共202页,剩余部分请下载后查看
版本管理
总体说明
名词解释
账户结构
资金流向
资金归集于资金汇总账户方案:
资金归集于平台自有结算账户方案
T+1提现原则
接口列表
通讯方式说明
互联网通讯
专线通讯
通讯报文说明
互联网通讯
通讯报文头
业务报文头
业务报文体
完整报文示例
专线通讯
业务报文头
业务报文体
完整报文示例
接口API使用说明
JAVA版API调用说明
API函数总览
API调用方法
1生成请求银行的报文
调用方法:
2发送报文并接收银行返回
调用方法:
3解析接收银行的报文
调用方法:
4解析银行返回报文带Array信息数组的部分
API使用约定
第二章 详细接口说明
联机接口说明
会员注册与绑定
会员子账户开立(绑定提现账户-银联鉴权)【6088】
功能描述:
相关说明:
接口字段:
会员子账户开立(绑定提现账户-回填短信验证码)【6097】
功能描述:
相关说明:
接口字段:
会员子账户开立【6000】
功能描述:
相关说明:
接口字段:
会员绑定提现账户-银联鉴权【6066】
功能描述:
相关说明:
接口字段:
会员绑定提现账户-回填银联鉴权短信码【6067】
功能描述:
相关说明:
接口字段:
会员绑定提现账户-小额转账鉴权【6055】
功能描述:
相关说明:
接口字段:
小额转账鉴权验证【6064】
功能描述:
相关说明:
接口字段:
修改会员属性(普通商户子账户)【6162】
功能描述:
相关说明:
接口字段:
维护会员绑定提现账户联行号【6138】
功能描述:
相关说明:
接口字段:
会员绑定信息查询【6098】
功能描述:
相关说明:
接口字段:
会员解绑提现账户【6065】
功能描述:
相关说明:
接口字段:
申请修改手机号码【6083】
功能描述:
相关说明:
接口字段:
回填动态码-修改手机【6084】
功能描述:
相关说明:
接口字段:
会员充值与提现
会员充值(在途)【6056】
功能描述:
相关说明:
接口字段:
会员充值(在途含订单号)【6121】
功能描述:
相关说明:
接口字段:
交易部分撤销【6122】
功能描述:
相关说明:
接口字段:
会员提现【6033】(不验证)
功能描述:
相关说明:
接口字段:
会员提现(支持手续费、短信验证)【6085】
功能描述:
相关说明:
接口字段:
会员提现(支持手续费、支付密码验证)【6111】
功能描述:
相关说明:
接口字段:
会员批量清分【6053】
功能描述:
相关说明:
接口字段:
登记挂账【6008】
功能描述:
相关说明:
接口字段:
会员间交易
查询银行单笔交易状态(6094优化版)【6110】
功能描述:
相关说明:
接口字段:
平台订单管理【6031】
功能描述:
相关说明:
接口字段:
会员间交易(不验密)【6034】
功能描述:
相关说明:
接口字段:
会员间交易(验证短信动态码)【6101】
功能描述:
相关说明:
接口字段:
会员交易【6006】(验密)
功能描述:
相关说明:
接口字段:
会员交易(多借多贷-中转户)【6119】
功能描述:
相关说明:
接口字段:
会员批量交易【6052】(不验证)
功能描述:
相关说明:
接口字段:
会员批量交易(验证短信动态码)【6133】
功能描述:
相关说明:
接口字段:
会员批量交易(验密)【6120】
功能描述:
相关说明:
接口字段:
会员资金冻结【6007】(不验证)
功能描述:
相关说明:
接口字段:
会员资金冻结(验证短信动态码)【6135】
功能描述:
相关说明:
接口字段:
会员资金冻结(验密)【6134】
功能描述:
相关说明:
接口字段:
会员资金支付【6070】(不验证)
功能描述:
相关说明:
接口字段:
会员资金支付(验证短信动态码)【6137】
功能描述:
相关说明:
接口字段:
会员资金支付(验密)【6136】
功能描述:
相关说明:
接口字段:
会员资金支付-支持退款【6163】(不验证)
功能描述:
相关说明:
接口字段:
会员资金支付-支持退款【6166】(验证短信动态码)
功能描述:
相关说明:
接口字段:
会员资金支付-支持退款【6165】(验密)
功能描述:
相关说明:
接口字段:
会员间交易退款【6164】(不验证)
功能描述:
相关说明:
接口字段:
公共交易
交易撤销【6077】
功能描述:
相关说明:
接口字段:
申请提现或支付短信动态码【6082】
功能描述:
相关说明:
接口字段:
查询类交易
查询资金汇总账户余额【6011】
功能描述:
相关说明:
接口字段:
查询银行子账户余额【6010】
功能描述:
相关说明:
接口字段:
根据会员代码查询会员子账号【6092】
功能描述:
相关说明:
接口字段:
查询会员子账号【6037】
功能描述:
相关说明:
接口字段:
查询会员子账号余额【6093】
功能描述:
相关说明:
接口字段:
查询小额往账鉴权的转账状态【6061】
功能描述:
相关说明:
接口字段:
查询银行提现退票信息【6048】
功能描述:
相关说明:
接口字段:
查询普通转账充值明细【6050】
功能描述:
相关说明:
接口字段:
查询银行时间段内交易明细【6072】
功能描述:
相关说明:
接口字段:
查询银行时间段内清分提现明细【6073】
功能描述:
相关说明:
接口字段:
查询银行在途清算结果【6108】
功能描述:
相关说明:
接口字段:
查询银行费用扣收结果【6109】
功能描述:
相关说明:
接口字段:
查询子帐号历史余额及待转可提现状态信息【6114】
功能描述:
相关说明:
接口字段:
查询明细单验证码【6142】
功能描述:
相关说明:
接口字段:
查询橙e门户和橙e付状态【6102】
功能描述:
相关说明:
接口字段:
查询会员子账号基本信息【6099】(暂不提供)
功能描述:
相关说明:
接口字段:
理财类
个人理财
理财开户【6087】
功能描述:
相关说明:
接口字段:
理财购买【6068】
功能描述:
相关说明:
接口字段:
理财赎回【6069】
功能描述:
相关说明:
接口字段:
理财赎回(指定收款子帐号)【6100】(暂不提供)
功能描述:
相关说明:
接口字段:
7日年化收益率查询【6040】
功能描述:
相关说明:
接口字段:
会员理财余额查询【6043】
功能描述:
相关说明:
接口字段:
会员每日收益查询【6044】
功能描述:
相关说明:
接口字段:
单笔理财交易查询【6042】
功能描述:
相关说明:
接口字段:
多产品理财
理财开户(支持多产品)【6155】
功能描述:
相关说明:
接口字段:
理财购买(支持多产品)【6156】
功能描述:
相关说明:
接口字段:
理财赎回(支持多产品)【6157】
功能描述:
相关说明:
接口字段:
7日年化收益率查询(支持多产品)【6158】
功能描述:
相关说明:
接口字段:
会员理财余额查询(支持多产品)【6159】
功能描述:
相关说明:
接口字段:
会员每日收益查询(支持多产品)【6160】
功能描述:
相关说明:
接口字段:
单笔理财交易查询(支持多产品)【6161】
功能描述:
相关说明:
接口字段:
风险承受度测评【6148】
功能描述:
相关说明:
接口字段:
风险承受度测评查询【6149】
功能描述:
相关说明:
接口字段:
企业客户开户【6150】
功能描述:
相关说明:
接口字段:
企业开户结果查询【6151】
功能描述:
相关说明:
接口字段:
赎回模式查询【6152】
功能描述:
相关说明:
接口字段:
补款流水查询【6153】
功能描述:
相关说明:
接口字段:
根据补款流水查询交易【6154】
功能描述:
相关说明:
接口字段:
不明来账处理类
不明来账查询【6126】
功能描述:
相关说明:
接口字段:
不明来账挂账清分充值【6127】
功能描述:
相关说明:
接口字段:
不明来账退款【6128】
功能描述:
相关说明:
接口字段:
对账类
查询对账文件信息【6103】
功能描述:
相关说明:
接口字段:
见证+收单接口
查询充值明细(见证+收单)【6146】
功能描述:
相关说明:
接口字段:
调账(见证+收单)【6145】
功能描述:
相关说明:
接口字段:
平台补账(见证+收单)【6147】
功能描述:
相关说明:
接口字段:
对账接口说明
对账文件传送方式:
sftp文件传送方式(暂不提供)
B2BI方式:
对账文件格式
充值流水文件
提现流水文件
交易流水文件
余额文件文件格式
理财购买赎回流水文件格式
理财收益文件格式
批量接口说明
余额批量调整文件触发【6090】(暂不提供)
功能描述:
相关说明:
接口字段:
批量任务进度查询【6091】(暂不提供)
功能描述:
相关说明:
接口字段:
批量处理触发【6201】
功能描述:
接口字段:
批量处理状态查询【6202】
功能描述:
接口字段:
批量交互文件结构描述
批量请求文件描述:
会员间清分轧差触发【6123】(物流专用)
功能描述:
相关说明:
接口字段:
会员间清分轧差状态查询【6124】(物流专用)
功能描述:
相关说明:
接口字段:
会员子账户动账通知【6125】(物流专用)
功能描述:
相关说明:
接口字段:
清分轧差汇总请求文件的文件结构
清分轧差汇总应答文件的文件结构
清分轧差明细文件的文件结构
批量应答文件描述:
支付密码使用说明
使用说明
调用步骤说明
测试说明
支付密码界面图示
附录
接口证件类型说明
联机交易应答码说明
大小额联行号
超级网银号
支持银联验证的银行列表
平安银行电商见证宝(2.0)API 接口文 档 (全量版) ――― 2016 年 4 月 1
版本管理 文档变更过程 版本 修正日期 修正人 描述 V1.0 V1.1 V1.2 V1.3 V1.4 V1.5 V1.6 V1.7 V1.8 2016-4-15 2016-4-18 2016-5-9 2016-6-2 2016-7-7 黄威翔 形成初稿。 黄威翔 修改 6071 接口,增加是否发送短信选项。 黄威翔 优化版面及内容,方便阅读。删除 6071 接口。 黄威翔 新增 6087 理财开户接口 刘耀军 整理增加全量接口 2016-11-10 刘耀军 增加 6061,6108,6109,6110,6111,6114 接口 2016-01-03 刘耀军 增加 6113 接口 2017-02-15 刘耀军 增加联行号文件下载说明 2017-04-14 卢锦波 增加 6119、6201、6202 接口及批量文件结构说明 V1.81 2017-06-06 卢锦波 增加 6123、6124、6125 物流轧差清分及动帐通知接口 V1.82 2017-06-30 刘耀军 新增不明来账处理类接口 6126,6127,6128 V1.83 2017-06-30 刘耀军 新增在途充值(含订单号)和部分撤销接口 6121,6122 V1.84 2017-07-14 卢锦波 新增维护会员绑定提现账户联行号接口 6138 V1.85 2017-07-21 卢锦波 6088 接口保留域 Reserve 字段功能修改为会员昵称字段 V1.86 2017-08-16 张驭天 增加支付验密、短信验密的冻结/解冻、冻结支付接口 6134、6135、6136、6137 V1.87 2017-10-20 杨波 V1.87 2017-10-24 杨波 更新理财开户【6087】、理财购买【6068】、理财赎回 【6069】、会员理财余额查询【6043】、会员每日收益查 询【6044】增加风险承受度测评、风险承受度测评查询接 口、企业开户、企业开户结果查询、赎回模式查询、补款 2
V1.88 2017-10-25 杨波 V1.89 2017-11-30 杨波 流水查询、根据补款流水查询交易 6148、6149、6150、 6151、6152、6153、6154 修改理财开户【6087】、理财赎回【6069】、会员理财余 额查询【6043】、会员每日收益查询【6044】、风险承受 度测评【6148】、风险承受度测评查询【6149】、企业客 户开户【6150】、企业开户结果查询【6151】、赎回模式 查询【6152】、补款流水查询【6153】、根据补款流水查 询交易【6154】 新增理财开户(支持多产品)【6155】、理财购买(支持 多产品)【6156】、理财赎回(支持多产品)【6157】、 7 日年化收益率查询(支持多产品)【6158】、会员理财 余额查询【6159】、会员每日收益查询【6160】、单笔理 财交易查询(支持多产品)【6161】 V1.9 2017-12-1 肖吉涛 新增非自营平台模式。 接口不变:会员子账户开立接口,上送的会员属性 CustProperty 字段增加枚举值,涉及 6000、6088、6104 的 CustProperty 字段增加了枚举值 SH (SH 类型为非自 营模式下商户类型子账户) 接口不变:6092 根据会员代码查询会员子账号接口,返回 字段中的[保留域]字段启用,用于返回会员子账户开立接 口上送的[会员属性]值。 接口不变:6007 冻结接口功能标志 FuncFlag 字段新增枚 举值 4:见证+收单的冻结支付模式的资金解冻。 新增 6162:修改会员属性(普通商户子账户)。用于平台 提前把会员中的需要迁移为商户子账户的会员属性字段 从 00 修改为 SH。该接口为迁移子账户会员属性用。 新增 6145/6146/6147:新增见证+收单的3个新接口。 对账文件针对非自营平台格式有修改、增加订单号和类型 字段(以便区别于原来的交易,原来的交易是用交易网流 水号来做关联、新交易由于是收单发起的可以用订单号来 关联对账)。平台务必要支持,对账文件后续如果继续升 级、在行尾追加新字段、不影响未升级平台的使用。后续 如果对账文件明细增加新字段、不另行通知。 3
V1.91 2017-12-12 肖吉涛 关于收单如何上送子帐号等字段的问题,现补充说明如 下:见证需要的信息,由客户按收单渠道(各渠道不同) 的要求拼装为一个备注字段,填在收单提供接口的 备注/ 见证备注 域。 字段格式: 字段值不要含空格、不要包含回车/换行符。请务必注意不 可包含非法字符,只能是半角英文字母和数字。不可写全 角字符。 金额为两位小数格式,例如 0.01。 橙 E 收款见证备注格式,竖线分隔符,顶格开头 10 位固 定 CES0100000、不要含空格、不要包含回车/换行符: 备注格式码(固定 CES0100000)|平台代码|入账会员子 账户|支付模式(0-冻结支付 1-普通支付)|手续费金额| 橙 E 收款见证备注拼装后填写在橙 E 收款文档的橙 e 收款 交易接口 [4032]字段 RemarkJZB 见证宝业务备注上送 样例: CES0100000|3164|3164000000026138|0|2.00| 快收收单,格式为 json 格式、字段值不可包含空格、不要 包含回车/换行符: json 格式(含备注格式码、平台代码、入账会员子账户、 支付模式(0-冻结支付 1-普通支付)、手续费金额字段) 详见快收提供的【remark 字段的数据组装.txt】格式说明。 快收收单备注格式码固定为 SDS0100000 快收 T1 收单退款,格式为 json 格式、字段值不可包含空 格、不要包含回车/换行符: json 格式(含备注格式码、 0-从冻结退款 1-普通退款(也 即从订单已解冻金额或者普通支付的金额中退款)、从手 续费退款金额|) 详见快收提供的【remark 字段的数据组装.txt】格式说明。 4
快收收单备注格式码固定为 SDT0100000 V1.92 2017-12-18 肖吉涛 因要支持会员间交易退款,新增 4 个接口,会员间交易退 款用于发起退款请求。会员资金支付-支持退款为替代原会 员资金支付接口用,原会员资金支付接口不支持发起退 款。 会员资金支付-支持退款【6163】(不验证) 会员间交易退款【6164】(不验证) 会员资金支付-支持退款【6165】(验密) 会员资金支付-支持退款【6166】(验证短信动态码) V1.93 201712-25 余波 删除作废接口 会员绑定提现账户-不验证 6089 会员子账户开立(注册橙 e 门户)6104 会员子账户开立(注册橙 e 门户-回填短信验证码)6107 会员绑定提现账户-银联鉴权(开通橙 e 付)6105 会员绑定提现账户-回填银联鉴权短信码(开通橙 e 付)6106 会员充值(橙 e 付)6095 会员提现【6005】(验密)6005 会员间交易(第三方理财过账)6113 查询银行单笔交易明细 6014 查询银行单笔交易状态 6094 查询跨行快付退单信息 6118 提现与清分对账接口 6079 会员交易明细对账接口 6080 5
版本管理............................................................................................................................................. 2 总体说明........................................................................................................................................... 10 名词解释 .............................................................................................................................................10 账户结构 .............................................................................................................................................10 资金流向 .............................................................................................................................................12 T+1 提现原则 ......................................................................................................................................14 接口列表 .............................................................................................................................................15 通讯方式说明................................................................................................................................... 15 互联网通讯 .........................................................................................................................................15 专线通讯 .............................................................................................................................................16 通讯报文说明................................................................................................................................... 17 互联网通讯 .........................................................................................................................................17 专线通讯 .............................................................................................................................................22 接口 API 使用说明............................................................................................................................ 26 JAVA 版 API 调用说明.........................................................................................................................26 第二章 详细接口说明 ......................................................................................................................31 联机接口说明................................................................................................................................... 31 会员注册与绑定................................................................................................................................31 会员子账户开立(绑定提现账户-银联鉴权)【6088】................................................................. 31 会员子账户开立(绑定提现账户-回填短信验证码)【6097】..................................................... 33 会员子账户开立【6000】.................................................................................................................34 会员绑定提现账户-银联鉴权【6066】........................................................................................... 36 会员绑定提现账户-回填银联鉴权短信码【6067】....................................................................... 37 会员绑定提现账户-小额转账鉴权【6055】................................................................................... 38 小额转账鉴权验证【6064】.............................................................................................................41 修改会员属性(普通商户子账户)【6162】...................................................................................42 维护会员绑定提现账户联行号【6138】.........................................................................................42 会员绑定信息查询【6098】.............................................................................................................44 会员解绑提现账户【6065】.............................................................................................................46 申请修改手机号码【6083】.............................................................................................................47 回填动态码-修改手机【6084】....................................................................................................... 48 会员充值与提现................................................................................................................................49 会员充值(在途)【6056】.................................................................................................................. 49 会员充值(在途含订单号)【6121】.................................................................................................. 51 交易部分撤销【6122】.....................................................................................................................52 会员提现【6033】(不验证) ...........................................................................................................53 会员提现(支持手续费、短信验证)【6085】...............................................................................56 6
会员提现(支持手续费、支付密码验证)【6111】.......................................................................57 会员批量清分【6053】.....................................................................................................................59 登记挂账【6008】.............................................................................................................................60 会员间交易....................................................................................................................................... 61 查询银行单笔交易状态(6094 优化版)【6110】.............................................................................61 会员间交易(不验密)【6034】.......................................................................................................64 会员间交易(验证短信动态码)【6101】.......................................................................................69 会员交易【6006】(验密)...............................................................................................................72 会员批量交易【6052】(不验证)...................................................................................................75 平台订单管理【6031】.....................................................................................................................75 会员资金冻结【6007】(不验证)...................................................................................................82 会员资金支付【6070】(不验证)...................................................................................................84 会员交易(多借多贷-中转户)【6119】......................................................................................... 75 会员批量交易(验密)【6120】.......................................................................................................81 会员批量交易(验证短信动态码)【6133】...................................................................................79 会员资金冻结(验密)【6134】.......................................................................................................84 会员资金冻结(验证短信动态码)【6135】...................................................................................84 会员资金支付(验密)【6136】.......................................................................................................89 会员资金支付(验证短信动态码)【6137】...................................................................................89 公共交易........................................................................................................................................... 92 交易撤销【6077】...........................................................................................................................100 申请提现或支付短信动态码【6082】...........................................................................................101 查询类交易..................................................................................................................................... 103 查询会员子账号基本信息【6099】(暂不提供).........................................................................103 查询橙 E 门户和橙 E 付状态【6102】............................................................................................127 查询小额往账鉴权的转账状态【6061】.......................................................................................104 查询银行在途清算结果【6108】...................................................................................................120 查询子帐号历史余额及待转可提现状态信息【6114】...............................................................124 查询银行子账户余额【6010】.......................................................................................................104 查询银行提现退票信息【6048】...................................................................................................111 查询普通转账充值明细【6050】...................................................................................................113 查询银行时间段内交易明细【6072】...........................................................................................115 查询银行时间段内清分提现明细【6073】...................................................................................118 查询资金汇总账户余额【6011】...................................................................................................103 查询会员子账号【6037】...............................................................................................................106 根据会员代码查询会员子账号【6092】.......................................................................................106 查询会员子账号余额【6093】.......................................................................................................108 查询银行费用扣收结果【6109】...................................................................................................120 查询明细单验证码【6142】...........................................................................................................124 理财类 ............................................................................................................................................. 127 理财开户【6087】...........................................................................................................................130 7
理财购买【6068】...........................................................................................................................131 理财赎回【6069】...........................................................................................................................133 理财赎回(指定收款子帐号)【6100】(暂不提供) ...................................................................... 135 7 日年化收益率查询【6040】........................................................................................................137 会员理财余额查询【6043】...........................................................................................................139 会员每日收益查询【6044】...........................................................................................................140 单笔理财交易查询【6042】...........................................................................................................142 理财开户(支持多产品)【6155】.................................................................................................144 理财购买(支持多产品)【6156】.................................................................................................146 理财赎回(支持多产品)【6157】.................................................................................................148 7 日年化收益率查询(支持多产品)【6158】..............................................................................150 会员理财余额查询(支持多产品)【6159】.................................................................................151 会员每日收益查询(支持多产品)【6160】.................................................................................153 单笔理财交易查询(支持多产品)【6161】.................................................................................155 风险承受度测评【6148】...............................................................................................................156 风险承受度测评查询【6149】.......................................................................................................158 企业客户开户【6150】...................................................................................................................159 企业开户结果查询【6151】...........................................................................................................162 赎回模式查询【6152】...................................................................................................................164 补款流水查询【6153】...................................................................................................................165 根据补款流水查询交易【6154】...................................................................................................167 不明来账处理类..............................................................................................................................169 不明来账查询【6126】..................................................................................................................169 不明来账挂账清分充值【6127】...................................................................................................171 不明来账退款【6128】..................................................................................................................171 对账类 ............................................................................................................................................. 172 查询对账文件信息【6103】...........................................................................................................172 见证+收单接口................................................................................................................................174 查询充值明细(见证+收单)【6146】...........................................................................................174 调账(见证+收单)【6145】.............................................................................................................. 175 平台补账(见证+收单)【6147】...................................................................................................... 177 会员资金支付-支持退款【6163】(不验证) ................................................................................. 92 会员间交易退款【6164】(不验证) ...............................................................................................96 会员资金支付-支持退款【6165】(验密) ..................................................................................... 95 会员资金支付-支持退款【6166】(验证短信动态码)................................................................. 93 对账接口说明..................................................................................................................................178 对账文件传送方式: .......................................................................................................................178 对账文件格式 ...................................................................................................................................179 批量接口说明..................................................................................................................................182 余额批量调整文件触发【6090】(暂不提供).............................................................................182 8
分享到:
收藏