一、应用场景

前端系统主动发起单笔签约确认,DSP根据入参的收方、付方信息,发送渠道方进行签约,并将用户签约状态信息返回给前端系统。

二、请求报文

2.1 公共请求参数

参数 中文名称 是否必填 示例值 描述
BankCode 线路代码 ALIPAY01 渠道代码
TransType 交易类型 Contract 接口名称,固定为 “Contract”
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
SmsCode 验证码 342124 签约申请成功后的验证码
Token 短息序号 1234 签约申请的短信序号
Step 步骤 02 签约步骤,01-签约申请,02-签约确认

2.3 请求示例

  1. <ATSYH version="5.1.0.0">
  2. <TransReq>
  3. <BankCode>ICBC05</BankCode>
  4. <TransType>Contract</TransType>
  5. <TransSeqID>20210315093548051</TransSeqID>
  6. <CommandCode>9108Cntr</CommandCode>
  7. <TransParam>
  8. <DetailRecord>
  9. <RecAct>020099996103</RecAct>
  10. <ReqSeqID>2020032500001267</ReqSeqID>
  11. <PayAct>6217231001003936369</PayAct>
  12. <PayName>王晓群</PayName>
  13. <SourceNoteCode>37163729</SourceNoteCode>
  14. <PolicyNo>
  15. </PolicyNo>
  16. <DeadLine>20991231</DeadLine>
  17. <SingleLimit>
  18. </SingleLimit>
  19. <PeriodLimit>2</PeriodLimit>
  20. <CountLimit>9999</CountLimit>
  21. <CardType>2</CardType>
  22. <CertType>0</CertType>
  23. <CertNum>210103198306154521</CertNum>
  24. <CellPhone>15802481002</CellPhone>
  25. <SmsCode>111111</SmsCode>
  26. <AuthCode>A020107020210430000000000001738541</AuthCode>
  27. <Token>299228</Token>
  28. <NoteMoney>
  29. </NoteMoney>
  30. <InsureID>
  31. </InsureID>
  32. <InsureName>
  33. </InsureName>
  34. <Memo>
  35. </Memo>
  36. <Step>02</Step>
  37. </DetailRecord>
  38. </TransParam>
  39. </TransReq>
  40. </ATSYH>

三、响应报文

3.1 公共响应参数

参数 中文名称 是否必填 示例值 描述
BankCode 线路代码 ALIPAY01 渠道代码
TransType 交易类型 Contract 固定为”Contract”
TransSeqID 指令流水号 030441109 指令流水号,全局唯一

3.1 响应参数

参数 中文名称 是否必填 示例值 描述
RespCode 响应码 0 0:成功,-1:失败
RespInfo 响应信息 成功 响应信息描述
OriginalCode 原始错误码 M0001 银行返回的原始签约错误码
UnifiedCode 统一签约码 EC801 根据OriginalCode映射后的统一码
ReqSeqID 支付流水号 28081001108487
SignConfirmType 签约方式 2 0无需签约
1实时返回
2短信验证码
3短信回复(异步通知)即上行短信
4跳转
5批量授权
SignState 签约状态 fail success-成功
fail-失败
signing-签约中
unSigned-未签约
SignCanceled-已解约
AuthCode 协议号 3241324234 签约确认成功后银行返回的协议号

3.2 响应示例

  1. <ATSYH>
  2. <TransResp>
  3. <BankCode>ICBC05</BankCode>
  4. <TransType>Contract</TransType>
  5. <TransSeqID>20210315093548051</TransSeqID>
  6. <TransParam>
  7. <DetailRecord>
  8. <RespCode>0</RespCode>
  9. <RespInfo>交易成功</RespInfo>
  10. <ReqSeqID>2020032500001267</ReqSeqID>
  11. <UnifiedCode>SC000</UnifiedCode>
  12. <SignState>fail</SignState>
  13. <AuthCode>A020107020210430000000041</AuthCode>
  14. <OriginalCode>00</OriginalCode>
  15. </DetailRecord>
  16. </TransParam>
  17. </TransResp>
  18. </ATSYH>