赠送订阅
可在您的应用程序中提供让用户向他人赠送订阅的功能。这样可以增加收入并吸引新用户。
运行机制
用户可通过指定受赠人的帐户信息向系统中的现有用户赠送订阅，或通过指定受赠人的邮箱地址向新用户赠送订阅。此情况下，送礼人可以选择隐藏姓名或在礼物邮件通知中留言。创建订阅后，收礼人成为订阅的所有人。创建的订阅属于一次性付款续订类型。
向现有用户赠送订阅的交互过程：
向新用户赠送订阅的交互过程：
如何设置
您可以在您的应用中设置赠送订阅的功能：
向现有用户赠送
- 在应用程序中实现购买送礼订阅的界面，其中包含以下元素：
- 输入收礼人数据的字段
- 输入送礼人留言的字段（可选）
- 匿名赠送的选项（可选）
- 选择订阅计划的元素（可选）
- 实现在填写礼物详情后前往支付时接收令牌。方法是，向创建令牌API调用传入
purchase.subscription.gift对象和以下参数：recipient— 订阅接收人的ID。必需。email— 接收人的邮箱地址。必需。redirect_url— 重定向URL。提供包含受赠订阅额外信息或项目主页面的页面链接。
注意
如令牌中未传入
redirect_url，收礼人将无法从礼物通知邮件中跳转到受赠的订阅。- 此外，您还可以在
purchase.subscription对象中传入以下参数：gift.anonymous— 该礼物是否为匿名发送。如为true，将在邮件通知中隐藏送礼人姓名。默认为false。gift.message— 送礼人留言。在受赠订阅的邮件通知中发送。plan_id— 订阅计划ID。
请求接收令牌的示例：
Copy
- javascript
{
"purchase": {
"checkout": {
"currency": "USD",
"amount": 10
},
"subscription": {
"gift": {
"recipient": "test_recipient_v1",
"email": "recipient_email@email.com",
"redirect_url": "https://example.com/",
"anonymous": true,
"message": "Happy birthday!"
}
}
},
"settings": {
"currency": "USD",
"language": "en",
"project_id": 16184,
"ui": {
"components": {
"virtual_currency": {
"custom_amount": true
}
},
"desktop": {
"virtual_item_list": {
"button_with_price": true,
"layout": "list"
}
},
"size": "medium"
}
},
"user": {
"country": {
"allow_modify": true,
"value": "US"
},
"age": 19,
"email": {
"value": "john.smith@mail.com"
},
"id": {
"value": "user_2"
},
"name": {
"value": "John Smith"
}
}
}
- 使用步骤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
- javascript
{
"purchase": {
"checkout": {
"currency": "USD",
"amount": 10
},
"subscription": {
"gift": {
"recipient": "test_recipient_v1",
"email": "recipient_email@email.com",
"redirect_url": "https://example.com/",
"anonymous": true,
"message": "Happy birthday!"
}
}
},
"settings": {
"currency": "USD",
"language": "en",
"project_id": 16184,
"ui": {
"components": {
"virtual_currency": {
"custom_amount": true
}
},
"desktop": {
"virtual_item_list": {
"button_with_price": true,
"layout": "list"
}
},
"size": "medium"
}
},
"user": {
"country": {
"allow_modify": true,
"value": "US"
},
"age": 19,
"email": {
"value": "john.smith@mail.com"
},
"id": {
"value": "user_2"
},
"name": {
"value": "John Smith"
}
}
}
- 使用步骤4中收到的令牌在新窗口、Iframe中打开支付界面或使用Pay Station Embed打开。
本文对您的有帮助吗？
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
