平安银行电商见证宝(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