一、应用场景
前端系统主动发起批量代扣提交,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 |
|
| RecAct |
收方账号 |
是 |
33001616635059002888 |
|
| RecArea |
收方区域 |
否 |
3301 |
|
| RecAreaName |
收方区域名称 |
否 |
浙江省_杭州市 |
|
| 业务参数 |
|
|
|
|
| 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>BOS01</BankCode> <Entity>5000001</Entity> <TransTime>2019-01-08 14:13:50</TransTime> <TransType>9188</TransType> <CommandCode>918801</CommandCode> <TransSeqID>20190108141350269</TransSeqID> <TotalNum>1</TotalNum> <TotalAmt>1.00</TotalAmt> <TransParam> <ReqSeqID>10814135026933</ReqSeqID> <PaySpd>0</PaySpd> <PsselNum>SKPH180800000FK0</PsselNum> <RecAct>10283000000257649</RecAct> <RecArea>1100</RecArea> <RecAreaName>北京市_北京市</RecAreaName> <CorpBankCode>304</CorpBankCode> <SumAccountFlag /> <SubmitId>1422261000</SubmitId> <PayType>401</PayType> <DetailRecord> <PayName>测试客户3001973544</PayName> <PayAct>622892002010421707</PayAct> <PayBnk>华夏银行</PayBnk> <PayArea>1100</PayArea> <PayBankCode>304</PayBankCode> <PayBankName>华夏银行</PayBankName> <PayAreaName>北京市_北京市</PayAreaName> <RecName>新华人寿保险股份有限公司</RecName> <RecAct>10283000000257649</RecAct> <RecBnk>华夏银行北京秀水支行</RecBnk> <RecBankCode>304</RecBankCode> <RecArea>1100</RecArea> <RecAreaName>北京市_北京市</RecAreaName> <SameCity>1</SameCity> <SameBnk>1</SameBnk> <IsPrivate>1</IsPrivate> <PaySpd>0</PaySpd> <PayDate>2019-01-08</PayDate> <PayTime>14:13:50</PayTime> <PayAmount>1.00</PayAmount> <PayCur>1</PayCur> <RecCur>1</RecCur> <CertType /> <CertNum /> <CreditCardSecCode /> <CreditCardValidity /> <Usage>8600160</Usage> <Purpose /> <PostScript>G08SP9CH</PostScript> <Memo>21189999949990</Memo> <SourceNote>21189999949990</SourceNote> <ReqReserve>000057K9NP</ReqReserve> <CNAPSCode /> <CNAPSName /> <SrcTransDate /> <SrcTransSN /> <Description>无现金流明细</Description> </DetailRecord> </TransParam> </TransReq></ATSYH>
三、响应报文
3.1 公共响应参数
| 参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
| BankCode |
线路代码 |
是 |
ALIPAY01 |
渠道代码 |
| TransType |
交易类型 |
是 |
9188 |
固定为”9188” |
| TransSeqID |
指令流水号 |
否 |
030441109 |
指令流水号,全局唯一 |
3.1 响应参数
| 参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
| RespCode |
响应码 |
是 |
0 |
0:成功,-1:失败 |
| RespInfo |
响应信息 |
否 |
成功 |
响应信息描述 |
| TransState |
交易状态 |
否 |
M0001 |
|
| PayInfoCode |
支付信息码 |
否 |
M0001 |
|
| ReqSeqID |
支付批号 |
是 |
28081001108487 |
|
3.2 响应示例
<ATSYH> <TransResp> <BankCode>BOS01</BankCode> <TransType>9188</TransType> <TransSeqID>20190108141350269</TransSeqID> <TransParam> <DetailRecord> <NewReqSeqID /> <RespCode>0</RespCode> <RespInfo>代扣文件上传成功,等待批处理</RespInfo> <TransState>0</TransState> <ReqSeqID>10814135026933</ReqSeqID> <PayInfoCode>0</PayInfoCode> </DetailRecord> </TransParam> </TransResp></ATSYH>