用户提单接口
方法列表
方法 | 说明 |
---|---|
appid() | 获取APPID【四川移动存量业务专用】 |
config() | 获取落地页配置【小程序用】 |
handle() | 办理业务 |
picture() | 上传照片【京东天幕专用】 |
prepare() | 预下单【四川移动和联通沃悦读用】 |
query() | 订单查询 |
search() | 查询可订购号码【号卡用】 |
sms() | 发送验证码 |
upload() | 上传照片【号卡用】-每次一张返回存储路径 |
validate() | 存量业务验证码校验【京东天幕专用】 |
由分销商提供 | 异步回调 |
详细说明
获取APPID【四川移动存量业务专用】
接口地址:user/server/appid
public array appid ( $apiUser, $cid, $sign ) | |||
$apiUser | string | 必须 | 接口账号(平台提供) |
$cid | integer | 必须 | 产品ID(平台提供) |
$sign | string | 必须 | 签名结果 |
return | array |
返回data结构说明
|
|
---|---|---|---|
throws | \yii\base\UserException |
获取落地页配置【小程序用】
接口地址:user/server/config
public array config ( $apiUser, $cid, $sign ) | |||
$apiUser | string | 必须 | 代理商账号(平台提供) |
$cid | integer | 必须 | 产品id(平台提供) |
$sign | string | 必须 | 签名 |
return | array | 返回 data 结构说明
|
|
---|---|---|---|
throws | \yii\base\UserException |
办理业务
接口地址:user/server/handle
public array handle ( $apiUser, $mobile, $cid, array $extra, $source, $orderSn, $sign ) | |||
$apiUser | string | 必须 | 接口账号(平台提供) |
$mobile | string | 必须 | 手机号 |
$cid | integer | 必须 | 产品ID(平台提供) |
$extra | array | 必须 | 扩展参数,根据业务类型提交,(Y)表示为必须参数
|
$source | string | 必须 | 订单来源地址(收单url) |
$orderSn | string | 必须 | 用户订单编号(回调时用) |
$sign | string | 必须 | 签名结果 |
return | array | 返回data结构说明:
|
|
---|---|---|---|
throws | \yii\base\UserException |
上传照片【京东天幕专用】
接口地址:user/server/picture
public array picture ( $apiUser, $cid, $htId = '', array $extra, $sign ) | |||
$apiUser | string | 必须 | 接口账号(平台提供) |
$cid | integer | 必须 | 产品ID(平台提供) |
$htId | string | 可选 | 活体流水ID |
$extra | array | 必须 | 图片信息
|
$sign | string | 必须 | 签名结果 |
return | array | 返回的data字段说明:htId=活体流水ID,imageType=对应入参type,idCode=证件号(type=picFace返回),realName=姓名(type=picFace返回) |
|
---|---|---|---|
throws | \yii\base\UserException |
预下单【四川移动和联通沃悦读用】
接口地址:user/server/prepare
public array prepare ( $apiUser, $mobile, $cid, $source, array $extra = [], $sign ) | |||
$apiUser | string | 必须 | 接口账号(平台提供) |
$mobile | string | 必须 | 手机号 |
$cid | integer | 必须 | 产品ID(平台提供) |
$source | string | 必须 | 订单来源地址(收单url) |
$extra | array | 可选 | 扩展参数 {'wokey':'联通沃悦读需要'} |
$sign | string | 必须 | 签名结果 |
return | array | 返回data结构说明
|
|
---|---|---|---|
throws | \yii\base\UserException |
订单查询
接口地址:user/server/query
public array query ( $apiUser, $orderSn, $sign ) | |||
$apiUser | string | 必须 | 接口账号(平台提供) |
$orderSn | string | 必须 | 用户订单编号(四川移动业务使用预下单接口返回的serialNumber) |
$sign | string | 必须 | 签名结果 |
return | array | 返回data结构说明
|
|
---|---|---|---|
throws | \yii\base\UserException |
查询可订购号码【号卡用】
接口地址:user/server/search
public array search ( $apiUser, $cid, array $extra, $sign ) | |||
$apiUser | string | 必须 | 接口账号(平台提供) |
$cid | integer | 必须 | 产品ID(平台提供) |
$extra | array | 必须 | 信息
|
$sign | string | 必须 | 签名结果 |
return | array | 返回data结构说明
|
|
---|---|---|---|
throws | \yii\base\UserException |
发送验证码
接口地址:user/server/sms
public array sms ( $apiUser, $mobile, $cid, $sign ) | |||
$apiUser | string | 必须 | 接口账号(平台提供) |
$mobile | string | 必须 | 手机号 |
$cid | integer | 必须 | 产品ID(平台提供) |
$sign | string | 必须 | 签名结果 |
return | array | 返回的data字段说明:code=1-成功,0-失败,-1-办过了,-2-黑名单(禁止办理),msg=code值对应说明 |
|
---|---|---|---|
throws | \yii\base\UserException |
上传照片【号卡用】-每次一张返回存储路径
接口地址:user/server/upload
public array upload ( $apiUser, $cid, $fileKey = 'file', $sign ) | |||
$apiUser | string | 必须 | 接口账号(平台提供) |
$cid | integer | 必须 | 产品ID(平台提供) |
$fileKey | string | 可选 | 文件参数的key值 |
$sign | string | 必须 | 签名结果 |
return | array | 返回data结构说明
|
|
---|---|---|---|
throws | \yii\base\UserException |
存量业务验证码校验【京东天幕专用】
接口地址:user/server/validate
public array validate ( $apiUser, $cid, $mobile, $smsCode, $sign ) | |||
$apiUser | string | 必须 | 接口账号(平台提供) |
$cid | integer | 必须 | 产品ID(平台提供) |
$mobile | string | 必须 | 手机号 |
$smsCode | string | 必须 | 短信验证码 |
$sign | string | 必须 | 签名结果 |
return | array | 返回data结构说明: code=0/1(1:成功,0:失败),msg='描述' |
---|
异步回调
接口地址:由分销商提供
public array validate ( $apiUser, $cid, $mobile, $smsCode, $sign ) | |||
$userOrderSn | string | 必须 | 分销商订单号 |
$status | integer | 必须 | 订单状态。0:待处理 40:处理失败 20:办理成功 24:已退订 |
$msg | string | 必须 | 订单说明 |
$extra | string | 必须 | 返回结果 |