一、应用场景

前端系统主动发起批量代扣查询,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 请求示例

  1. <ATSYH version="5.1.0.0">
  2. <TransReq>
  3. <BankCode>CCB04</BankCode>
  4. <TransType>9198</TransType>
  5. <CommandCode>918801</CommandCode>
  6. <TransSeqID>1430012168</TransSeqID>
  7. <TransParam>
  8. <DetailRecord>
  9. <ReqSeqID>18053100038002</ReqSeqID>
  10. <BgnDate>2018-05-31 10:35:08</BgnDate>
  11. <TotalNum>2</TotalNum>
  12. <RecAct>33001616635059002888</RecAct>
  13. <RecArea>3301</RecArea>
  14. <PayState>5</PayState>
  15. <ResultType>111</ResultType>
  16. <OfficePurpose/>
  17. </DetailRecord>
  18. </TransParam>
  19. </TransReq>
  20. </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 响应示例

  1. <ATSYH>
  2. <TransResp>
  3. <BankCode>CCB04</BankCode>
  4. <TransType>9198</TransType>
  5. <TransSeqID>1430012168</TransSeqID>
  6. <TransParam>
  7. <ReqSeqID>18053100038002</ReqSeqID>
  8. <RespCode>0</RespCode>
  9. <RespInfo/>
  10. <TransState/>
  11. <PayInfoCode/>
  12. <DetailRecord>
  13. <PayAct>6227001540005047061</PayAct>
  14. <PayName>张三七</PayName>
  15. <PayAmount>13.00</PayAmount>
  16. <Usage/>
  17. <CurType/>
  18. <Result>3</Result>
  19. <PostScript>直连客户代付专用</PostScript>
  20. <Memo>账号不存在#106001#IBPAZ725##</Memo>
  21. <PayInfoCode>账号不存在#106001#IBPAZ725##</PayInfoCode>
  22. </DetailRecord>
  23. <DetailRecord>
  24. <PayAct>6227001540010102314</PayAct>
  25. <PayName>王九九</PayName>
  26. <PayAmount>12.00</PayAmount>
  27. <Usage/>
  28. <CurType/>
  29. <Result>2</Result>
  30. <PostScript>直连客户代付专用</PostScript>
  31. <Memo>交易成功</Memo>
  32. <PayInfoCode>交易成功</PayInfoCode>
  33. </DetailRecord>
  34. </TransParam>
  35. </TransResp>
  36. </ATSYH>