一、应用场景

前端系统主动发起退票查询,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>