本网站已支持IPv6

电子账户API

1.接口说明

业务流程:

电子帐户开卡交易:

第1步,调用证件图片上传接口

第2步,调用鉴权接口

第3步,调用短信发送接口

第4步,调用电子帐户开卡交易接口

 

更换绑定账户交易:

第1步,调用短信发送接口

第2步,调用更换绑定帐户接口

1.1.通用参数

(1)请求参数

参数 是否必输 说明
appid 合作方唯一凭证
sign_type 签名算法类型,例:SHA256、HASHANDSHA256
encrypt_data 加密数据
sign 合作方签名串,32位随机字符串,用于签名、加密、HMAC等
timestamp 时间戳,格式:yyyy-MM-dd HH:mm:ss
biz_data 请求参数合集
encrypt_type 加密算法类型,例:AES
deviceid 设备编号
nonce 与时间戳结合防治重放攻击

(2)返回参数

参数 说明
code 网关返回码
msg 网关返回描述
biz_encrypt 业务返回加密内容
biz_content 业务返回内容
sign 网关签名串
responseid 响应日志号

1.2.通用响应码描述

通用响应码

响应码 描述
"4001" 无效的请求路径/后台无此接口
"4002" 应用无权限访问此接口
"4003" 应用访问此接口的权限异常
"4004" 无效的appid,请开发者检查appid的正确性
"5001" 签名验签失败
"5002" 不支持的加密方法
"5003" 重放请求报错
"5004" 请求报文字段缺失
"5005" 请求报文必输字段为空

2.接口列表

API名称 请求入口
鉴权 https://openbank.abchina.com/GateWay/openabc/api/eaccount/autheaccount/v1
证件图片上传接口 https://openbank.abchina.com/GateWay/openabc/api/eaccount/uploadidcard/v1
电子账户开卡交易 https://openbank.abchina.com/GateWay/openabc/api/eaccount/openeaccount/v1
电子账户绑定账户查询 https://openbank.abchina.com/GateWay/openabc/api/eaccount/querybindeaccount/v1
更换绑定账户 https://openbank.abchina.com/GateWay/openabc/api/eaccount/modifyeaccount/v1
账户余额及状态查询 https://openbank.abchina.com/GateWay/openabc/api/eaccount/queryeaccount/v1
电子账户资金转入转出交易 https://openbank.abchina.com/GateWay/openabc/api/eaccount/transfer/v1
电子账户资金转入转出结果查询 https://openbank.abchina.com/GateWay/openabc/api/eaccount/querytransfer/v1
电子账户冻结 https://openbank.abchina.com/GateWay/openabc/api/eaccount/freeze/v1
电子账户解冻 https://openbank.abchina.com/GateWay/openabc/api/eaccount/release/v1
电子账户注销 https://openbank.abchina.com/GateWay/openabc/api/eaccount/canceleaccount/v1
开户短信验证 https://openbank.abchina.com/GateWay/openabc/api/eaccount/verifycode/v1
电子账户明细逆序查询 https://openbank.abchina.com/GateWay/openabc/api/eaccount/querydetail/v1
换绑结果查证 https://openbank.abchina.com/GateWay/openabc/api/eaccount/querymodifyeaccount/v1
开户结果查证 https://openbank.abchina.com/GateWay/openabc/api/eaccount/queryopeneaccount/v1

2.1.鉴权

接口描述:鉴权且无需密码。

请求入口:https://openbank.abchina.com/GateWay/openabc/api/eaccount/autheaccount/v1

沙盒测试请求入口: https://openbank.abchina.com/GateWay/SandBox/openabc/api/eaccount/autheaccount/v1

通用请求参数:见1.1节

特定请求参数:

参数 是否必输 说明
CNNAME 姓名
DIDITYPE 证件类型
DIDI 证件号码
ACC 绑定账号
BANK 绑定账号行别代码
本行:01
他行:02
MOBILE 绑定账号开户手机号
ACCBANK 他行卡联行号,若BANK为02,则该项为必输
AUTH_TYPE 鉴权类型
1.开户
EACCTYPE 根据开2类户或者3类户,上送2或者3
II类户:2
III类户:3
OPBANK 开户网点号,不送则后台选择默认的网点号,送则校验是否在网点号列表中,需与农行人员确认
transTarget 目标机构,需与农行人员确认
acqTrace 流水号
custNo 客户号,送默认值“0000000000000000”
msgType 报文类型,固定送01
reqDate 交易日期,yyyyMMdd
reqTime 交易时间,HHmmss

特定返回参数:

参数 说明
REQ_SEQ_NO 渠道流水号
reqRefTrace 请求流水号
respTrace 返回流水号
respDate 返回日期
respTime 返回时间
respCode 交易返回码,如果以"OT0000"开头,若是本行卡则表示鉴权成功,若是他行卡则表示转入或转出受理成功
errMsg 交易错误信息
respResvFld 返回保留域
respMsg 返回信息

请求的JSON格式:



encrypt_data的加密结构示例:



响应的JSON格式:



biz_encrypt的解密结构示例:


2.2.证件图片上传接口

接口描述:证件图片上传接口。

请求入口:https://openbank.abchina.com/GateWay/openabc/api/eaccount/uploadidcard/v1

沙盒测试请求入口: https://openbank.abchina.com/GateWay/SandBox/openabc/api/eaccount/uploadidcard/v1

通用请求参数:见1.1节

特定请求参数:

参数 是否必输 说明
CNNAME 中文姓名
DIDI 客户证件号
PicName 照片名称
PIC 照片图片
transTarget 目标机构
acqTrace 流水号
custNo 客户号
custSeqNo 客户序号
msgType 报文类型
reqDate 交易日期
reqTime 交易时间

特定返回参数:

参数 说明
fileId 单笔文件ID
reqRefTrace 请求流水号
respTrace 返回流水号
respDate 返回日期
respTime 返回时间
respCode 交易返回码
errMsg 交易错误信息

请求的JSON格式:



encrypt_data的加密结构示例:



7.响应的JSON格式:



biz_encrypt的解密结构示例:


2.3.电子账户开卡交易

接口描述:电子账户开卡交易不需要密码

请求入口:https://openbank.abchina.com/GateWay/openabc/api/eaccount/openeaccount/v1

沙盒测试请求入口: https://openbank.abchina.com/GateWay/SandBox/openabc/api/eaccount/openeaccount/v1

通用请求参数:见1.1节

特定请求参数:

参数 是否必输 说明
CNNAME 姓名
DIDITYPE 证件类型,目前仅支持身份证开卡,身份证:110001
DIDI 证件号码
DIDISTARTTIME 证件有效期起始日期,yyyyMMdd
DIDIENDTIME 证件有效期终止日期,yyyyMMdd
MOBILE 手机号码
NATION 国籍,156(中国)
ADDRESS 联系地址,送客户选的开户省市的中文
ACC 绑定账号
BANK 绑定账号行别代码
本行:01
他行:02
REGBRANCH 开户网点号,不送则后台选择默认的网点号,送则校验是否在网点号列表中,需与农行人员确认
EACCTYPE 电子账户类型,默认为2。
II类户:2
III类户:3
REQ_SEQ_NO 鉴权请求流水号
IDENT_FILE_ID 按照身份证人像照,国徽照的顺序,把两个fileId拼成一个字符串,用“|”(竖线)分隔开
MSGVERLOG 验证码交易流水号
MSGVERNUM 短信验证码
GENDER 性别
男性:1
女性:2
transTarget 目标机构,需与农行人员确认
acqTrace 流水号
custNo 客户号,送默认值“0000000000000000”
msgType 报文类型,固定送01
reqDate 交易日期,yyyyMMdd
reqTime 交易时间,HHmmss

特定返回参数:

参数 说明
ACC_EBANK 电子账户账号
reqRefTrace 请求流水号
respTrace 返回流水号
respDate 返回日期
respTime 返回时间
respCode 交易返回码
errMsg 交易错误信息

请求的JSON格式:



encrypt_data的加密结构示例:



响应的JSON格式:



biz_encrypt的解密结构示例:


2.4.电子账户绑定账户查询

接口描述:电子账户绑定账户查询。

请求入口:https://openbank.abchina.com/GateWay/openabc/api/eaccount/querybindeaccount/v1

沙盒测试请求入口: https://openbank.abchina.com/GateWay/SandBox/openabc/api/eaccount/querybindeaccount/v1

通用请求参数:见1.1节

特定请求参数:

参数 是否必输 说明
ACC_EBANK 电子账户账号
ACC_LAST 末笔查询绑定账号,第一次查询时,输入为空;当翻页时,需要输入上笔查询结果中的最后一个绑定账号
transTarget 目标机构,需与农行人员确认
acqTrace 流水号
custNo 客户号,送默认值“0000000000000000”
msgType 报文类型,固定送01
reqDate 交易日期,yyyyMMdd
reqTime 交易时间,yyyyMMdd

特定返回参数:

参数 说明
NUM 查询条目数
INQFLG 是否有后续输出
否:0
是:1
reqRefTrace 请求流水号
respTrace 返回流水号
respDate 返回日期
respTime 返回时间
respCode 交易返回码,如果以"OT0000"开头,则表示电子账户绑定查询成功
errMsg 交易错误信息
以下为循环体结构
ACC 绑定账号
ACC_BANK_IND 绑定账号本它行标志
本行:01
他行:02
BIND_DAT 绑定日期

请求的JSON格式:



encrypt_data的加密结构示例:



响应的JSON格式:



biz_encrypt的解密结构示例:


2.5.更换绑定账户

接口描述:更换绑定账户不需要密码

请求入口:https://openbank.abchina.com/GateWay/openabc/api/eaccount/modifyeaccount/v1

沙盒测试请求入口: https://openbank.abchina.com/GateWay/SandBox/openabc/api/eaccount/modifyeaccount/v1

通用请求参数:见1.1节

特定请求参数:

参数 是否必输 说明
CNNAME 姓名
DIDITYPE 证件类型
DIDI 证件号码
COD_SEM_AR_BIND_OLD 旧绑定账号
ACC 新绑定账号
BANK 新绑定账号行别代码
本行:01 他行:02
MOBILE 注册手机号
COD_SEM_AR 电子账户账号
OPBANK 电子账户开户网点号,不送则后台选择默认的网点号,送则校验是否在网点号列表中,需与农行人员确认
ACCBANK 他行卡联行号,若新绑定账户为他行卡,则需上送,本行卡不需上送
MSGVERLOG 验证码交易流水号
MSGVERNUM 短信验证码
transTarget 目标机构,需与农行人员确认
acqTrace 流水号
custNo 客户号,送默认值“0000000000000000”
msgType 报文类型,固定送01
reqDate 交易日期,yyyyMMdd
reqTime 交易时间,HHmmss

特定返回参数:

参数 说明
reqRefTrace 请求流水号
respTrace 返回流水号
respDate 返回日期
respTime 返回时间
respCode 交易返回码
errMsg 交易错误信息

请求的JSON格式:



encrypt_data的加密结构示例:



响应的JSON格式:



biz_encrypt的解密结构示例:


2.6.账户余额及状态查询

接口描述:账户余额及状态查询。

请求入口:https://openbank.abchina.com/GateWay/openabc/api/eaccount/queryeaccount/v1

沙盒测试请求入口: https://openbank.abchina.com/GateWay/SandBox/openabc/api/eaccount/queryeaccount/v1

通用请求参数:见1.1节

特定请求参数:

参数 是否必输 说明
ACC 二类户卡号
transTarget 目标机构,需与农行人员确认
acqTrace 流水号
custNo 客户号,送默认值“0000000000000000”
msgType 报文类型,固定送01
reqDate 交易日期,yyyyMMdd
reqTime 交易时间,HHmmss

特定返回参数:

参数 说明
BALANCE 卡余额,请求成功则该字段非空
ACCSTATE 卡状态
AMT_SECU_ACC_AVL 可用余额
FREEZE_AVL 冻结金额
respResvFld 返回保留域
respMsg 返回信息
reqRefTrace 请求流水号
respTrace 返回流水号
respDate 返回日期
respTime 返回时间
respCode 交易返回码,如果以"OT0000"开头,则表示账户余额与状态查询成功
errMsg 交易错误信息

请求的JSON格式:



encrypt_data的加密结构示例:



响应的JSON格式:



biz_encrypt的解密结构示例:


2.7.电子账户资金转入转出交易

接口描述:电子账户资金转入转出交易。

请求入口:https://openbank.abchina.com/GateWay/openabc/api/eaccount/transfer/v1

沙盒测试请求入口: https://openbank.abchina.com/GateWay/SandBox/openabc/api/eaccount/transfer/v1

通用请求参数:见1.1节

特定请求参数:

参数 是否必输 说明
ACC_EBANK 电子账户账号
ACC 绑定账号
AMT 交易金额
TRANSFER_FLAG 转入转出方向
0-从电子账户转出
1-转入电子账户
ACC_BANK_IND 绑定账号本它行标志
01 本行账户
02 他行账户
OpBank 电子账户开户网点号,不送则后台选择默认的网点号,送则校验是否在网点号列表中,需与农行人员确认
BuyIP 用户ip
1绑定账户为他行账户时,必输,上送真实用户IP,如无法获取则上送服务器IP。
2绑定账户为本行账户时,选输。
CNNAME 客户名称
1绑定账户为他行账户时,必输。
2绑定账户为本行账户时,选输。
ORDERNO 订单号
transTarget 目标机构需与农行人员确认
acqTrace 流水号
custNo 客户号,送默认值“0000000000000000”
msgType 报文类型,固定送01
reqDate 交易日期,yyyyMMdd
reqTime 交易时间,HHmmss

特定返回参数:

参数 说明
ACC_EBANK_AVL_BAL 电子账户可用余额
MERCHANTID 商户号,绑定卡是他行卡时非空
ORDERNO 订单号,绑定卡是他行卡时非空
reqRefTrace 请求流水号
respTrace 返回流水号
respDate 返回日期
respTime 返回时间
respCode 交易返回码,如果以"OT0000"开头,则表示资金转入成功
errMsg 交易错误信息
respResvFld 返回保留域
ACC_EBANK 电子账户号
respMsg 返回信息

请求的JSON格式:



encrypt_data的加密结构示例:



响应的JSON格式:



biz_encrypt的解密结构示例:


2.8.电子账户资金转入转出结果查询

接口描述:电子账户资金转入转出结果查询。

请求入口:https://openbank.abchina.com/GateWay/openabc/api/eaccount/querytransfer/v1

沙盒测试请求入口: https://openbank.abchina.com/GateWay/SandBox/openabc/api/eaccount/querytransfer/v1

通用请求参数:见1.1节

特定请求参数:

参数 是否必输 说明
PayTypeID 支付类型,目前开放银行场景都是直接支付,固定ImmediatePay
MerchantID 商e付商户号。电子账户资金转入转出交易(API)涉及他行卡交易时返回报文参数,H5转入转出涉及他行卡交易时完成回调后会返回。
OrderNo 订单号。电子账户资金转入转出交易(API)涉及他行卡交易时返回报文参数,H5转入转出涉及他行卡交易时完成回调后会返回。

特定返回参数:

参数 说明
MerchantID 商户号,与上送报文一致
OrderInfo 订单信息。注意,此字段是base64编码后的密文,需要base64解码成明文,编码方式是utf-8。
PayTypeID 支付类型
OrderNo 订单号
OrderDate 订单日期
OrderTime 订单时间
OrderAmount 交易金额
Status 订单状态。04表示支付成功,其他表示未成功。
RetCode 交易返回码
RetMsg 交易返回信息

请求的JSON格式:



encrypt_data的加密结构示例:


响应的JSON格式:



biz_encrypt的解密结构示例:


其中OrderInfo base64解码之后报文如下:

2.9.电子账户冻结

接口描述:电子账户冻结。

请求入口:https://openbank.abchina.com/GateWay/openabc/api/eaccount/freeze/v1

沙盒测试请求入口: https://openbank.abchina.com/GateWay/SandBox/openabc/api/eaccount/freeze/v1

通用请求参数:见1.1节

特定请求参数:

参数 是否必输 说明
Cardno 卡号
AMT_FRZ 冻结金额
NUM_PRE_AUTH 授权码
COD_CHANL 渠道标志,需要和农行人员确认输入内容
COD_RSN_FRZ 冻结原因码,默认送2610,需要和农行人员确认输入内容
TXT_ABS_ABIS 冻结原因说明
DATE_END
transTarget 目标机构,需与农行人员确认
acqTrace 流水号
custNo 客户号,送默认值“0000000000000000”
msgType 报文类型,固定送01
reqDate 交易日期,yyyyMMdd
reqTime 交易时间,HHmmss

特定返回参数:

参数 说明
NUM_JRN_NO_FRZ 冻结日志号
AMT_TR_PDS 生效冻结金额
BAL_AR_AVL_PDS 轮候冻结金额
BAL_AR_PDS 未冻结金额
DATE_FRZ 对应冻结日期
reqRefTrace 请求流水号
respTrace 返回流水号
respDate 返回日期
respTime 返回时间
respCode 交易返回码,如果以"OT0000"开头,则表示账户资金冻结成功
errMsg 交易错误信息
respResvFld 返回保留域
respMsg 返回信息

请求的JSON格式:



encrypt_data的加密结构示例:


响应的JSON格式:



biz_encrypt的解密结构示例:


2.10.电子账户解冻

接口描述:电子账户解冻。

请求入口:https://openbank.abchina.com/GateWay/openabc/api/eaccount/release/v1

沙盒测试请求入口: https://openbank.abchina.com/GateWay/SandBox/openabc/api/eaccount/release/v1

通用请求参数:见1.1节

特定请求参数:

参数 是否必输 说明
Cardno 卡号
DATE_FRZ 对应冻结日期
NUM_JRN_NO_FRZ 对应冻结日志号,必须填写存在的冻结交易日志号
AMT_FRZ 冻结金额
COD_CHANL 渠道标志,需要和农行人员确认输入内容
COD_RSN_FRZ 冻结原因码,默认送2610
TXT_ABS_ABIS 冻结原因说明
transTarget 目标机构,需与农行人员确认
acqTrace 流水号
custNo 客户号,送默认值“0000000000000000”
msgType 报文类型,固定送01
reqDate 交易日期,yyyyMMdd
reqTime 交易时间,HHmmss

特定返回参数:

参数 说明
reqRefTrace 请求流水号
respTrace 返回流水号
respDate 返回日期
respTime 返回时间
respCode 交易返回码,如果以"OT0000"开头,则表示账户资金解冻成功
errMsg 交易错误信息
respResvFld 返回保留域
respMsg 返回信息

请求的JSON格式:



encrypt_data的加密结构示例:


响应的JSON格式:



biz_encrypt的解密结构示例:


2.11.电子账户注销

接口描述:电子账户销户。

请求入口:https://openbank.abchina.com/GateWay/openabc/api/eaccount/canceleaccount/v1

沙盒测试请求入口: https://openbank.abchina.com/GateWay/SandBox/openabc/api/eaccount/canceleaccount/v1

通用请求参数:见1.1节

特定请求参数:

参数 是否必输 说明
msgType 报文类型,固定送01
transTarget 目标机构,一般是两位数的省市代码
reqDate 交易日期,yyyyMMdd
reqTime 交易时间,HHmmss
acqTrace 流水号
custNo 客户号,送默认值“0000000000000000”
CNNAME 客户中文姓名
DIDITYPE 证件类型
DIDI 证件号码
ACC 绑定账号
ACC_EBANK 电子账户号
BANK 新绑定账号行别代码 本行:01 他行:02
MOBILE 手机号
OPBANK 电子账户开户网点号
MSGVERLOG 验证码交易流水号
MSGVERNUM 短信验证码

特定返回参数:

参数 说明
MSGVERLOG 验证码交易流水号
reqRefTrace 请求流水号
respTrace 返回流水号
respDate 返回日期
respTime 返回时间
respCode 交易返回码,如果以"OT0000"开头,则表示销户成功
errMsg 交易错误信息
ACC_EBANK 电子账户账号
respMsg 返回信息

请求的JSON格式:



encrypt_data的加密结构示例:


响应的JSON格式:



biz_encrypt的解密结构示例:


2.12.开户短信验证

接口描述:短信发送。

请求入口:https://openbank.abchina.com/GateWay/openabc/api/eaccount/verifycode/v1

沙盒测试请求入口: https://openbank.abchina.com/GateWay/SandBox/openabc/api/eaccount/verifycode/v1

通用请求参数:见1.1节

特定请求参数:

参数 是否必输 说明
Phone 手机号码
SmsType 短信验证码类型,1代表开户时发信息,2代表更换绑定账户时发信息,3代表销户时发送
Branch 网点号,不送则后台选择默认的网点号,送则校验是否在网点号列表中,需与农行人员确认
EaccType 账户类型
2:二类电子账户
3:三类电子账户
transTarget 目标机构,需与农行人员确认
acqTrace 流水号
custNo 客户号,送默认值“0000000000000000”
msgType 报文类型,固定送01
reqDate 交易日期,yyyyMMdd
reqTime 交易时间,HHmmss

特定返回参数:

参数 说明
MSGVERLOG 验证码交易流水号
reqRefTrace 请求流水号
respTrace 返回流水号
respDate 返回日期
respTime 返回时间
respCode 交易返回码
errMsg 交易错误信息
respResvFld 返回保留域
respMsg 返回信息

请求的JSON格式:



encrypt_data的加密结构示例:



响应的JSON格式:



biz_encrypt的解密结构示例:


2.13电子账户明细逆序查询

接口描述:查询电子账户明细。

请求入口:https://openbank.abchina.com/GateWay/openabc/api/eaccount/querydetail/v1

沙盒测试请求入口: https://openbank.abchina.com/GateWay/SandBox/openabc/api/eaccount/querydetail/v1

通用请求参数:见1.1节

特定请求参数:

参数 是否必输 中文名称
reqAppID 应用标志
msgType 报文类型,固定送01
transTarget 目标机构,需与农行人员确认
reqDate 交易日期,yyyyMMdd
reqTime 交易时间,HHmmss
acqTrace 流水号
custNo 客户号,送默认值“0000000000000000”
StartDate 开始日期,yyyyMMdd
EndDate 结束日期,yyyyMMdd
KeyNext 续查键值,第1页为空,后续再查询时将上一笔应答返回的keyNext赋值给该续查键值
AccNo 账户号
AccType 账户类型
2:二类电子账户
3:三类电子账户

特定返回参数:

参数 中文名称
reqRefTrace 请求流水号
respTrace 返回流水号
respDate 返回日期
respTime 返回时间
respCode 交易返回码
errMsg 交易错误信息
KeyNext 续查键值,第1页为空,后续再查询时将上一笔应答返回的keyNext赋值给该续查键值
ProductType 产品类型
RecordNum 返回的结果条目数
HasNext 后继查询标志
QryAbs 查询说明
FieldNm 明细表头项
QryDeLst 活期账户明细

请求的JSON格式:



encrypt_data的加密结构示例:



响应的JSON格式:



biz_encrypt的解密结构示例:


2.14更换绑定账户结果查询

接口描述:更换绑定账户结果查询。

请求入口:https://openbank.abchina.com/GateWay/openabc/api/eaccount/querymodifyeaccount/v1

沙盒测试请求入口: https://openbank.abchina.com/GateWay/SandBox/openabc/api/eaccount/querymodifyeaccount/v1

通用请求参数:见1.1节

特定请求参数:

参数 是否必输 中文名称
msgType 报文类型
transTarget 目标机构
reqDate 交易日期
reqTime 交易时间,yyyyMMdd
acqTrace 流水号
custNo 客户号
ReqSeqNo 换绑交易流水号
EAcc 账号
Name 姓名

特定返回参数:

参数 中文名称
reqRefTrace 交易流水号
respTrace 交易日志号
respDate 交易日期
respTime 交易时间
respCode 返回码
errMsg 错误信息
bgRespCode 后台返回码
bgErrMsg 后台返回错误信息
Status 返回码
ReasonMsg 返回信息

请求的JSON格式:



encrypt_data的加密结构示例:



响应的JSON格式:



biz_encrypt的解密结构示例:


2.15开户结果查询接口

接口描述:开户结果查询。

请求入口:https://openbank.abchina.com/GateWay/openabc/api/eaccount/queryopeneaccount/v1

沙盒测试请求入口:https://openbank.abchina.com/GateWay/SandBox/openabc/api/eaccount/queryopeneaccount/v1

通用请求参数:见1.1节

特定请求参数:

参数 是否必输 中文名称
acqTrace 渠道请求流水号
reqDate 请求日期
reqTime 请求时间
custNo 客户号
msgType 报文类型代码
transTarget 目标省市代码
cnName 姓名
didiType 证件类型
didi 证件号码
identStartTime 证件起始时间,yyyyMMdd
identEndTime 证件过期时间,yyyyMMdd
accType 账户类型,2:二类户;3:三类户
reserve1 备用1
reserve2 备用2
reserve3 备用3

特定返回参数:

参数 中文名称
reqRefTrace 前端请求流水号
respTrace 响应流水号
respDate 响应日期
respTime 响应时间
respCode 返回码
errMsg 返回信息
bgRespCode 后台返回码
bgErrMsg 后台返回信息
eAccount 开出来的二类电子账户号
reserve1 备用1
reserve2 备用2
reserve3 备用3

请求的JSON格式:



encrypt_data的加密结构示例:



响应的JSON格式:



biz_encrypt的解密结构示例:


3.常见错误码

常见错误码列表:

错误码 错误信息 错误说明
OTAu01 身份信息验证超时 他行卡鉴权响应超时
OTAu04 输入手机号与预留手机号不符
FBAU01 身份证识别失败,请重新上传 照片反光、模糊等原因导致
FBAU02 身份证错误,请重新上传 身份证照片不对
FBAU03 姓名或身份证号有误,请重新输入 一般为姓名和身份证号不匹配
FBAU04 身份证人像比对失败,请重新拍摄
AUTH01 持卡人身份信息或手机号输入不正确,验证失败
AUTH02 该账户未开通消息服务无法完成绑定验证,请绑定本人其他借记卡
EAOP02 预留客户信息不完整,无法办理开户业务
EAOP03 留存证件已过期,无法办理开户业务
AB1431 已开卡 已经开立电子账户
BZUPM1 手机号错误
BZUPM2(或BZUPM5) 验证码错误
BZUPM4 验证码已失效 验证码有效时间为2分钟
SY0000 系统错误,请稍后重试 一般为人脸或OCR识别失败
VR0020 校验失败,长度非法 手机号、卡号或身份证号等格式不正确
EAAH02 输入手机号与银行预留手机号不一致
EAAH03 银行预留手机号为空,请到我行网点办理
EAAH04 客户手机号未验证,请到我行网点办理
EA0734 证件号格式不正确
OT0999 系统异常 一般为跨行转账失败
AB5072 非同一客户
EAAQ01 联网核查失败
EAOB02 开户网点信息不存在
EAUTH3(或EAUTH4) 目前仅支持绑定农行、工行、中行、建行、交行、邮储借记卡,请确认卡号输入完整正确
中国农业银行版权所有 |  京ICP备05049539