一、应用场景

前端系统主动发起批量代付提交,DSP根据入参的收方、付方信息,发送渠道方进行批量代付,并将支付状态等参数返回给前端系统。

二、请求报文

2.1 公共请求参数

参数 中文名称 是否必填 示例值 描述
BankCode 线路代码 是 ALIPAY01 渠道代码
TransType 交易类型 是 1988 接口名称,固定为 “1988”
CommandCode 线路指令 是 198801 接口的分类,由于银行的支付业务分薪资代发、费用报销等,会有多种接口,因此DSP需增加对应指令进行标识
TransSeqID 指令流水号 否 030441109 指令流水号,全局唯一
TransTime 指令时间 否 2021-07-27 15:04:41 指令时间,格式:yyyy-MM-dd HH:mm:ss
TotalNum 总笔数 是 1
TotalAmt 总金额 是 1200.00 单位为元,保留小数点后两位

2.2 请求参数

参数 中文名称 是否必填 示例值 描述
ReqSeqID 支付批号 是 18053000036004
PayAct 付方账号 是 33001616635059002888
PayArea 付方区域 否 3301
PayAreaName 付方区域名称 否 浙江省_杭州市
业务参数
PayAct 付方账号 是 79102100603450000018
PayName 付方名称 是 名侦探悟空
PayBankCode 付方银行代码 是 102 银行大类代码
PayBankName 付方银行名称 是 昆仑银行股份有限公司 银行大类名称
PayBnk 付方开户行 否 昆仑银行股份有限公司
PayArea 付方区域代码 是 6502
PayAreaName 付方区域名称 是 新疆维吾尔自治区_克拉玛依市
RecAct 收方账号 是 6217661145901883428
RecName 收方名称 是 姬俞
RecBankCode 收方银行代码 是 102 银行大类代码
RecBankName 收方银行名称 是 昆仑银行股份有限公司 银行大类名称
RecBnk 收方开户行 否 昆仑银行股份有限公司
RecArea 收方区域代码 是 6502
RecAreaName 收方区域名称 是 新疆维吾尔自治区_克拉玛依市
SameBnk 是否同行 是 1 枚举:1-同行,0-跨行
SameCity 是否同城 是 1 枚举:1-同城,0-异地
PayDate 交易日期 是 2019-08-07 格式:yyyy-MM-dd
PayTime 交易时间 是 15:30:13 格式:HH:mm:ss
PayAmount 交易金额 是 667.00 单位为元,保留小数点后两位
PayCur 付方币种 否 1 标准币种
RecCur 收方币种 否 1 标准币种
Usage 用途 否
ReqSeqID 支付流水号 是 29080702394102
PostScript 对账码 是 39080701145385
Memo 备注 否
IsPrivate 对公对私标识 否 枚举:1-对私,0/2-对公
CNAPSCode 联行号 否 313882000012
CNAPSName 联行名 否 昆仑银行股份有限公司
SourceNoteCode 保单号 否
CertType 证件类型 否 1 标准证件类型
CertNum 证件号 否 313882000012

2.3 请求示例

  1. <ATSYH version="5.1.0.0">
  2. <TransReq>
  3. <BankCode>CCB04</BankCode>
  4. <TransTime>2018-05-30 16:13:46</TransTime>
  5. <TransType>1988</TransType>
  6. <CommandCode>198801</CommandCode>
  7. <TransSeqID>1613469584</TransSeqID>
  8. <TotalNum>1</TotalNum>
  9. <TotalAmt>2400.00</TotalAmt>
  10. <TransParam>
  11. <ReqSeqID>18053000036004</ReqSeqID>
  12. <PaySpd>0</PaySpd>
  13. <PsselNum>PS0_0001002018053000081011</PsselNum>
  14. <PayAct>33001616635059002888</PayAct>
  15. <PayArea>3301</PayArea>
  16. <PayAreaName>浙江省_杭州市</PayAreaName>
  17. <SubmitId/>
  18. <DetailRecord>
  19. <PayName>信泰人寿保险股份有限公司</PayName>
  20. <PayAct>33001616635059002888</PayAct>
  21. <PayBnk>中国建设银行股份有限公司杭州秋涛支行</PayBnk>
  22. <PayArea>3301</PayArea>
  23. <RecBankName>中国建设银行</RecBankName>
  24. <RecBankCode>105</RecBankCode>
  25. <RecName>张三七</RecName>
  26. <RecAct>6227001540005047061</RecAct>
  27. <RecBnk>中国建设银行浙江省分行临安支行万事达分理处</RecBnk>
  28. <RecArea>3301</RecArea>
  29. <RecAreaName>浙江省_杭州市</RecAreaName>
  30. <RecStandardArea>浙江省_杭州市</RecStandardArea>
  31. <SameCity>1</SameCity>
  32. <SameBnk>1</SameBnk>
  33. <PayDate>2018-05-30</PayDate>
  34. <PayTime>16:13:46</PayTime>
  35. <PayAmount>2400.00</PayAmount>
  36. <PaySpd>0</PaySpd>
  37. <IsPrivate>1</IsPrivate>
  38. <PayCur>1</PayCur>
  39. <RecCur>1</RecCur>
  40. <CertType/>
  41. <CertNum/>
  42. <CreditCardSecCode/>
  43. <CreditCardValidity/>
  44. <Purpose/>
  45. <Usage>报销</Usage>
  46. <PostScript>28053000052004</PostScript>
  47. <Memo>信泰付款-</Memo>
  48. <ReqReserve>38053000039007</ReqReserve>
  49. <CNAPSCode>105331024066</CNAPSCode>
  50. <CNAPSName>中国建设银行浙江省分行临安支行万事达分理处</CNAPSName>
  51. </DetailRecord>
  52. </TransParam>
  53. </TransReq>
  54. </ATSYH>

三、响应报文

3.1 公共响应参数

参数 中文名称 是否必填 示例值 描述
BankCode 线路代码 是 ALIPAY01 渠道代码
TransType 交易类型 是 1988 固定为”1988”
TransSeqID 指令流水号 否 030441109 指令流水号,全局唯一

3.1 响应参数

参数 中文名称 是否必填 示例值 描述
RespCode 响应码 是 0 0:成功,-1:失败
RespInfo 响应信息 否 成功 响应信息描述
TransState 交易状态 否 M0001
PayInfoCode 支付信息码 否 M0001
ReqSeqID 支付批号 是 28081001108487

3.2 响应示例

  1. <ATSYH>
  2. <TransResp>
  3. <BankCode>CCB04</BankCode>
  4. <TransType>1988</TransType>
  5. <TransSeqID>1625205163</TransSeqID>
  6. <TransParam>
  7. <DetailRecord>
  8. <NewReqSeqID/>
  9. <RespCode>0</RespCode>
  10. <RespInfo/>
  11. <TransState>00+400</TransState>
  12. <ReqSeqID>18053000036006</ReqSeqID>
  13. <PayInfoCode>委托项目编号:330130163,实时批量交易中</PayInfoCode>
  14. </DetailRecord>
  15. </TransParam>
  16. </TransResp>
  17. </ATSYH>