一、应用场景
前端系统主动发起历史余额查询,DSP根据入参的保险公司账号及日期范围,发送银行获取指定日期范围内相应的当前余额、可用余额、余额日期等参数返回给前端系统。
二、请求报文
2.1 公共请求参数
| 参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
| BankCode |
线路代码 |
是 |
ALIPAY01 |
渠道代码 |
| TransType |
交易类型 |
是 |
7505 |
接口名称,固定为 “7505” |
| TransSeqID |
指令流水号 |
否 |
030441109 |
指令流水号,全局唯一 |
| TransTime |
指令时间 |
否 |
2021-07-27 15:04:41 |
指令时间,格式:yyyy-MM-dd HH:mm:ss |
2.2 请求参数
| 参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
| ActNum |
保险公司账号 |
是 |
12345678 |
发起余额查询的保险公司账号 |
| ActArea |
区域 |
否 |
4013 |
标准区域,部分渠道需要转换会取映射码区域 |
| ActCur |
币种 |
否 |
1 |
标准币种 |
| DateFrom |
开始日期 |
是 |
20210721 |
格式:yyyyMMdd |
| DateTo |
结束日期 |
是 |
20210728 |
格式:yyyyMMdd |
2.3 请求示例
<ATSYH> <TransReq> <BankCode>ALIPAY01</BankCode> <TransType>7505</TransType> <TransSeqID>20190904174202879</TransSeqID> <TransTime>2019-09-04 17:42:02</TransTime> <TransParam> <ActNum>1234567890123456</ActNum> <ActArea>4013</ActArea> <ActCur>1</ActCur> <DateFrom>20210721</DateFrom> <DateTo>20210728</DateTo> </TransParam> </TransReq></ATSYH>
三、响应报文
3.1 公共响应参数
| 参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
| BankCode |
线路代码 |
是 |
ALIPAY01 |
渠道代码 |
| TransType |
交易类型 |
是 |
7505 |
接口名称,固定为 “7505” |
| TransSeqID |
指令流水号 |
否 |
030441109 |
指令流水号,全局唯一 |
3.1 响应参数
| 参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
| RespCode |
响应码 |
是 |
0 |
0:成功,-1:失败 |
| RespInfo |
响应信息 |
否 |
成功 |
响应信息描述 |
| 业务参数 |
|
|
|
|
| ActBal |
当前余额 |
是 |
12000.00 |
单位为元,小数点后保留2位 |
| AvailBal |
可用余额 |
是 |
2000.00 |
单位为元,小数点后保留2位 |
| BalDate |
余额日期 |
否 |
20210728 |
格式:yyyyMMdd |
3.2 响应示例
<ATSYH> <TransResp> <BankCode>ALIPAY01</BankCode> <TransType>7505</TransType> <TransSeqID>20190904174723317</TransSeqID> <TransParam> <RespCode>0</RespCode> <RespInfo></RespInfo> <DetailRecord> <ActBal>12000.00</ActBal> <AvailBal>2000.00</AvailBal> <BalDate>20210728</BalDate> </DetailRecord> </TransParam> </TransResp></ATSYH>