一、应用场景

前端系统主动发起对账单查询,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 请求示例

  1. <ATSYH version="1.0">
  2. <TransReq>
  3. <BankCode>ALIPAY01</BankCode>
  4. <TransType>QryStatement</TransType>
  5. <TransSeqID>025626713</TransSeqID>
  6. <TransTime>2021-07-27 14:56:26</TransTime>
  7. <TransParam>
  8. <ActNum>1234567890123456</ActNum>
  9. <BusDate>20210727</BusDate>
  10. <StatementType>S</StatementType>
  11. </TransParam>
  12. </TransReq>
  13. </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 响应示例

  1. <ATSYH>
  2. <TransResp>
  3. <BankCode>ALIPAY01</BankCode>
  4. <TransType>QryStatement</TransType>
  5. <TransSeqID>191138589</TransSeqID>
  6. <TransParam>
  7. <RespCode>0</RespCode>
  8. <RespInfo />
  9. <ActNum>0502121829200088851</ActNum>
  10. <BusDate>20180810</BusDate>
  11. <StatementType>S</StatementType>
  12. <TotalNum>3</TotalNum>
  13. <DetailRecord>
  14. <BusTime>20180810000000</BusTime>
  15. <AskNumber>28081001109669</AskNumber>
  16. <Amount>815.00</Amount>
  17. <cdFlag />
  18. <TransState>success</TransState>
  19. <RefundState>exception</RefundState>
  20. </DetailRecord>
  21. <DetailRecord>
  22. <BusTime>20180810000000</BusTime>
  23. <AskNumber>28081001109650</AskNumber>
  24. <Amount>5980.88</Amount>
  25. <cdFlag />
  26. <TransState>success</TransState>
  27. <RefundState>exception</RefundState>
  28. </DetailRecord>
  29. </TransParam>
  30. </TransResp>
  31. </ATSYH>