使用费用
您可以使用UsageCharge资源将可变的使用费添加到现有的经常性应用程序费用中。您可以使用这些资源来支持每月不同的计费计划,无论是否需要每月重复性费用。
产生使用费
要使用UsageCharge资源,请先创建一个周期性的应用程序费用。这将返回创建相关使用费所需的ID。
要创建使用费,请发送POST请求,其中{id}
代表先前创建的重复性应用程序费的ID。
邮政
/admin/recurring_application_charges/{id}/usage_charges.json
收费仅供使用
常见的计费方案是仅收取基于使用的费用,而不收取固定的重复性月费。要仅收取基于使用的费用,而没有每月的重复费用,请首先创建价格为0.00美元的重复申请费用,然后再应用该使用费用。
设置上限金额
您可以使用RecurringApplicationCharge资源来指定适用于基于使用情况的计费的上限金额。这样可以防止向客户收取超出上限金额的任何使用费用。要实施上限金额计费,请创建具有上限美元金额的循环应用程序费用,然后创建相关的使用费用。
笔记
上限金额设置适用于每个结算周期(30天),除非更新,否则该设置一直有效。
有关使用示例逐步完成此流程的分步指导,请参阅我们的实施指南。
您可以使用UsageCharge做什么
Shopify API使您可以使用UsageCharge资源执行以下操作。这些常规操作的更详细的版本可能可用:
- POST /admin/api/2021-01/recurring_application_charges/{recurring_application_charge_id}/usage_charges.json产生使用费
- GET /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/{recurring_application_charge_id}/usage_charges.json检索使用费清单
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” : {
“说明” :“超级超级计划1000电子邮件”,
“价格” :1.0
}
}
尝试创建没有价格和说明的费用会返回错误
POST /admin/api/2021-01/recurring_application_charges/455696195/usage_charges.json
{
“ usage_charge” : {
“ 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