重复申请费用

RecurringApplicationCharge资源有助于实现固定值的30天定期费用。您可以通过发送请求来创建应用程序费用，该请求的名称应显示为费用的名称，应用程序要收取的价格，以及在接受费用后Shopify会将商家重定向到的返回URL。创建费用后，将商户重定向到Shopify返回的确认URL。如果费用被拒绝，则Shopify会重定向商家并提供有关应用程序费用被拒绝的通知消息。有关使用示例逐步完成此流程的分步指导，请参阅我们的实施指南。

笔记

为了进行测试，您可以"test": true在创建费用时包括在内。这样可以防止从信用卡中扣款。测试店和演示店不收费。

更新申请费用

每个商店每个应用程式只能收取一笔经常性费用。当为已有商店的商店激活新的重复申请费用时，现有的重复费用将被取消并由新费用代替。然后激活新的经常性费用。

例如，如果您想为特定商人提供折扣价格，则可以为商店创建新的应用程序费用。这将提示商店接受新的费用，以便继续使用该应用程序。新费用取代了以后的旧帐单。

您可以使用RecurringApplicationCharge做什么

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

RecurringApplicationCharge属性

Activated_on	`plain "activated_on": null` 客户激活重复申请费用的日期和时间（ISO 8601格式）。注意：必须激活重复申请费用，否则返回值为`null`。
billing_on	`plain "billing_on": null` 向客户付款的日期和时间（ISO 8601格式）。注意：必须接受重复申请费用，否则返回值为`null`。
cancelled_on	`plain "cancelled_on": null` 商户取消其重复申请费用的日期和时间（ISO 8601格式）。注意：`null`在不取消重复性申请费用时返回。
capped_amount	`plain "capped_amount": "100"` 可以根据使用量计费向客户收取的限额。如果提供了此属性，则还必须提供该`terms`属性。有关更多信息，请参见使用费用。
确认网址	`plain "confirmation_url": "https://apple.myshopify.com/admin/charges/confirm_recurring_application_charge?id=654381177&signature=BAhpBHkQASc%3D--374c02da2ea0371b23f40781b8a6d5f4a520e77b"` 商家接受或拒绝重复申请费用的URL。
created_at	`plain "created_at": "2013-06-27T08:48:27-04:00"` 创建重复申请费用的日期和时间（ISO 8601格式）。
ID	`plain "id": 675931192` 重复申请费用的ID。
姓名	`plain "name": "Super Duper Expensive action"` 重复申请费用的名称。
价格	`plain "price": "100.00"` 重复申请费用的价格。最高价格为10,000。
return_url	`plain "return_url": "http://super-duper.shopifyapps.com"` 接受费用后，商家重定向到的URL。
状态	`plain "status": "accepted"` 定期费用的状态。有效值： + 待处理：经常性费用待处理。 + 接受：在2021-01版本中删除。经常性费用已被接受。从API版本2021-01开始，当商家接受费用时，费用立即从转换`pending`为`active`。 + 激活：经常性充电被激活。这是实际导致向商家收取费用的唯一状态。从API版本2021-01开始，当商家接受费用时，费用立即从转换`pending`为`active`。 + 拒绝：经常性费用已被拒绝。 + 过期：在创建后的2天内，我们不接受重复收费。 + 冻结：由于未支付商店订阅费用，因此经常性费用被保留。订阅付款恢复后，费用将重新激活。 + 已取消：开发人员取消了收费。
条款	`plain "terms": "$1 for 1000 emails"` 基于使用情况的计费条款和条件。必须存在以创建使用费，例如在`capped_amount`提供属性时。当商家批准应用使用费时向商家显示。
测试	`plain "test": null` 申请费用是否为测试交易。有效值：`true`，`null`。
试用天	`plain "trial_days": 0` 客户有资格获得免费试用的天数。
trial_ends_on	`plain "trial_ends_on": null` 免费试用结束的日期和时间（ISO 8601格式）。
Updated_at	`plain "updated_at": "2013-06-27T08:48:27-04:00"` 周期性更新申请费用的最后日期和时间（ISO 8601格式）。

终点

邮政/admin/api/2021-01/recurring_application_charges.json 产生重复的申请费用

创建经常性申请费用

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

{

“ recurring_application_charge” ： {

“名称” ：“超级骗子计划”，
“价格” ：10.0，
“ return_url” ：“ [http://super-duper.shopifyapps.com](http://super-duper.shopifyapps.com)”

}

查看回应

使用条款和上限金额创建新费用

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

{

“ recurring_application_charge” ： {

“名称” ：“超级骗子计划”，
“价格” ：10.0，
“ return_url” ：“ [http://super-duper.shopifyapps.com](http://super-duper.shopifyapps.com)”，
“上限金额” ：100，
“ terms” ：“ $ 1对于1000封电子邮件”

}

查看回应

创建不会导致从信用卡中扣款的定期测试费用

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

{

“ recurring_application_charge” ： {

“名称” ：“超级骗子计划”，
“价格” ：10.0，
“ return_url” ：“ [http://super-duper.shopifyapps.com](http://super-duper.shopifyapps.com)”，
“测试” ：是

}

查看回应

创建一个具有试用期的新费用。试用期将在激活经常性收费时生效。

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

{

“ recurring_application_charge” ： {

“名称” ：“超级骗子计划”，
“价格” ：10.0，
“ return_url” ：“ [http://super-duper.shopifyapps.com](http://super-duper.shopifyapps.com)”，
“ trial_days” ：5

}

查看回应

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

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

{

“ recurring_application_charge” ： {

“名称” ：“”

}

查看回应

得到/admin/api/2021-01/recurring_application_charges/{recurring_application_charge_id}.json 检索单笔费用

领域	以逗号分隔的字段列表，包括在响应中。

取回单笔费用

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

查看回应

得到/admin/api/2021-01/recurring_application_charges.json 检索重复的应用程序费用列表

since_id	将结果限制为指定的ID之后。
领域	以逗号分隔的字段列表，包括在响应中。

检索所有经常发生的申请费用

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

查看回应

检索指定ID以来的所有经常性费用

GET /admin/api/2021-01/recurring_application_charges.json?since_id=455696195

查看回应

删除/admin/api/2021-01/recurring_application_charges/{recurring_application_charge_id}.json 取消重复的申请费用

取消商店当前的经常性费用

删除/admin/api/2021-01/recurring_application_charges/455696195.json

查看回应

放/admin/api/2021-01/recurring_application_charges/{recurring_application_charge_id}/customize.json?recurring_application_charge[capped_amount]=200 更新有效的经常性申请费用的上限金额

增加商店的上限金额

PUT /admin/api/2021-01/recurring_application_charges/455696195/customize.json?recurring_application_charge [封顶金额] = 200

查看回应