一、应用场景
前端系统主动发起批量代付提交,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 请求示例
<ATSYH version="5.1.0.0">
<TransReq>
<BankCode>CCB04</BankCode>
<TransTime>2018-05-30 16:13:46</TransTime>
<TransType>1988</TransType>
<CommandCode>198801</CommandCode>
<TransSeqID>1613469584</TransSeqID>
<TotalNum>1</TotalNum>
<TotalAmt>2400.00</TotalAmt>
<TransParam>
<ReqSeqID>18053000036004</ReqSeqID>
<PaySpd>0</PaySpd>
<PsselNum>PS0_0001002018053000081011</PsselNum>
<PayAct>33001616635059002888</PayAct>
<PayArea>3301</PayArea>
<PayAreaName>浙江省_杭州市</PayAreaName>
<SubmitId/>
<DetailRecord>
<PayName>信泰人寿保险股份有限公司</PayName>
<PayAct>33001616635059002888</PayAct>
<PayBnk>中国建设银行股份有限公司杭州秋涛支行</PayBnk>
<PayArea>3301</PayArea>
<RecBankName>中国建设银行</RecBankName>
<RecBankCode>105</RecBankCode>
<RecName>张三七</RecName>
<RecAct>6227001540005047061</RecAct>
<RecBnk>中国建设银行浙江省分行临安支行万事达分理处</RecBnk>
<RecArea>3301</RecArea>
<RecAreaName>浙江省_杭州市</RecAreaName>
<RecStandardArea>浙江省_杭州市</RecStandardArea>
<SameCity>1</SameCity>
<SameBnk>1</SameBnk>
<PayDate>2018-05-30</PayDate>
<PayTime>16:13:46</PayTime>
<PayAmount>2400.00</PayAmount>
<PaySpd>0</PaySpd>
<IsPrivate>1</IsPrivate>
<PayCur>1</PayCur>
<RecCur>1</RecCur>
<CertType/>
<CertNum/>
<CreditCardSecCode/>
<CreditCardValidity/>
<Purpose/>
<Usage>报销</Usage>
<PostScript>28053000052004</PostScript>
<Memo>信泰付款-</Memo>
<ReqReserve>38053000039007</ReqReserve>
<CNAPSCode>105331024066</CNAPSCode>
<CNAPSName>中国建设银行浙江省分行临安支行万事达分理处</CNAPSName>
</DetailRecord>
</TransParam>
</TransReq>
</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 响应示例
<ATSYH>
<TransResp>
<BankCode>CCB04</BankCode>
<TransType>1988</TransType>
<TransSeqID>1625205163</TransSeqID>
<TransParam>
<DetailRecord>
<NewReqSeqID/>
<RespCode>0</RespCode>
<RespInfo/>
<TransState>00+400</TransState>
<ReqSeqID>18053000036006</ReqSeqID>
<PayInfoCode>委托项目编号:330130163,实时批量交易中</PayInfoCode>
</DetailRecord>
</TransParam>
</TransResp>
</ATSYH>