主题
合约续签短信申请
接口描述
- 合约续签时发送短信验证码，用于验证用户身份。
请求 URL
/signPay/contractRenewSmsApply
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202415629590370906 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 43e2c287-24b1-4cd1-b3d2-e40e7840cc40 |
| transDate | 是 | string | 13 | 请求时间，13 位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| signMerchantNo | 是 | string | 签约商户编号 | XS260323000513 | |
| signNo | 是 | string | 签约号（签约唯一标识编号） | 2024112000001001 | |
| phoneNo | 是 | string | 手机号（用户预留手机号，用于接收短信验证码，需加密） | ||
| businessDomain | 是 | string | 多渠道授权业务域JSON | ||
| - deviceId | 否 | string | 设备 ID（终端设备唯一标识） | A1B2C3D4E5F6 | |
| - authTimes | 否 | Integer | 授权交易次数（0-99，0 表示无限制） | 10 | |
| - singleAmountLimit | 否 | string | 单笔金额上限（与累计金额上限二选一） | 1000.00 | |
| - totalAmountLimit | 否 | string | 累计金额上限（与单笔金额上限二选一） | 5000.00 | |
| - authValidDate | 否 | string | 授权有效时间（格式：yyyyMMdd） | 20251231 | |
| - authProductName | 否 | string | 授权商品/服务名称（最大 20 个汉字） | 会员服务 | |
| - merchantShortName | 否 | string | 商户简称（最大 8 个汉字） | XX 店铺 | |
| - userLoginIp | 否 | string | 用户登录 IP | 192.168.1.100 | |
| - userRegTime | 否 | string | 用户注册时间（格式：yyyyMMddHHmmss） | 20240101120000 | |
| - loginVerifyType | 否 | string | 登录验证方式 | SMS_VERIFY |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| orderId | 是 | string | 订单 ID（续签短信申请订单唯一标识，用于后续短信验证接口调用） | 2024112000001001 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 (同入参) | 43e2c287-24b1-4cd1-b3d2-e40e7840cc40 |
| transDate | 是 | string | 13 | 请求时间，13 位时间戳 | 1731406784607 |
响应示例
json
{
"code": "00000000",
"message": "成功",
"orderId": "2024112000001001",
"transDate": "1731469621597",
"transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
"signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g=="
}备注
- 更多返回错误代码请看 通用规则说明 - 错误码 的错误代码描述
phoneNo字段需要使用 AES 加密传输singleAmountLimit与totalAmountLimit为可选配置项，二者选其一即可authTimes为 0 时表示无次数限制orderId用于后续短信验证接口调用，请妥善保管