按需使用量推送（新）

接口说明

用户在云商店开通按需资源并产生使用量后，ISV需通过此接口返回用户的实际使用量话单，云商店获取话单后根据使用量计费并对用户扣费。

SDK请参考《获取SDK》。

如何获取AK/SK请参考《AK/SK认证说明》。

URI

POST https://mkt.myhuaweicloud.com/api/mkp-openapi-public/global/v1/isv/usage-data

“mkt.myhuaweicloud.com”域名不可用时请使用“mkt.myhuaweicloud.cn”进行重试。

① 按需计量商品购买和使用流程

② 用完即停套餐包商品购买和使用流程

请求消息示例：

Post {domain}/api/mkp-openapi-public/global/v1/isv/usage-data
Content-Type:application/json
nonce: 6c63c221-1f6b-4141-8ff4-22f5dfe82b65
ts: 1709690865879
signature: gikLsIgimIscagwSamClFJ1CFT4QprHSDHW…
{ 
    "usage_records": [ 
        { 
            "instance_id": "7f141bf1-aec8-4859-8323-fb3a8ad50721", 
            "record_time": "20220809T091000Z", 
            "begin_time": "20220809T080000Z", 
            "end_time": "20220809T090000Z", 
            "usage_value": "99",
            "metering_sn": "6c75c177b5fe4b8cbb6fc2aa33facfcd" 
        }, 
        { 
            "instance_id": "7f141bf1-aec8-4859-8323-fb3a8ad50721",  
            "record_time": "20220809T091000Z", 
            "begin_time": "20220809T080000Z", 
            "end_time": "20220809T090000Z", 
            "usage_value": "999",
            "metering_sn": "6c75c177b5fe4b8cbb6fc2aa33facfcb"
        } 
    ] 
}

1、接口调用上传时，如果话单数据异常，不会在接口层进行报错；后台定时任务会对上传的数据进行校验和处理，生成可以使用的话单数据。如果后台数据处理失败，需要商家重新进行上报。

异常数据可以在 “卖家中心＞交易管理＞话单管理” 进行查看！

2、话单上报周期要求：

• 按小时计费

  需要至少每小时上报一次话单数据，且最好在消费时间下一个小时的0-15分钟内完成上报，譬如，用户消费时间在13:25，最好在14:00-14:15内上报，这样能及时给用户扣费，否则就会出现扣费延迟，如果无法实现实时上报，需要在2小时完成上报

• 按天计费

  推荐每小时将已经明确的用量话单上报到云商店，如果必须每天汇总上报一次，需要保证必须在次日的00:00-00:15内完成上报，最大不能超过01:00，否则用户的扣费会延迟到下一天

3、话单数据上报要求：

• 资源未关闭：
• 话单开始时间（begin_time）≥资源开始时间
• 话单开始时间（begin_time）≤ 话单结束时间（end_time）≤ 话单上报时间
• 资源关闭后：
• 话单结束时间（end_time）≤ 资源关闭时间

4、话单上报中的时间为UTC 时间，与北京时间相差 8 小时；

5、同一个记录的时间，即begin_time 和end_time 时间都一致的情况下，如多次上报记录，会被识别为重复话单，只会处理第一条数据，一旦话单采集后形成正式账单将无法逆向错误话单（话单采集时间：按天计费为每天凌晨1点，按小时计费为每小时15分）。

重复话单将视为异常，异常数据可以在 “卖家中心＞交易管理＞话单管理” 进行查看！

6、使用量推送接口使用按需接口返回的实例ID，不能使用套餐包返回的实例ID。

 
{ 
   "error_code":"MKT.0000", 
   "error_msg":"Success" 
}
 
{
    "error_code": "94060999",
    "error_msg": "Failed",
    "data": {
        "abnormal_usage_data": [
            {
                "error_code": "005",
                "error_msg": "METERING_SN_DUPLICATE",
                "metering_sn": "6c75c177b5fe4b8cbb6fc2aa33facfcb"
            }
        ]
    }
}