用户提单接口

方法列表

方法说明
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 必须

返回结果