Чтобы изменить сумму списания по действующей подписке, выполните 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 указан:
- В разделе Настройки компании > Компания.
- Адресной строке браузера на любой странице Личного кабинета. URL-адрес имеет вид: https://publisher.xsolla.com/<merchant_id>.
api_key отображается в Личном кабинете только при создании и должен храниться на вашей стороне. Создать ключ можно в разделах:
- Настройки компании > Ключи API;
- Настройки проекта > Ключи API.

Перейдите в ваш аккаунт, чтобы найти эти параметры:

merchant_id указан:
- В разделе Настройки компании > Компания.
- В URL в адресной строке браузера на любой странице аккаунта. URL имеет следующий формат: https://xsolla.com/for/free-to-play-pc/account/<merchant_id>.
api_key отображается в аккаунте только один раз при создании и должен храниться на вашей стороне. Вы можете создать новый ключ в следующем разделе:
- Настройки компании > Ключи API
- Настройки > Ключи API

Перейдите в ваш аккаунт, чтобы найти эти параметры:

merchant_id указан:
- В разделе Настройки компании > Компания.
- В URL в адресной строке браузера на любой странице аккаунта. URL имеет следующий формат: https://xsolla.com/for/premium-pc-games/account/<merchant_id>.
api_key отображается в аккаунте только один раз при создании и должен храниться на вашей стороне. Вы можете создать новый ключ в следующем разделе:
- Настройки компании > Ключи API
- Настройки > Ключи API

Перейдите в ваш аккаунт, чтобы найти эти параметры:

merchant_id указан:
- В разделе Настройки компании > Компания.
- В URL в адресной строке браузера на любой странице аккаунта. URL имеет следующий формат: https://xsolla.com/for/web-games/account/<merchant_id>.
api_key отображается в аккаунте только один раз при создании и должен храниться на вашей стороне. Вы можете создать новый ключ в следующем разделе:
- Настройки компании > Ключи API
- Настройки > Ключи API

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

Параметр	Тип	Описание
projectId	integer	Обязательный. ID проекта.

Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.

Вы можете найти этот параметр в вашем аккаунте рядом с названием проекта.

Параметр	Тип	Описание
subscriptionId	integer	Обязательный. ID подписки.

В теле запроса передайте:

Параметр	Тип	Описание
amount	float	Обязательный. Значение суммы списания по подписке.
currency	string	Обязательный. Трехбуквенное обозначение валюты согласно стандарту ISO 4217.

Пример запроса:

Copy

Full screen

Small screen

1curl -X PATCH \
2'https://subscriptions.xsolla.com/api/v1/projects/{project_id}/subscriptions/{subscription_id}/price' \
3  -H 'accept: application/json' \
4  -H 'Authorization: Basic'
5
6{
7  "amount": 4.99,
8  "currency": "USD"
9}

Примеры ответов:

200 — Сумма списания успешно изменена.
400 — Подписка не активна.
404 — Подписка не найдена.

Спасибо за обратную связь!

Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.

Последнее обновление: 24 августа 2026

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