一、应用场景
前端系统主动发起对账单查询,DSP根据入参的保险公司账号及日期,发送银行获取相应的对账单明细返回给前端系统。
二、请求报文
2.1 公共请求参数
参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
BankCode |
线路代码 |
是 |
ALIPAY01 |
渠道代码 |
TransType |
交易类型 |
是 |
QryStatement |
接口名称,固定为 “QryStatement” |
TransSeqID |
指令流水号 |
否 |
030441109 |
指令流水号,全局唯一 |
TransTime |
指令时间 |
否 |
2021-07-27 15:04:41 |
指令时间,格式:yyyy-MM-dd HH:mm:ss |
2.2 请求参数
参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
ActNum |
保险公司账号 |
是 |
12345678 |
发起对账单查询的保险公司账号 |
BusDate |
对账日期 |
是 |
20210727 |
对账单日期,格式:yyyyMMdd |
StatementType |
对账类型 |
否 |
S |
对账单类型(枚举:S-收,F-付,CDE-全部) |
2.3 请求示例
<ATSYH version="1.0">
<TransReq>
<BankCode>ALIPAY01</BankCode>
<TransType>QryStatement</TransType>
<TransSeqID>025626713</TransSeqID>
<TransTime>2021-07-27 14:56:26</TransTime>
<TransParam>
<ActNum>1234567890123456</ActNum>
<BusDate>20210727</BusDate>
<StatementType>S</StatementType>
</TransParam>
</TransReq>
</ATSYH>
三、响应报文
3.1 公共响应参数
参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
BankCode |
线路代码 |
是 |
ALIPAY01 |
渠道代码 |
TransSeqID |
指令流水号 |
否 |
030441109 |
指令流水号,全局唯一 |
3.1 响应参数
参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
RespCode |
响应码 |
是 |
0 |
0:成功,-1:失败 |
RespInfo |
响应信息 |
否 |
成功 |
响应信息描述 |
ActNum |
保险公司账号 |
否 |
12345678 |
发起对账单查询的保险公司账号 |
BusDate |
对账日期 |
是 |
20210727 |
对账单日期,格式:yyyyMMdd |
TotalNum |
总笔数 |
否 |
10 |
对账单明细共10笔 |
StatementType |
对账类型 |
否 |
S |
对账单类型(枚举:S-收,F-付,CDE-全部) |
业务参数 |
|
|
|
|
ReqBatchNO |
交易批号 |
否 |
28081001108487 |
当时支付的批次号 |
AskNumber |
交易流水号 |
是 |
31081541108132 |
当时支付的流水号 |
BusTime |
交易时间 |
是 |
20180810000000 |
交易时间,格式:yyyyMMddHHmmss |
Amount |
交易金额 |
是 |
1243.12 |
交易金额,单位为元,小数点后保留2位 |
Fee |
手续费 |
否 |
2.1 |
交易手续费,单位为元,小数点后保留2位 |
cdFlag |
借贷标志 |
是 |
22 |
22-贷/收,27-借/付 |
TransState |
交易状态 |
是 |
success |
交易状态(枚举:success-成功,fail-失败,paying-支付中) |
RefundState |
退款状态 |
否 |
refund_success |
交易状态(枚举:refund_success-成功,refund_fail-失败,refund_paying-支付中) |
OppAct |
对方账号 |
否 |
18081071696471 |
交易对手方卡号 |
OppActName |
对方户名 |
否 |
张三 |
交易对手方户名 |
OppBank |
对方银行 |
否 |
中国工商银行 |
交易对手方开户行 |
3.2 响应示例
<ATSYH>
<TransResp>
<BankCode>ALIPAY01</BankCode>
<TransType>QryStatement</TransType>
<TransSeqID>191138589</TransSeqID>
<TransParam>
<RespCode>0</RespCode>
<RespInfo />
<ActNum>0502121829200088851</ActNum>
<BusDate>20180810</BusDate>
<StatementType>S</StatementType>
<TotalNum>3</TotalNum>
<DetailRecord>
<BusTime>20180810000000</BusTime>
<AskNumber>28081001109669</AskNumber>
<Amount>815.00</Amount>
<cdFlag />
<TransState>success</TransState>
<RefundState>exception</RefundState>
</DetailRecord>
<DetailRecord>
<BusTime>20180810000000</BusTime>
<AskNumber>28081001109650</AskNumber>
<Amount>5980.88</Amount>
<cdFlag />
<TransState>success</TransState>
<RefundState>exception</RefundState>
</DetailRecord>
</TransParam>
</TransResp>
</ATSYH>