一、应用场景

前端系统主动发起退票查询,DSP根据入参的保险公司账号及日期范围,发送银行获取指定日期范围的退票明细返回给前端系统。

二、请求报文

2.1 公共请求参数

参数 中文名称 是否必填 示例值 描述
BankCode 线路代码 ALIPAY01 渠道代码
TransType 交易类型 REFUNDTICKET 接口名称,固定为 “REFUNDTICKET”
TransSeqID 指令流水号 030441109 指令流水号,全局唯一
TransTime 指令时间 2021-07-27 15:04:41 指令时间,格式:yyyy-MM-dd HH:mm:ss

2.2 请求参数

参数 中文名称 是否必填 示例值 描述
PayAct 保险公司账号 12345678 发起退票查询的保险公司账号
PayActName 保险公司户名 余额明细测试
AreaCode 区域代码 3100
AreaName 区域名称 上海市_上海市
QueeStartDate 开始日期 2021-06-22 开始日期,格式:yyyy-MM-dd
QueeEndDate 结束日期 2021-06-24 结束日期,格式:yyyy-MM-dd

2.3 请求示例

  1. <ATSYH version="5.1.0.0">
  2. <TransReq>
  3. <BankCode>NNBill01</BankCode>
  4. <TransType>REFUNDTICKET</TransType>
  5. <Entity>5000001</Entity>
  6. <TransTime>2021-06-24 12:23:43</TransTime>
  7. <TransSeqID>1223435142</TransSeqID>
  8. <TransParam>
  9. <DetailRecord>
  10. <PayAct>1001213884201</PayAct>
  11. <PayActName>1001213884201-余额明细测试</PayActName>
  12. <AreaCode>3100</AreaCode>
  13. <AreaName>上海市_上海市</AreaName>
  14. <QueeStartDate>2021-06-22</QueeStartDate>
  15. <QueeEndDate>2021-06-24</QueeEndDate>
  16. </DetailRecord>
  17. </TransParam>
  18. </TransReq>
  19. </ATSYH>

三、响应报文

3.1 公共响应参数

参数 中文名称 是否必填 示例值 描述
BankCode 线路代码 ALIPAY01 渠道代码
TransType 交易类型 REFUNDTICKET 固定为”REFUNDTICKET”
TransSeqID 指令流水号 030441109 指令流水号,全局唯一

3.1 响应参数

参数 中文名称 是否必填 示例值 描述
RespCode 响应码 0 0:成功,-1:失败
RespInfo 响应信息 成功 响应信息描述
ReqSeqID 支付批号 12345678 发起退票查询的保险公司账号
TotalNum 总笔数 21
TotleAmount 总金额 100.00 单位为元,保留小数点后两位
业务参数
ReqBatchNO 交易批号 28081001108487 当时支付的批次号
AskNum 交易流水号 31081541108132 当时支付的流水号
PayAct 保险方账号 10012138842
PayActName 保险方户名 安华农业保险股份有限公司
RecAct 对方账号 03280**00313
RecActName 对方户名 毛利小五郎
RecBank 对方开户行 招商银行
RefundTicketDate 退票日期 2021-07-28 退票日期,格式:yyyy-MM-dd
Amount 退回金额 1243.12 退回金额,单位为元,小数点后保留2位
RefundTicketReason 退票原因 卡号不存在 交易手续费,单位为元,小数点后保留2位
Memo 备注 退费
SubmitTime 交易时间 success 交易日期,格式:yyyy-MM-dd

3.2 响应示例

  1. <ATSYH>
  2. <TransResp>
  3. <BankCode>NNBill01</BankCode>
  4. <TransType>REFUNDTICKET</TransType>
  5. <TransSeqID>20210630160924439</TransSeqID>
  6. <TransParam>
  7. <RespCode>0</RespCode>
  8. <RespInfo/>
  9. <ReqSeqID/>
  10. <TotleNum>1</TotleNum>
  11. <TotleAmount>1024.00</TotleAmount>
  12. <DetailRecord>
  13. <AskNum>orderid_202106231002440</AskNum>
  14. <StrAbstract>104665285</StrAbstract>
  15. <PayAct>10012138842</PayAct>
  16. <PayActName>安华农业保险股份有限公司</PayActName>
  17. <RecBank>招商银行</RecBank>
  18. <RecAct>03280******00313</RecAct>
  19. <RecActName>毛利小五郎</RecActName>
  20. <Amount>1024.00</Amount>
  21. <RecAreaName>江苏省</RecAreaName>
  22. <Memo>交易备注</Memo>
  23. <RefundTicketDate>2021-06-23</RefundTicketDate>
  24. <RefundTicketReason>证件号码或姓名与账户不符</RefundTicketReason>
  25. <ReqBatchNO>batch_20210623100244</ReqBatchNO>
  26. <SubmitTime>2021-06-23</SubmitTime>
  27. </DetailRecord>
  28. </TransParam>
  29. </TransResp>
  30. </ATSYH>