一、应用场景
前端系统主动发起对账单查询,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>