一、应用场景
前端系统主动发起历史余额查询,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>