物联网卡流量充值接口

步骤 1 创建阿里云账号

为了访问服务，您需要有一个阿里云账号。如果没有，可首先按照如下步骤创建阿里云账号：

1. 访问阿里云 官方网站，单击页面上的 免费注册 按钮。
2. 按照屏幕提示完成注册流程并进行实名认证，该服务只支持实名认证用户使用。为了更好地使用阿里云服务，建议尽快完成实名认证，否则部分阿里云服务将无法使用。具体实名认证流程，请参考 这里。

步骤 2 获取阿里云访问密钥

为了使用物理卡 SDK，您必须申请阿里云的访问密钥。

阿里云访问秘钥是阿里云为用户使用 API（非控制台）来访问其云资源设计的“安全口令”。您可以用它来签名 API 请求内容以通过服务端的安全验证。

该访问秘钥成对（AccessKeyId 与 AccessKeySecret）生成和使用。每个阿里云用户可以创建多对访问秘钥，且可随时启用（Active）、禁用（Inactive）或者删除已经生成的访问秘钥对。

您可以通过阿里云控制台的 秘钥管理页面 创建、管理所有的访问秘钥对，且保证它处于“启用”状态。由于访问秘钥是阿里云对 API 请求进行安全验证的关键因子，请妥善保管你的访问秘钥。如果某些秘钥对出现泄漏风险，建议及时删除该秘钥对并生成新的替代秘钥对。

步骤 3 在控制台完成购卡行为后，且卡被用户正常激活后，获得调用接口必备的参数

ICCID

请到阿里云控制台下的物联网无线服务下的卡管理页面，获取已经正常激活的卡对应的iccid值

offerId

需要给指定的卡充值的套餐编号，同业务对接人处获取

参数

请求参数

EffCode 特殊说明

1000:立即生效；

AUTO_ORD:自动在当前套餐失效后，续订上本次套餐，若有多个未生效套餐，则本次续订是从最后一个未生效套餐开始往后续)

其他请求参数请参见 公共请求参数

出参列表

IotRecharge样例

公共返回参数，详见 公共请求参数

技术对接步骤

1:下载SDK工具包

SDK&DEMO[下载地址]

2: 编写样例程序

注：有备注无需修改的位置请勿改动。

// 代码节选，详见aliyun-dyiot-php-sdk/api_demo/IotDemo.php
...
class IotDemo
{
    ...
    /**
     * 物联网卡流量充值
     *
     * @return stdClass
     * @throws ClientException
     */
    public static function doIotRecharge() {
        $request = new DoIotRechargeRequest();
        //填入你要查询的iccid值
        $request->setIccid('yourIccid');
        $request->setOutId('yourOutId');
        $request->setOfferIds('offerId');
        $request->setAmount(0);
        // AUTO_ORD（续订）或者1000（立即生效）
        $request->setEffCode("AUTO_ORD");
        //hint 此处可能会抛出异常，注意catch
        $response = static::getAcsClient()->getAcsResponse($request);
        return $response;
    }
}

返回示例

JSON示例

{
  /* 请求标签，用于追踪错误 */
    "RequestId": "475C4B95-FB6E-4B2A-B0C6-8AAA136B323A",
    /* 请求code，OK代表正常 */
    "Code": "OK",
    /* 异常描述 */
    "Message": "ServiceUnavailable",
    "IotRecharge": {
        "OrderNo": "P0000000182024044", 
        "DoneCode": "1093ys95199815616-1000000083ds46009-792893", 
        "OrderResult": "SUCCESS"
    }
}

错误码