一.业务场景

通过给用户发送验证码，以验证码授权方式签署合同。验证码有效时间为 10 分钟。客户平台的用户需要创建协议，在客户平台向系统提交发送创建合同并上送验证码的命令。

二.字段说明：

请求报文

1.contractBody字段：包括head和业务数据节点proxySign
a.head节点见电子协议联调说明(二、接口约定中-5. 报文参数-请求参数-head(头信息)详细)
b.业务数据节点proxySign：

请求 proxySign节点字段

参数	约束	最大长度	说明	备注
userId	NOT NULL	32	用户 ID	开户时返回的用户 ID
randomCode	NOT NULL	2	短信随机码	短信随机码，用来区别当前用接收的短信，防止多次获取时导致验证失败。
smsTemplateValue	NULL	100	模板值	根据提供的模板上送对应的模板值，用英文分号隔开。使用配置短信模板时，模板值和模板 ID 都不能为空
smsTemplateId	NULL	2	模板 ID	提交模板之后配置的短信 ID，可为空。未提交短信模板，则使用默认短信模板。使用配置短信模板时，模值和模板 ID 都不能为空。

返回报文

返回 proxySign节点字段

参数	约束	最大长度	说明	备注
userId	NOT NULL	32	用户 ID	开户时返回的用户 ID
randomCode	NOT NULL	2	短信随机码	短信随机码，用来区别当前用接收的短信，防止多次获取时导致验证失败。

请求参数

Body 参数application/x-www-form-urlencoded

termId

string

必需

电子协议系统分配的终端号

示例值:

TE120101

tradeTrace

string

必需

请求流水，唯一，不包括特殊字符

示例值:

z9KnSjwY9xyvVgoIRjK9

contractBody

string

请求的报文内容

必需

示例值:

{"head":{"txTime":"20230529154741"},"proxySign":{"randomCode":"45","userId":"CFC5D50666BE219BE05311016B0A4D22"}}

merId

string

必需

电子协议系统分配的商户号

示例值:

MER021322120101

txCode

string

请求类型

必需

示例值:

3101

version

string

必需

版本默认 “1.0”

示例值:

1.0

channelId

string

必需

电子协议系统分配的机构号

示例值:

616161622120101

sign

string

必需

请求的签名，是对 POST 请求参数的签名

示例值:

29CE4BB59499874F55360EE6C0597449

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

resultCode

enum<string>

应答码

必需

应答码

<= 2 字符

枚举值:

00010306253031429698A094

resultMsg

string

应答描述

可选

应答描述

contractBody

string

应答的报文

可选

应答的报文

sign

string

请求的签名，是对 POST 应答参数的签名

可选

请求的签名，是对 POST 应答参数的签名

示例

{
    "resultCode": "00",
    "resultMsg": "string",
    "contractBody": "string",
    "sign": "string"
}

发送验证码3101

一.业务场景

二.字段说明：

请求报文

返回报文

请求参数

示例代码

返回响应