一、应用场景

前端系统主动发起单笔解约申请,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 请求示例

  1. <ATSYH version="5.1.0.0">
  2. <TransReq>
  3. <BankCode>FnGrd01</BankCode>
  4. <TransType>DeContract</TransType>
  5. <TransSeqID>20210715175501</TransSeqID>
  6. <CommandCode>9108Cntr</CommandCode>
  7. <TransParam>
  8. <DetailRecord>
  9. <ReqSeqID>G0821071517025437888</ReqSeqID>
  10. <RecAct>120902016310828</RecAct>
  11. <PayAct>710754090320</PayAct>
  12. <CellPhone>13431973149</CellPhone>
  13. <AuthCode/>
  14. <PayName>何焕玲</PayName>
  15. <CertType>0</CertType>
  16. <CertNum>440127196807100526</CertNum>
  17. <SingleLimit/>
  18. <SourceNoteCode/>
  19. <PolicyNo/>
  20. <Token/>
  21. <Step>01</Step>
  22. </DetailRecord>
  23. </TransParam>
  24. </TransReq>
  25. </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 响应示例

  1. <ATSYH>
  2. <TransResp>
  3. <BankCode>CMBC02</BankCode>
  4. <TransType>Contract</TransType>
  5. <TransSeqID>20210428120143860604711</TransSeqID>
  6. <TransParam>
  7. <DetailRecord>
  8. <RespCode>0</RespCode>
  9. <RespInfo>重复签约</RespInfo>
  10. <ReqSeqID>ATS2021042812014386060471</ReqSeqID>
  11. <UnifiedCode>EC801</UnifiedCode>
  12. <OriginalCode>S</OriginalCode>
  13. </DetailRecord>
  14. </TransParam>
  15. </TransResp>
  16. </ATSYH>