一、应用场景
前端系统主动发起单笔解约申请,DSP根据入参的收方、付方信息,发送渠道方进行用户认证,并将用户验证码信息返回给前端系统。
二、请求报文
2.1 公共请求参数
| 参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
| BankCode |
线路代码 |
是 |
ALIPAY01 |
渠道代码 |
| TransType |
交易类型 |
是 |
DeContract |
接口名称,固定为 “DeContract” |
| CommandCode |
线路指令 |
是 |
9108Auth |
接口的分类,由于银行的支付业务分商业委托代扣、协议代扣等,会有多种接口,因此DSP需增加对应指令进行标识 |
| TransSeqID |
指令流水号 |
否 |
030441109 |
指令流水号,全局唯一 |
| TransTime |
指令时间 |
否 |
2021-07-27 15:04:41 |
指令时间,格式:yyyy-MM-dd HH:mm:ss |
2.2 请求参数
| 参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
| PayAct |
付方账号 |
是 |
79102100603450000018 |
|
| PayName |
付方名称 |
是 |
名侦探悟空 |
|
| PayBankCode |
付方银行代码 |
是 |
102 |
银行大类代码 |
| RecAct |
收方账号 |
是 |
6217661145901883428 |
|
| RecName |
收方名称 |
是 |
姬俞 |
|
| RecBankCode |
收方银行代码 |
是 |
102 |
银行大类代码 |
| PayAmount |
交易金额 |
是 |
667.00 |
单位为元,保留小数点后两位 |
| PayCur |
付方币种 |
否 |
1 |
标准币种 |
| RecCur |
收方币种 |
否 |
1 |
标准币种 |
| ReqSeqID |
支付流水号 |
是 |
29080702394102 |
|
| CertType |
证件类型 |
否 |
1 |
标准证件类型 |
| CertNum |
证件号 |
否 |
313882000012 |
|
| CellPhone |
手机号 |
是 |
15158040490 |
手机号 |
| IsPrivate |
公私标志 |
否 |
1 |
1:对私 0:对公; |
| CardType |
卡类型 |
否 |
2 |
2:借记卡,3:信用卡 |
| PolicyNo |
保单号 |
否 |
30101194506012712 |
|
| DeadLine |
到期日期 |
否 |
20991231 |
格式:yyyyMMdd |
| SingleLimit |
单笔限额 |
否 |
12000.00 |
单位为元,保留小数点后两位 |
| AuthCode |
协议号 |
否 |
30101194506012712 |
|
| Step |
步骤 |
是 |
01 |
签约步骤,01-签约申请,02-签约确认 |
2.3 请求示例
<ATSYH version="5.1.0.0"> <TransReq> <BankCode>FnGrd01</BankCode> <TransType>DeContract</TransType> <TransSeqID>20210715175501</TransSeqID> <CommandCode>9108Cntr</CommandCode> <TransParam> <DetailRecord> <ReqSeqID>G0821071517025437888</ReqSeqID> <RecAct>120902016310828</RecAct> <PayAct>710754090320</PayAct> <CellPhone>13431973149</CellPhone> <AuthCode/> <PayName>何焕玲</PayName> <CertType>0</CertType> <CertNum>440127196807100526</CertNum> <SingleLimit/> <SourceNoteCode/> <PolicyNo/> <Token/> <Step>01</Step> </DetailRecord> </TransParam> </TransReq></ATSYH>
三、响应报文
3.1 公共响应参数
| 参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
| BankCode |
线路代码 |
是 |
ALIPAY01 |
渠道代码 |
| TransType |
交易类型 |
是 |
Contract |
固定为”Contract” |
| TransSeqID |
指令流水号 |
否 |
030441109 |
指令流水号,全局唯一 |
3.1 响应参数
| 参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
| RespCode |
响应码 |
是 |
0 |
0:成功,-1:失败 |
| RespInfo |
响应信息 |
否 |
成功 |
响应信息描述 |
| UnifiedCode |
统一签约码 |
否 |
EC801 |
根据OriginalCode映射后的统一码 |
| ReqSeqID |
支付流水号 |
是 |
28081001108487 |
|
| DeSignState |
解约状态 |
是 |
success |
success 已解约(含协议号) fail 解约失败 |
| Token |
短信序号 |
否 |
1231 |
|
| Step |
解约步骤 |
否 |
01 |
如果返回630有Step,则630会发起解约确认,否则直接返回解约状态给前端 |
3.2 响应示例
<ATSYH> <TransResp> <BankCode>CMBC02</BankCode> <TransType>Contract</TransType> <TransSeqID>20210428120143860604711</TransSeqID> <TransParam> <DetailRecord> <RespCode>0</RespCode> <RespInfo>重复签约</RespInfo> <ReqSeqID>ATS2021042812014386060471</ReqSeqID> <UnifiedCode>EC801</UnifiedCode> <OriginalCode>S</OriginalCode> </DetailRecord> </TransParam> </TransResp></ATSYH>