一、应用场景

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

  1. <ATSYH version="5.1.0.0">
  2. <TransReq>
  3. <BankCode>GZELINK01</BankCode>
  4. <TransType>DeContract</TransType>
  5. <TransSeqID>30191205151125</TransSeqID>
  6. <CommandCode>9108Auth</CommandCode>
  7. <TransParam>
  8. <DetailRecord>
  9. <ReqSeqID>G0120031611501284062</ReqSeqID>
  10. <PayAct>6123011880003601000</PayAct>
  11. <RecAct>001053110000001123</RecAct>
  12. <PayName>测试</PayName>
  13. <SourceNoteCode>20190618190602</SourceNoteCode>
  14. <PolicyNo>ZY009358223</PolicyNo>
  15. <DeadLine>13022195000</DeadLine>
  16. <SingleLimit>黄二九</SingleLimit>
  17. <PeriodLimit>0</PeriodLimit>
  18. <CountLimit>350903198101025563</CountLimit>
  19. <CardType>ZY009358223</CardType>
  20. <CertType></CertType>
  21. <CertNum></CertNum>
  22. <CellPhone></CellPhone>
  23. <SmsCode></SmsCode>
  24. <AuthCode></AuthCode>
  25. <Token></Token>
  26. <NoteMoney></NoteMoney>
  27. <InsureID></InsureID>
  28. <InsureName></InsureName>
  29. <Memo></Memo>
  30. <Step>02</Step>
  31. </DetailRecord>
  32. </TransParam>
  33. </TransReq>
  34. </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 响应示例

  1. <ATSYH>
  2. <TransResp>
  3. <BankCode>CMBC02</BankCode>
  4. <TransType>DeContract</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. <DeSignState>fail</DeSignState>
  13. <OriginalCode>S</OriginalCode>
  14. </DetailRecord>
  15. </TransParam>
  16. </TransResp>
  17. </ATSYH>