一、应用场景
前端系统主动发起退票查询,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 请求示例
<ATSYH version="5.1.0.0"> <TransReq> <BankCode>NNBill01</BankCode> <TransType>REFUNDTICKET</TransType> <Entity>5000001</Entity> <TransTime>2021-06-24 12:23:43</TransTime> <TransSeqID>1223435142</TransSeqID> <TransParam> <DetailRecord> <PayAct>1001213884201</PayAct> <PayActName>1001213884201-余额明细测试</PayActName> <AreaCode>3100</AreaCode> <AreaName>上海市_上海市</AreaName> <QueeStartDate>2021-06-22</QueeStartDate> <QueeEndDate>2021-06-24</QueeEndDate> </DetailRecord> </TransParam> </TransReq></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 响应示例
<ATSYH> <TransResp> <BankCode>NNBill01</BankCode> <TransType>REFUNDTICKET</TransType> <TransSeqID>20210630160924439</TransSeqID> <TransParam> <RespCode>0</RespCode> <RespInfo/> <ReqSeqID/> <TotleNum>1</TotleNum> <TotleAmount>1024.00</TotleAmount> <DetailRecord> <AskNum>orderid_202106231002440</AskNum> <StrAbstract>104665285</StrAbstract> <PayAct>10012138842</PayAct> <PayActName>安华农业保险股份有限公司</PayActName> <RecBank>招商银行</RecBank> <RecAct>03280******00313</RecAct> <RecActName>毛利小五郎</RecActName> <Amount>1024.00</Amount> <RecAreaName>江苏省</RecAreaName> <Memo>交易备注</Memo> <RefundTicketDate>2021-06-23</RefundTicketDate> <RefundTicketReason>证件号码或姓名与账户不符</RefundTicketReason> <ReqBatchNO>batch_20210623100244</ReqBatchNO> <SubmitTime>2021-06-23</SubmitTime> </DetailRecord> </TransParam> </TransResp></ATSYH>