账户余额信息查询

请求参数

• 请求地址

环境	HTTPS请求地址	请求方法
测试环境	https://spin-test.cloudpnr.com/topqur	/acctInfoQuery
生产环境	https://spin.cloudpnr.com/topqur	/acctInfoQuery

• 公共请求参数

请求报文头HEADER - 「接口规则-参数规定-报文头」 ，请求报文体BODY - 「接口规则-参数规定-报文体」

• 请求参数(data)

参数	中文名	类型	必填	最大长度	说明
req_seq_id	请求流水号	String	Y	128
req_date	请求时间	String	Y	8	时间格式:yyyyMMdd
huifu_id	汇付子商户号	String	Y	32	汇付子商户号
acct_id	账户号	String	N	32
acct_type	账户类型	String	N	4

响应参数

• 公共响应参数

参数	中文名	类型	必填	最大长度	说明
resp_code	网关返回码	String	Y	5	网关返回码
resp_desc	网关返回描述	String	Y	512	网关返回描述
sign	签名	String	Y		签名，对报文整体签名
data	交易响应内容体	String	N		务返回参数

• 响应参数(data)

参数	中文名	类型	必填	最大长度	说明
sub_resp_code	业务返回码	String	Y	8	业务返回码
sub_resp_desc	业务返回描述	String	Y	512	业务返回描述
req_seq_id	业务请求流水号	String	Y	128	请求流水号
req_date	业务请求时间	String	Y	8	请求日期YYYYMMDD
acctInfo_list	账户信息列表	LIST	Y		List<AcctInfo>

AcctInfo(账户信息列表)

参数	中文名	类型	必填	最大长度	说明
huifu_id	汇付子商户号	String	Y	32	汇付子商户号
acct_id	账户号	String	Y	32	账户号
acct_type	账户类型	String	Y	4	SPIN账户类型 01:基本户 02:现金户 04:钱包户 05:充值户
balance_amt	账户余额	String	N	2
avl_bal	可用余额	String	N	16
frz_bal	冻结余额	String	N	20

调用示例

• http

{
    "header":{"product_id":"10001","format":"JSON","charset":"UTF-8","version":"1.0.0"},
    "body":{"signType":"RSA2","sign":"fdsafdsfadsfasdfas","data":{"reqSeqId":"454564464564","reqDate":"20200101","productId":"555555","subHuifuId":"00015425862922"}}
}

curl -XPOST http://192.168.25.214:30013/topmer/queryAcctInfo -H 'product_id:TEST' -H 'format:JSON' -H 'charset:UTF-8' -H 'version:1.0.0' -H 'Content-Type:application/json' -H 'top_region_id:default' -d
'{"signType":"RSA2","sign":"fdsafdsfadsfasdfas","data":{"reqSeqId":"454564464564","reqDate":"20200101","productId":"555555","subHuifuId":"00015425862922"}}'

• java

HttpHeaders httpHeaders = new HttpHeaders();
httpHeaders.add("product_id", "1023");
httpHeaders.add("format", "JSON");
httpHeaders.add("charset", "UTF-8");
httpHeaders.add("version", "1.0.0");

AcctInfoQueryReqBO reqBO = new AcctInfoQueryReqBO();
reqBO.setSubHuifuId("88888");
reqBO.setReqDate(DateUtils.getCurrentDateYYYYMMDD());
reqBO.setReqSeqId(UUID.randomUUID().toString());

响应示例

{
    "data":"{"req_date":"20200101","req_seq_id":"1565656763009","huifu_id":"21458523692502","sub_resp_code":"00000000","sub_resp_desc":"成功"}",
    "resp_code":"10000",
    "resp_desc":"成功调用",
    "sign":"KsZembF5a+TodLhxaH0eBWuoZEQ/O6OQPBZsuNVizRMC1rp6/LTgfDBP3XINFT3nZxwS56WqvyKn9o7U9uVxpWXeQTVRw7pdCm87tdnFjB1CgFrVYJsZoVp/gVM3+XroBbn/vciTjTRb85kGdJpudMkFkxqLGdor7SgUmYb0R50pG8Mz2trOszhQ9QwNUMvyDWVpuByuM28x77NZzyf+0zfq1Be3PZwQmrzunpNU87ku5qipvQtogb2SHgXkWF3nWK/w2c3COHtDubpvLMd7RYefHRW45cgIHoy948YG2kJpMleD70OnMJQpmd8I3ADFb5LaS5JUBcMFWsBbGv58eA=="
}