快速开始
1
获取验证码
调用验证码接口获取flowNo
POST /api/clearcore/carriers/verification-codes
2
用户输入验证码
用户收到短信后输入验证码
⚡ 用户在您的页面输入验证码
3
提交验证完成支付
提交验证码完成支付流程
POST /api/clearcore/carriers/subscriptions
核心特性
接口流程
- 1 请求验证码接口获取flowNo
- 2 用户输入验证码
- 3 提交验证码完成支付
- 4 接收异步通知结果
重要说明
- 所有接口仅支持POST方式
- 参数通过Body JSON格式传递
- 返回格式为JSON
- 通知回调需返回"ok"确认
获取验证码
请求地址
https://8.156.88.251/api/clearcore/carriers/verification-codes
提交方法
POST
参数通过Body JSON格式传递
Headers说明
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | 是 | string | 固定值: application/json |
Body参数说明
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| mobileNumber | 是 | string | 手机号 |
| productId | 是 | string | 产品编号 |
| channelId | 是 | string | 渠道号 |
| userAgent | 是 | string | 浏览器User-Agent |
| outTradeNo | 否 | string | 外部订单号（最长32位） |
| clientIp | 否 | string | IP地址 |
| utmSource | 否 | string | 媒体平台 |
| utmMedium | 否 | string | 包名 |
| extends | 否 | json | 扩展字段（JSON格式） |
在线测试
请求示例 (cURL)
curl -X POST "https://8.156.88.251/api/clearcore/carriers/verification-codes" \
-H "Content-Type: application/json" \
-d '{
"mobileNumber": "13567890000",
"productId": "383282948796846080",
"channelId": "383568173904957440",
"userAgent": "Mozilla/5.0",
"outTradeNo": "a55d1e7bcbef",
"clientIp": "127.0.0.1",
"utmSource": "",
"utmMedium": "",
"extends": {"key":"value"}
}'
返回示例
{
"code": 0,
"message": "success",
"data": {
"flowNo": "395616837469085696"
},
"success": true
}
返回参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | integer | 是 | 业务状态码（0:成功，其余均为失败） |
| message | string | 是 | 响应消息描述 |
| success | boolean | 是 | 请求是否成功 |
| data (json) 返回数据对象 | |||
| └─ flowNo | string | 是 | 业务流水号，用于后续提交验证码 |