Subscriptions / Как изменить сумму списания по действующей подписке

Как изменить сумму списания по действующей подписке

Чтобы изменить сумму списания по действующей подписке, выполните HTTP-PATCH-запрос https://subscriptions.xsolla.com​/api/v1/projects/{projectId}/subscriptions/{subscriptionId}/price.

Примечание

После изменения суммы пользователю будет отправлено уведомление на email-адрес. Новая сумма списания начнет действовать со следующего платежного периода.

Чтобы изменить сумму списания для новых подписок, используйте метод Обновление плана. Новая сумма списания будет применяться только для новых подписок, все существующие подписки будут продолжать действовать на старых условиях.

Запрос к методу должен содержать заголовок Authorization: Basic <your_authorization_basic_key>, где <your_authorization_basic_key> — пара merchant_id:api_key, закодированная по стандарту Base64.

Значения параметров вы можете найти в Личном кабинете:

  • merchant_id указан:
    • В разделе Настройки проекта > Вебхуки.
    • Разделе Настройки компании > Компания.
    • Aдресной строке браузера на любой странице Личного кабинета. URL-адрес имеет вид https://publisher.xsolla.com/&amp;lt;merchant ID>/<Publisher Account section>.
  • api_key отображается в Личном кабинете только при создании и должен храниться на вашей стороне. Создать ключ можно в разделах:
    • Настройки компании > Ключи API;
    • Настройки проекта > Ключи API.

В качестве path-параметров передайте:

ПараметрТипОписание
projectId
integerОбязательный. ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.
subscriptionId
integerОбязательный. ID подписки.
В теле запроса передайте:
ПараметрТипОписание
amount
floatОбязательный. Значение суммы списания по подписке.
currency
stringОбязательный. Трехбуквенное обозначение валюты согласно стандарту ISO 4217.
Пример запроса:
Copy
Full screen
Small screen
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 — Подписка не найдена.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 31 июля 2024

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!