赠送订阅
可在您的应用程序中提供让用户向他人赠送订阅的功能。这样可以增加收入并吸引新用户。
运行机制
用户可通过指定受赠人的帐户信息向系统中的现有用户赠送订阅，或通过指定受赠人的邮箱地址向新用户赠送订阅。此情况下，送礼人可以选择隐藏姓名或在礼物邮件通知中留言。创建订阅后，收礼人成为订阅的所有人。创建的订阅属于一次性付款续订类型。
向现有用户赠送订阅的交互过程：
向新用户赠送订阅的交互过程：
如何设置
您可以在您的应用中设置赠送订阅的功能：
向现有用户赠送
- 在应用程序中实现购买送礼订阅的界面，其中包含以下元素：
- 输入收礼人数据的字段
- 输入送礼人留言的字段（可选）
- 匿名赠送的选项（可选）
- 选择订阅计划的元素（可选）
- 实现在填写礼物详情后前往支付时接收令牌。方法是，向创建令牌API调用传入
purchase.subscription.gift对象和以下参数：recipient— 订阅接收人的ID。必需。email— 接收人的邮箱地址。必需。redirect_url— 重定向URL。提供包含受赠订阅额外信息或项目主页面的页面链接。
注意
如令牌中未传入
redirect_url，收礼人将无法从礼物通知邮件中跳转到受赠的订阅。- 此外，您还可以在
purchase.subscription对象中传入以下参数：gift.anonymous— 该礼物是否为匿名发送。如为true，将在邮件通知中隐藏送礼人姓名。默认为false。gift.message— 送礼人留言。在受赠订阅的邮件通知中发送。plan_id— 订阅计划ID。
请求接收令牌的示例：
Copy
- json
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}
- 使用步骤2中收到的令牌在新窗口、Iframe中打开支付界面或使用Pay Station Embed打开。
向新用户赠送
- 在应用程序中实现购买送礼订阅的界面，其中包含以下元素：
- 输入收礼人邮箱地址的字段
- 输入送礼人留言的字段（可选）
- 选择匿名赠送的选项（可选）
- 选择订阅计划的元素（可选）
- 实现在您的系统中创建新用户并向其分配一个ID。
- 创建一个激活用户帐户的链接。
注：
订阅可以仅向授权的用户销售。
- 实现在填写礼物详情后前往支付时接收令牌。方法是，向创建令牌API调用传入
purchase.subscription.gift对象和以下参数：recipient— 步骤2中创建的订阅接收人ID。email— 接收人的邮箱地址。redirect_url— 步骤3中创建的激活URL。
注意
如令牌中未传入
redirect_url，收礼人将无法从礼物通知邮件中跳转到受赠的订阅。- 此外，您还可以在
purchase.subscription对象中传入以下参数：gift.anonymous— 该礼物是否为匿名发送。如为true，将在邮件通知中隐藏送礼人姓名。默认为false。gift.message— 送礼人留言。在受赠订阅的邮件通知中发送。plan_id— 订阅计划ID。
请求接收令牌的示例：
Copy
- json
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}
- 使用步骤4中收到的令牌在新窗口、Iframe中打开支付界面或使用Pay Station Embed打开。
本文对您的有帮助吗？
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
