Как разрешить пользователю сменить план подписки

Как это работает

• При выборе нового плана производится возврат средств на баланс пользователя за неиспользованный период текущей подписки.
• Оплата нового плана подписки производится полностью с баланса пользователя. При недостаточном балансе производится доплата любым из разрешенных в проекте способов оплаты.
• Списание средств при смене плана происходит сразу после подтверждения оплаты, даже если в проекте настроена смена плана со следующего расчетного периода.

• Если валюта нового плана отличается от валюты текущего плана, покупка нового плана будет выполнена с конвертацией валют.

• у пользователя уже есть активная подписка с планом, на который меняется текущий план;
• подписка, которую пользователь хочет сменить, не находится в статусе Active;
• план подписки, который пользователь хочет сменить, имеет тип Бесконечный план — такую подписку можно отменить только в указанный период возврата.

Как настроить

1. Откройте проект в Личном кабинете.
2. Нажмите Subscriptions в боковом меню и перейдите в раздел Настройки.
3. В разделе Изменение плана подписки установите переключатель Возможность выбрать другой план подписки в положение Вкл.
4. По умолчанию смена плана разрешена со следующего периода. Чтобы разрешить смену плана в текущем периоде, выберите пункт Текущее время. При выборе этой опции план будет меняться сразу после подтверждения оплаты.
5. Чтобы разрешить смену плана более одного раза в день, установите переключатель Возможность выбрать другой план подписки несколько раз в день в положение Вкл.
6. При открытии платежного интерфейса используйте:
   • серверный метод создания токена;
   • клиентский метод получения ссылки на открытие платежного интерфейса, если в проекте настроен Xsolla Login.

Открытие платежного интерфейса с помощью серверного метода создания токена

1. Получите токен для открытия платежного интерфейса. При этом передайте в метод:
   • значение change_plan в параметре purchase.subscription.operation;
   • ID нового плана в параметре purchase.subscription.plan_id;
   • ID продукта подписки в параметре purchase.subscription.product_id, если вы используете продукты подписки. Для его получения обратитесь к персональному менеджеру проекта или напишите на [email protected].
2. Откройте платежный интерфейс одним из способов:
   • с помощью скрипта Pay Station Embed;
   • в iframe;
   • в новом окне.

Открытие платежного интерфейса на странице управления подписками с помощью клиентского метода

Если в проекте настроен Xsolla Login, вы можете использовать клиентский метод получения ссылки на открытие платежного интерфейса. Возвращенная в ответе ссылка позволяет открыть платежный интерфейс на странице управления подписками, где пользователь сможет выбрать активную подписку и сменить ее.

Чтобы сделать это, в клиентской части вашего приложения реализуйте получение ссылки на платежный интерфейс с использованием HTTP POST-запроса https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/manage. Запрос к методу должен содержать заголовок Authorization: Bearer <client_user_jwt>, где <client_user_jwt> — JSON Web Token (JWT) пользователя — уникальный токен, закодированный по стандарту Base64. Используйте для его получения:

• Методы API Register new user и Auth by username, если в вашем приложении используется авторизация по логину и паролю.
• Метод API Auth via social network, если в вашем приложении используется авторизация через социальные сети.

При необходимости передайте дополнительные параметры для кастомизации платежного интерфейса.

Параметры тела запроса:

 1curl -X 'POST' \
 2'https://subscriptions.xsolla.com/api/user/v1/projects/{project_id}/subscriptions/manage?country=RU  ' \
 3  -H 'accept: application/json' \
 4  -H 'Authorization: Bearer client_user_jwt'
 5{
 6  "settings": {
 7    "ui": {
 8      "size": "large",
 9      "theme": "string",
10      "version": "desktop",
11      "desktop": {
12        "header": {
13          "is_visible": true,
14          "visible_logo": true,
15          "visible_name": true,
16          "type": "compact",
17          "close_button": true
18        }
19      },
20      "mobile": {
21        "mode": "saved_accounts",
22        "footer": {
23          "is_visible": true
24        },
25        "header": {
26          "close_button": true
27        }
28      },
29      "license_url": "string",
30      "mode": "user_account",
31      "user_account": {
32        "history": {
33          "enable": true,
34          "order": 1
35        },
36        "payment_accounts": {
37          "enable": true,
38          "order": 1
39        },
40        "info": {
41          "enable": true,
42          "order": 1
43        },
44        "subscriptions": {
45          "enable": true,
46          "order": 1
47        }
48      }
49    },
50    "currency": "str",
51    "locale": "st",
52    "external_id": "string",
53    "payment_method": 1,
54    "return_url": "string",
55    "redirect_policy": {
56      "redirect_conditions": "none",
57      "delay": 0,
58      "status_for_manual_redirection": "none",
59      "redirect_button_caption": "string"
60    }
61  }
62}

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

1{
2  "link_to_ps": "https://secure.xsolla.com/paystation2/?access_token=<access_token>"
3}