用户提单接口

方法列表

方法说明
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结构说明

                          
                            {
                                'appid':'四川移动工号对应的app_id'
                                'js_url':'jsSDK地址'
                                'url':'引用地址'
                            }
throws \yii\base\UserException

获取落地页配置【小程序用】

接口地址:user/server/config

public array config ( $apiUser, $cid, $sign )
$apiUser string 必须

代理商账号(平台提供)

$cid integer 必须

产品id(平台提供)

$sign string 必须

签名

return array

返回 data 结构说明

 {
     "div_dec":"二次确认描述文案",
     ...
 }
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)表示为必须参数

 存量业务:{'sms_code':'短信验证码【京东天幕固定填写:jdTmu】(Y)'}
 号卡业务:{'idName':'身份证姓名(Y)','idNum':'身份证号(Y)','receiverAddress':'收件省市区(/分隔)(Y)','receiverDetail':'详细地址(Y)','bookMobile':'订购号码(选号接口返回)','htId':'活体流水ID【京东天幕平台可选参数】','picFace':'身份证人像面照片存储路径(上传照片接口返回)','picIcon':'身份证国徽面照片存储路径(上传照片接口返回)','picMen':'免冠照片存储路径(上传照片接口返回)'}
$source string 必须

订单来源地址(收单url)

$orderSn string 必须

用户订单编号(回调时用)

$sign string 必须

签名结果

return array

返回data结构说明:

 存量业务:{'code':'1-成功,0-失败,-1-验证码错误','msg':'code值对应说明'}
 号卡业务:{'code':'1-提交成功,0-提交失败','msg':'code值相关说明'}
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 必须

图片信息

 {
     'type':'图片类型(picFace:身份证头像面,picIcon:身份证国徽面,picMen:正面免冠照)',
     'content':'图片信息(以data:image/*;base64开头的Base64图片流)'
 }
$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结构说明

 {
     'code':'1-成功/0-失败/-1-办过了/-2-黑名单/-3-归属地不可办理',
     'msg':'成功提示或失败原因',
     'serialNumber':'四川移动业务且code=1时返回:预下单订单号(调起二确用)',
     'redirectUrl':'沃悦读且code=1时返回:业务办理地址(跳转用)',
     'orderSn':'沃悦读且code=1时返回:动动幺平台订单号'
 }
throws \yii\base\UserException

订单查询

接口地址:user/server/query

public array query ( $apiUser, $orderSn, $sign )
$apiUser string 必须

接口账号(平台提供)

$orderSn string 必须

用户订单编号(四川移动业务使用预下单接口返回的serialNumber)

$sign string 必须

签名结果

return array

返回data结构说明

 {
     'status':'订单状态,0-待处理,1-处理中,20-办理成功,40-办理失败,之后的状态为号卡专有,2-备货中,3-已发货,5-已签收,7-已激活,9-已首充,14-激活失败,44-作废',
     'desc':'订单状态说明',
     'extra':'号卡业务附加参数:bookMobile-订购号码,activeTime-激活时间,deliverTime-发货时间,deliverName-快递公司,deliverSn-快递单号'
 }
throws \yii\base\UserException

查询可订购号码【号卡用】

接口地址:user/server/search

public array search ( $apiUser, $cid, array $extra, $sign )
$apiUser string 必须

接口账号(平台提供)

$cid integer 必须

产品ID(平台提供)

$extra array 必须

信息

 {
     'province':'归属地省份名称',
     'city':'归属地市名称',
     'district':'归属地区名称'
 }
$sign string 必须

签名结果

return array

返回data结构说明

 [
     '13800138000',
     '13800138001',
     '...共十条...'
 ]
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结构说明

 {
     "filePath": "图片存储路径"
 }
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 必须

返回结果