一、应用场景
前端系统主动发起单笔解约申请,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>