业务流程:
电子帐户开卡交易:
第1步,调用证件图片上传接口
第2步,调用鉴权接口
第3步,调用短信发送接口
第4步,调用电子帐户开卡交易接口
更换绑定账户交易:
第1步,调用短信发送接口
第2步,调用更换绑定帐户接口
(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 | 响应日志号 |
通用响应码
响应码 | 描述 |
---|---|
"4001" | 无效的请求路径/后台无此接口 |
"4002" | 应用无权限访问此接口 |
"4003" | 应用访问此接口的权限异常 |
"4004" | 无效的appid,请开发者检查appid的正确性 |
"5001" | 签名验签失败 |
"5002" | 不支持的加密方法 |
"5003" | 重放请求报错 |
"5004" | 请求报文字段缺失 |
"5005" | 请求报文必输字段为空 |
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 |
接口描述:鉴权且无需密码。
请求入口: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的解密结构示例:
接口描述:证件图片上传接口。
请求入口: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的解密结构示例:
接口描述:电子账户开卡交易不需要密码
请求入口: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的解密结构示例:
接口描述:电子账户绑定账户查询。
请求入口: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的解密结构示例:
接口描述:更换绑定账户不需要密码
请求入口: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的解密结构示例:
接口描述:账户余额及状态查询。
请求入口: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的解密结构示例:
接口描述:电子账户资金转入转出交易。
请求入口: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的解密结构示例:
接口描述:电子账户资金转入转出结果查询。
请求入口: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解码之后报文如下:
接口描述:电子账户冻结。
请求入口: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的解密结构示例:
接口描述:电子账户解冻。
请求入口: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的解密结构示例:
接口描述:电子账户销户。
请求入口: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的解密结构示例:
接口描述:短信发送。
请求入口: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的解密结构示例:
接口描述:查询电子账户明细。
请求入口: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的解密结构示例:
接口描述:更换绑定账户结果查询。
请求入口: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的解密结构示例:
接口描述:开户结果查询。
请求入口: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的解密结构示例:
常见错误码列表:
错误码 | 错误信息 | 错误说明 |
---|---|---|
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) | 目前仅支持绑定农行、工行、中行、建行、交行、邮储借记卡,请确认卡号输入完整正确 |