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