一、应用场景

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

<ATSYH version="5.1.0.0">
  <TransReq>
    <BankCode>ICBC05</BankCode>
    <TransType>Contract</TransType>
    <TransSeqID>20210315093548051</TransSeqID>
    <CommandCode>9108Cntr</CommandCode>
    <TransParam>
      <DetailRecord>
        <RecAct>020099996103</RecAct>
        <ReqSeqID>2020032500001267</ReqSeqID>
        <PayAct>6217231001003936369</PayAct>
        <PayName>王晓群</PayName>
        <SourceNoteCode>37163729</SourceNoteCode>
        <PolicyNo>
        </PolicyNo>
        <DeadLine>20991231</DeadLine>
        <SingleLimit>
        </SingleLimit>
        <PeriodLimit>2</PeriodLimit>
        <CountLimit>9999</CountLimit>
        <CardType>2</CardType>
        <CertType>0</CertType>
        <CertNum>210103198306154521</CertNum>
        <CellPhone>15802481002</CellPhone>
        <SmsCode>111111</SmsCode>
        <AuthCode>A020107020210430000000000001738541</AuthCode>
        <Token>299228</Token>
        <NoteMoney>
        </NoteMoney>
        <InsureID>
        </InsureID>
        <InsureName>
        </InsureName>
        <Memo>
        </Memo>
        <Step>02</Step>
      </DetailRecord>
    </TransParam>
  </TransReq>
</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 响应示例

<ATSYH>
  <TransResp>
    <BankCode>ICBC05</BankCode>
    <TransType>Contract</TransType>
    <TransSeqID>20210315093548051</TransSeqID>
    <TransParam>
      <DetailRecord>
        <RespCode>0</RespCode>
        <RespInfo>交易成功</RespInfo>
        <ReqSeqID>2020032500001267</ReqSeqID>
        <UnifiedCode>SC000</UnifiedCode>
        <SignState>fail</SignState>
        <AuthCode>A020107020210430000000041</AuthCode>
        <OriginalCode>00</OriginalCode>
      </DetailRecord>
    </TransParam>
  </TransResp>
</ATSYH>