使用费用

您可以使用UsageCharge资源将可变的使用费添加到现有的经常性应用程序费用中。您可以使用这些资源来支持每月不同的计费计划,无论是否需要每月重复性费用。

产生使用费

要使用UsageCharge资源,请先创建一个周期性的应用程序费用。这将返回创建相关使用费所需的ID。

要创建使用费,请发送POST请求,其中{id}代表先前创建的重复性应用程序费的ID。

邮政

/admin/recurring_application_charges/{id}/usage_charges.json

收费仅供使用

常见的计费方案是仅收取基于使用的费用,而不收取固定的重复性月费。要仅收取基于使用的费用,而没有每月的重复费用,请首先创建价格为0.00美元的重复申请费用,然后再应用该使用费用。

设置上限金额

您可以使用RecurringApplicationCharge资源来指定适用于基于使用情况的计费的上限金额。这样可以防止向客户收取超出上限金额的任何使用费用。要实施上限金额计费,请创建具有上限美元金额的循环应用程序费用,然后创建相关的使用费用。

笔记

上限金额设置适用于每个结算周期(30天),除非更新,否则该设置一直有效。

有关使用示例逐步完成此流程的分步指导,请参阅我们的实施指南

您可以使用UsageCharge做什么

Shopify API使您可以使用UsageCharge资源执行以下操作。这些常规操作的更详细的版本可能可用:

UsageCharge属性

created_at plain "created_at": "2013-06-27T08:48:27-04:00" 创建使用费的日期和时间(ISO 8601格式)。
描述 plain "description": "Super Mega Plan 1000 emails" 使用费的名称。
ID plain "id": 675931192 使用费的ID。
价格 plain "price": 1 使用费的价格。
recurring_application_charge_id plain "recurring_application_charge_id": 527669426 使用费所属的重复申请费用的ID。
Updated_at plain "updated_at": "2013-06-27T08:48:27-04:00" 上次更新使用费的日期和时间(ISO 8601格式)。

终点

邮政/admin/api/2021-01/recurring_application_charges/{recurring_application_charge_id}/usage_charges.json 产生使用费

创建新的使用费

POST /admin/api/2021-01/recurring_application_charges/455696195/usage_charges.json

{

“ usage_charge” : {

  1. “说明” :“超级超级计划1000电子邮件”,
  2. “价格” 1.0

}

}

查看回应

尝试创建没有价格和说明的费用会返回错误

POST /admin/api/2021-01/recurring_application_charges/455696195/usage_charges.json

{

“ usage_charge” : {

  1. description :“”

}

}

查看回应

得到/admin/api/2021-01/recurring_application_charges/{recurring_application_charge_id}/usage_charges/{usage_charge_id}.json 检索单笔费用
领域 以逗号分隔的字段列表,包括在响应中。

取回单笔费用

GET /admin/api/2021-01/recurring_application_charges/455696195/usage_charges/1034618210.json

查看回应

得到/admin/api/2021-01/recurring_application_charges/{recurring_application_charge_id}/usage_charges.json 检索使用费清单
领域 以逗号分隔的字段列表,包括在响应中。

检索所有使用费

GET /admin/api/2021-01/recurring_application_charges/455696195/usage_charges.json

查看回应