一、应用场景
前端系统主动发起批量代扣查询,DSP根据入参的支付批号发送银行并将支付状态等参数返回给前端系统。
二、请求报文
2.1 公共请求参数
参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
BankCode |
线路代码 |
是 |
ALIPAY01 |
渠道代码 |
TransType |
交易类型 |
是 |
9198 |
接口名称,固定为 “ 9198” |
CommandCode |
线路指令 |
是 |
918801 |
接口的分类,由于银行的支付业务分首期代扣、续期代扣等,会有多种接口,因此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 |
RecAct |
收方账号 |
是 |
79102100603450000018 |
|
TotalNum |
总笔数 |
是 |
1 |
|
PayState |
支付状态 |
否 |
5 |
|
RecArea |
收方区域 |
否 |
3301 |
2.3 请求示例
<ATSYH version="5.1.0.0">
<TransReq>
<BankCode>CCB04</BankCode>
<TransType>9198</TransType>
<CommandCode>918801</CommandCode>
<TransSeqID>1430012168</TransSeqID>
<TransParam>
<DetailRecord>
<ReqSeqID>18053100038002</ReqSeqID>
<BgnDate>2018-05-31 10:35:08</BgnDate>
<TotalNum>2</TotalNum>
<RecAct>33001616635059002888</RecAct>
<RecArea>3301</RecArea>
<PayState>5</PayState>
<ResultType>111</ResultType>
<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 |
支付信息 |
否 |
余额不足 |
|
PayAct |
付方卡号 |
否 |
68081001108483 |
|
PayName |
付方户名 |
否 |
张三 |
3.2 响应示例
<ATSYH>
<TransResp>
<BankCode>CCB04</BankCode>
<TransType>9198</TransType>
<TransSeqID>1430012168</TransSeqID>
<TransParam>
<ReqSeqID>18053100038002</ReqSeqID>
<RespCode>0</RespCode>
<RespInfo/>
<TransState/>
<PayInfoCode/>
<DetailRecord>
<PayAct>6227001540005047061</PayAct>
<PayName>张三七</PayName>
<PayAmount>13.00</PayAmount>
<Usage/>
<CurType/>
<Result>3</Result>
<PostScript>直连客户代付专用</PostScript>
<Memo>账号不存在#106001#IBPAZ725##</Memo>
<PayInfoCode>账号不存在#106001#IBPAZ725##</PayInfoCode>
</DetailRecord>
<DetailRecord>
<PayAct>6227001540010102314</PayAct>
<PayName>王九九</PayName>
<PayAmount>12.00</PayAmount>
<Usage/>
<CurType/>
<Result>2</Result>
<PostScript>直连客户代付专用</PostScript>
<Memo>交易成功</Memo>
<PayInfoCode>交易成功</PayInfoCode>
</DetailRecord>
</TransParam>
</TransResp>
</ATSYH>