如何更改已激活订阅的扣款金额
要更改已激活订阅的扣款金额,请运行HTTP-PATCH请求https://subscriptions.xsolla.com/api/v1/projects/{projectId}/subscriptions/{subscriptionId}/price
。
注:
更改扣款金额后,用户将收到邮件通知,新扣款金额从下一账单周期开始生效。
要更改新订阅的扣款金额,请使用更新计划方法。新金额仅应用于新的订阅,所有现有订阅将继续按照旧条款扣款。
请求必须包含Authorization: Basic <your_authorization_basic_key>
头,其中<your_authorization_basic_key>
是按照Base64标准加密的merchant_id:api_key
对。
前往发布商帐户查找以下参数:
merchant_id
位于:- 项目设置 > Webhooks部分。
- 公司设置 > 公司部分。
- 任意发布商帐户页面的浏览器地址栏URL中。URL的格式如下:
https://publisher.xsolla.com/&lt;merchant ID>/<Publisher Account section>
。
api_key
仅在创建时在发布商帐户中显示一次,必须保存在己侧。您可以在以下部分创建新的密钥:- 公司设置 > API密钥
- 项目设置 > API密钥
以路径参数形式传入:
参数 | 类型 | 描述 |
---|---|---|
projectId | integer | 必需。项目ID。可在发布商帐户项目名称旁边找到该参数。 |
subscriptionId | integer | 必需。订阅ID。 |
参数 | 类型 | 描述 |
---|---|---|
amount | float | 必需。扣款金额值。 |
currency | string | 必需。参照ISO 4217标准的三字母货币代码。 |
Copy
- curl
curl -X PATCH \
'https://subscriptions.xsolla.com/api/v1/projects/{project_id}/subscriptions/{subscription_id}/price' \
-H 'accept: application/json' \
-H 'Authorization: Basic'
{
"amount": 4.99,
"currency": "USD"
}
响应示例:
200
— 扣款金额更改成功400
— 订阅不是激活状态404
— 找不到订阅
本文对您的有帮助吗?
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。