一、应用场景
前端系统主动发起单笔解约确认,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 |
步骤 |
是 |
02 |
签约步骤,01-解约申请,02-解约确认 |
2.3 请求示例
<ATSYH version="5.1.0.0">
<TransReq>
<BankCode>GZELINK01</BankCode>
<TransType>DeContract</TransType>
<TransSeqID>30191205151125</TransSeqID>
<CommandCode>9108Auth</CommandCode>
<TransParam>
<DetailRecord>
<ReqSeqID>G0120031611501284062</ReqSeqID>
<PayAct>6123011880003601000</PayAct>
<RecAct>001053110000001123</RecAct>
<PayName>测试</PayName>
<SourceNoteCode>20190618190602</SourceNoteCode>
<PolicyNo>ZY009358223</PolicyNo>
<DeadLine>13022195000</DeadLine>
<SingleLimit>黄二九</SingleLimit>
<PeriodLimit>0</PeriodLimit>
<CountLimit>350903198101025563</CountLimit>
<CardType>ZY009358223</CardType>
<CertType></CertType>
<CertNum></CertNum>
<CellPhone></CellPhone>
<SmsCode></SmsCode>
<AuthCode></AuthCode>
<Token></Token>
<NoteMoney></NoteMoney>
<InsureID></InsureID>
<InsureName></InsureName>
<Memo></Memo>
<Step>02</Step>
</DetailRecord>
</TransParam>
</TransReq>
</ATSYH>
三、响应报文
3.1 公共响应参数
参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
BankCode |
线路代码 |
是 |
ALIPAY01 |
渠道代码 |
TransType |
交易类型 |
是 |
QryContract |
固定为”QryContract” |
TransSeqID |
指令流水号 |
否 |
030441109 |
指令流水号,全局唯一 |
3.1 响应参数
参数 |
中文名称 |
是否必填 |
示例值 |
描述 |
RespCode |
响应码 |
是 |
0 |
0:成功,-1:失败 |
RespInfo |
响应信息 |
否 |
成功 |
响应信息描述 |
UnifiedCode |
统一签约码 |
否 |
EC801 |
根据OriginalCode映射后的统一码 |
ReqSeqID |
支付流水号 |
是 |
28081001108487 |
|
DeSignState |
解约状态 |
是 |
success |
success 已解约(含协议号) fail 解约失败 |
3.2 响应示例
<ATSYH>
<TransResp>
<BankCode>CMBC02</BankCode>
<TransType>DeContract</TransType>
<TransSeqID>20210428120143860604711</TransSeqID>
<TransParam>
<DetailRecord>
<RespCode>0</RespCode>
<RespInfo>重复签约</RespInfo>
<ReqSeqID>ATS2021042812014386060471</ReqSeqID>
<UnifiedCode>EC801</UnifiedCode>
<DeSignState>fail</DeSignState>
<OriginalCode>S</OriginalCode>
</DetailRecord>
</TransParam>
</TransResp>
</ATSYH>