一、应用场景
前端系统主动发起批量代付查询,DSP根据入参的支付批号发送银行并将支付状态等参数返回给前端系统。
二、请求报文
2.1 公共请求参数
| 参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
| BankCode |
线路代码 |
是 |
ALIPAY01 |
渠道代码 |
| TransType |
交易类型 |
是 |
1998 |
接口名称,固定为 “1998” |
| CommandCode |
线路指令 |
是 |
198801 |
接口的分类,由于银行的支付业务分薪资代发、费用报销等,会有多种接口,因此DSP需增加对应指令进行标识 |
| TransSeqID |
指令流水号 |
否 |
030441109 |
指令流水号,全局唯一 |
| TransTime |
指令时间 |
否 |
2021-07-27 15:04:41 |
指令时间,格式:yyyy-MM-dd HH:mm:ss |
2.2 请求参数
| 参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
| ReqSeqID |
支付批号 |
是 |
31357893475834 |
|
| BgnDate |
交易时间 |
是 |
2021-07-06 11:57:01 |
格式:yyyy-MM-dd HH:mm:ss |
| PayAct |
付方账号 |
是 |
79102100603450000018 |
|
| TotalNum |
总笔数 |
是 |
1 |
|
| PayState |
支付状态 |
否 |
5 |
|
| PayArea |
付方区域 |
否 |
3301 |
2.3 请求示例
<ATSYH version="5.1.0.0"> <TransReq> <BankCode>CCB04</BankCode> <TransType>1998</TransType> <CommandCode>198801</CommandCode> <TransSeqID>1620004604</TransSeqID> <TransParam> <DetailRecord> <ReqSeqID>18053000036004</ReqSeqID> <BgnDate>2018-05-30 16:13:46</BgnDate> <PayAct>33001616635059002888</PayAct> <TotalNum>1</TotalNum> <PayState>5</PayState> <PayArea>3301</PayArea> <ResultType>111</ResultType> <OfficePurpose>报销</OfficePurpose> </DetailRecord> </TransParam> </TransReq></ATSYH>
三、响应报文
3.1 公共响应参数
| 参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
| BankCode |
线路代码 |
是 |
ALIPAY01 |
渠道代码 |
| TransType |
交易类型 |
是 |
1998 |
固定为”1998” |
| TransSeqID |
指令流水号 |
否 |
030441109 |
指令流水号,全局唯一 |
3.1 响应参数
| 参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
| RespCode |
响应码 |
是 |
0 |
0:成功,-1:失败 |
| RespInfo |
响应信息 |
否 |
成功 |
响应信息描述 |
| ReqSeqID |
支付批号 |
是 |
28081001108487 |
|
| TransState |
交易状态 |
否 |
M0001 |
|
| PayInfoCode |
支付信息码 |
否 |
M0001 |
|
| 业务参数 |
|
|
|
|
| PostScript |
支付流水号 |
是 |
28081001108487 |
|
| Result |
交易状态 |
是 |
M0001 |
|
| PayInfoCode |
支付信息码 |
是 |
M0001 |
|
| Memo |
支付信息 |
否 |
余额不足 |
|
| RecAct |
收方卡号 |
否 |
68081001108483 |
|
| RecName |
收方户名 |
否 |
张三 |
3.2 响应示例
<ATSYH> <TransResp> <BankCode>CCB04</BankCode> <TransType>1998</TransType> <TransSeqID>1620004604</TransSeqID> <TransParam> <ReqSeqID /> <RespCode /> <RespInfo /> <TransState /> <PayInfoCode /> <DetailRecord> <RecAct>6227001540005047061</RecAct> <RecName /> <PayAmount>2400</PayAmount> <Usage /> <CurType /> <Result>3+</Result> <PostScript>38053000039007</PostScript> <Memo /> <PayInfoCode>3+</PayInfoCode> </DetailRecord> <RespCode>0</RespCode> </TransParam> </TransResp> </ATSYH>