文档中心 > API类目 > 阿里大于API

alibaba.aliqin.fc.iot.rechargeCard (按终端号订购增值业务)

按终端号订购增值业务

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
bill_source String 必须 IMEI 外部计费号类型:写‘ICCID’
bill_real String 必须 abacldjdj iccid的值
offer_id String 必须 123 流量包offerId
out_recharge_id String 必须 123123
  • 最大长度:32
  • 外部id,用来做幂等
    iccid String 必须 1233523 ICCID
    eff_code String 必须 1000 生效时间,1000,立即生效; AUTO_ORD,下周期自动续订
    eff_time Date 可选 2017-01-20 12:01:02 yyyy-MM-dd HH:mm:ss

    响应参数

    名称 类型 示例值 描述
    result Result result
    • └ code
    • String
    • 123
    • code
    • └ model
    • Boolean
    • true
    • model
    • └ success
    • Boolean
    • false
    • success
    • └ msg
    • String
    • msg
    • msg

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaAliqinFcIotRechargeCardRequest req = new AlibabaAliqinFcIotRechargeCardRequest();
    req.setBillSource("IMEI");
    req.setBillReal("abacldjdj");
    req.setOfferId("123");
    req.setOutRechargeId("123123");
    req.setIccid("1233523");
    req.setEffCode("1000");
    req.setEffTime(StringUtils.parseDateTime("2017-01-20 12:01:02"));
    AlibabaAliqinFcIotRechargeCardResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_aliqin_fc_iot_rechargeCard_response>
        <result>
            <code>123</code>
            <model>true</model>
            <success>false</success>
            <msg>msg</msg>
        </result>
    </alibaba_aliqin_fc_iot_rechargeCard_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案
    isv.SYSTEM_ERROR 业务侧系统异常 业务侧系统异常
    isv.USER_MAPPING_NOT_EXIST 用户绑定授权失败 用户绑定授权失败
    isv.PRODUCT_UNSUBSCRIBE 产品服务未开通 请完成相关产品服务开通
    isv.PARAM_ERROR 参数错误 请核对参数
    isv.OUT_ID_REPEAT 外部id重复订购 请用新的流水号完成业务操作,该流水号用来保证一业务致性。
    isv.CUST_INFO_NOT_EXIST 客户信息不存在 客户信息不存在
    isv.ACCOUNT_ERROR 账户异常 账户异常
    isv.OS_FLAG_STOP 业务限制停机 业务限制停机
    isv.ASSETS_NOT_EXIST 资产对象不存在 资产对象不存在
    isv.OFFER_AMOUNT_ERROR 询价异常 询价异常
    isv.DEDUCT_ERROR 扣费异常 扣费异常
    isv.ICCID_NOT_EXIST ICCID不存在 请核对iccid准确性
    isv.OUT_OF_SERVICE_BY_MRG 特殊停机状态不支持发起订购 联系商家核实停机状态
    isv.EFF_TYPE_NOT_SUPPORT 不支持的生效类型 传入正确的生效类型
    92001 卡用户资料不存在 卡用户资料不存在
    isp.OFFER_ORDER_ERROR
    isp.QUERY_ITEM_SKU_ERROR
    93038

    API工具

    如何获得此API

    拥有此API的权限组 可获得/可申请此API权限组的应用类型
    阿里大于通信能力包 飞猪-国内机票   飞猪-门票   飞猪-国际机票   飞猪-度假   飞猪-酒店   飞猪-新业务   电子凭证码商   百川无线应用   商家后台系统   飞猪-商旅  

    FAQ

    返回
    顶部