一、应用场景

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