一、应用场景

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