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