二、签约接口
## 1.提交在线签约信息接口
#### 接口地址:
/open/api/v1/sign/contract
#### 请求方式:POST
>d 该接口不可频繁无限请求。同一个手机号每天至多五次请求。如果查过了则需要24小时候才可重试。务必确认信息正确在提交。不可随便提交测试。
#### 请求参数说明:
|参数名称|参数含义|是否必填|参数备注|
|-|-|-|-|
|realName|真实姓名|是||
|cardNo|银行卡号|是||
|mobile|手机号|是||
|idCard|身份证号码|是||
|signingType|签约类型|是|2:银行卡四要素 3:运营商三要素|
>d 备注:银行卡四要素 :姓名,身份证,银行卡,手机号码。运营商三要素 :姓名,身份证,手机号码
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|personAccountId|签约账户ID|String|是|该值用于下个接口签约使用|
## 2.验证码确认签约接口
#### 接口地址:
/open/api/v1/sign/contract/submit
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|是否必填|参数备注|
|-|-|-|-|
|code|验证码|是||
|personAccountId|签约账户ID|是||
|mobile|手机号|是||
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|url|签约成功的合同链接|String|是||
## 3.签约结果查询接口
#### 接口地址:
/open/api/v1/sign/result
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|是否必填|参数备注|
|-|-|-|-|
|无参数名称|需要查询的身份证号码|是|例如:[商户订单号1,商户订单号2]|
>d 该接口参数无需参数名称只需将身份证号码拼接处json数组即可
示例:String data = [\"idCard1\",\"idCard2\"... ,\"idCard10\"];
一次性最多查询10条记录
#### 接口响应参数data字段解密后的参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|idCard| 身份证号|String| 是||
|status| 结果状态|int| 是|详情请参考[签约状态码](doc:nD2opxYu)|
|url| 签约成功协议地址|String|否| |只是签约成功的状态才会有该值|
>d该结算结果data解密后为List 集合json字符串。
结果示例
[{"idCard":"idCard1","status":xx,"url":"xxxx"},
{"idCard":"idCard2","status":xx,"url":"xxxx"}]
## 4.签约成功后回调接口
>d 该接口需要第三方自行编写提供接口到SSC平台 接口编写示例如下。
#### 请求方式:POST
#### 传给回调接口参数data 解密结果json说明:
解密结果示例如下:
```json
{"idCard":"12456484","realName":"张三","bankCard":"54848484","mobile":"1888888888","protocolUrl":"https://123.com"}";
```
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|idCard| 身份证号|String| 是||
|realName| 真实姓名|String| 是||
|bankCard| 银行卡号|String| 否||
|mobile| 签约手机号|String| 是||
|protocolUrl| 签署成功的协议链接|String| 是||
## 5.解约接口
#### 接口地址:
/open/api/v1/sign/dzCancel
#### 请求方式:POST
#### 请求参数说明:
|参数名称|参数含义|是否必填|参数备注|
|-|-|-|-|
|name|姓名|是||
|idCard|身份证号|是||
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|name|姓名|String|是||
|idCard|身份证号|String|是||
|status|状态|String|是|已解约,解约失败|
|errorMessage|失败原因|String|否|解约失败的话会有该出参|