Подписка в подарок

Вы можете добавить в ваше приложение возможность подарить подписку другому пользователю. Это поможет привлечь дополнительную прибыль или новых пользователей.

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

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

Схема взаимодействия при подарке подписки существующему пользователю:

Схема взаимодействия при подарке подписки новому пользователю:

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

Вы можете настроить в своем приложении возможность подарить подписку:

• существующему пользователю;
• новому пользователю.

Подарок существующему пользователю

1. Реализуйте в вашем приложении интерфейс для  покупки подписки в подарок со следующими элементами:
   • поля для ввода данных получателя подарка;
   • поле ввода сообщения от отправителя (опционально);
   • опцию для выбора анонимной отправки (опционально);
   • элементы для выбора плана подписки (опционально).

2. Реализуйте получение токена после заполнения данных о подарке, при переходе к оплате. Для этого передайте в метод Создание токена объект purchase.subscription.gift c параметрами:
   • recipient — ID получателя подписки. Обязательный.
   • email — email-адрес получателя. Обязательный.
   • redirect_url — URL переадресации. Передайте ссылку на страницу с дополнительной информацией о подаренной подписке или на главную страницу проекта.

• Дополнительно вы можете передать в объекте purchase.subscription параметры:
  • gift.anonymous — отправлен ли подарок анонимно. Если значение true, имя отправителя будет скрыто в email-уведомлении. По умолчанию принимает значение false.
  • gift.message — сообщение от отправителя подарка. Будет отправлено в email-уведомлении о подаренной подписке.
  • plan_id — ID плана подписки.

Пример запроса на получение токена:

 1{
 2  "purchase": {
 3    "checkout": {
 4      "currency": "USD",
 5      "amount": 10
 6    },
 7    "subscription": {
 8      "gift": {
 9        "recipient": "test_recipient_v1",
10        "email": "recipient_email@email.com",
11        "redirect_url": "https://example.com/",
12        "anonymous": true,
13        "message": "Happy birthday!"
14      }
15    }
16  },
17  "settings": {
18    "currency": "USD",
19    "language": "en",
20    "project_id": 16184,
21    "ui": {
22      "components": {
23        "virtual_currency": {
24          "custom_amount": true
25        }
26      },
27      "desktop": {
28        "virtual_item_list": {
29          "button_with_price": true,
30          "layout": "list"
31        }
32      },
33      "size": "medium"
34    }
35  },
36  "user": {
37    "country": {
38      "allow_modify": true,
39      "value": "US"
40    },
41    "age": 19,
42    "email": {
43      "value": "john.smith@mail.com"
44    },
45    "id": {
46      "value": "user_2"
47    },
48    "name": {
49      "value": "John Smith"
50    }
51  }
52}

3. Используя токен, полученный на шаге 2, реализуйте открытие платежного интерфейса в новом окне, в Iframe или c помощью Pay Station Embed.

Подарок новому пользователю

1. Реализуйте в вашем приложении интерфейс для покупки подписки в подарок со следующими элементами:
   • поля для ввода email-адреса получателя подарка;
   • поле ввода сообщения от отправителя (опционально);
   • опцию для выбора анонимной отправки (опционально);
   • элементы для выбора плана подписки (опционально).
2. Реализуйте создание нового пользователя и присвоение ему ID в вашей системе.
3. Реализуйте создание ссылки для активации аккаунта пользователя.

4. Реализуйте получение токена после заполнения данных о подарке, при переходе к оплате. Для этого передайте в метод Создание токена объект purchase.subscription.gift c параметрами:
   • recipient — ID получателя подписки, созданный на шаге 2.
   • email — email-адрес получателя.
   • redirect_url — URL активации, созданный на шаге 3.

• Дополнительно вы можете передать в объекте purchase.subscription параметры:
  • gift.anonymous — отправлен ли подарок анонимно. Если значение true, имя отправителя будет скрыто в email-уведомлении. По умолчанию принимает значение false.
  • gift.message — сообщение от отправителя подарка. Будет отправлено в email-уведомлении о подаренной подписке.
  • plan_id — ID плана подписки.

Пример запроса на получение токена:

 1{
 2  "purchase": {
 3    "checkout": {
 4      "currency": "USD",
 5      "amount": 10
 6    },
 7    "subscription": {
 8      "gift": {
 9        "recipient": "test_recipient_v1",
10        "email": "recipient_email@email.com",
11        "redirect_url": "https://example.com/",
12        "anonymous": true,
13        "message": "Happy birthday!"
14      }
15    }
16  },
17  "settings": {
18    "currency": "USD",
19    "language": "en",
20    "project_id": 16184,
21    "ui": {
22      "components": {
23        "virtual_currency": {
24          "custom_amount": true
25        }
26      },
27      "desktop": {
28        "virtual_item_list": {
29          "button_with_price": true,
30          "layout": "list"
31        }
32      },
33      "size": "medium"
34    }
35  },
36  "user": {
37    "country": {
38      "allow_modify": true,
39      "value": "US"
40    },
41    "age": 19,
42    "email": {
43      "value": "john.smith@mail.com"
44    },
45    "id": {
46      "value": "user_2"
47    },
48    "name": {
49      "value": "John Smith"
50    }
51  }
52}

5. Используя токен, полученный на шаге 4, реализуйте открытие платежного интерфейса в новом окне, в Iframe или c помощью Pay Station Embed.