赠送订阅

可在您的应用程序中提供让用户向他人赠送订阅的功能。这样可以增加收入并吸引新用户。

运行机制

用户可通过指定受赠人的帐户信息向系统中的现有用户赠送订阅，或通过指定受赠人的邮箱地址向新用户赠送订阅。此情况下，送礼人可以选择隐藏姓名或在礼物邮件通知中留言。创建订阅后，收礼人成为订阅的所有人。创建的订阅属于一次性付款续订类型。

向现有用户赠送订阅的交互过程：

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant G as 赠送者
    participant R as 接收者
    participant BE as 应用程序
    participant X as 艾克索拉
    G->>BE: 选择现有用户作为订阅接收方，并选择订阅计划。<br>（可选）选择匿名赠送并添加留言
    activate BE
    BE->>X: 发送赠送者ID和电子邮箱、<br>接收者ID和电子邮箱、订阅计划ID。<br>（可选）发送：匿名选项、<br>赠送者留言、重定向URL、商品ID
    activate X
    X-->>BE: 发送购买令牌
    deactivate X
    BE-->>G: 发送支付UI链接
    deactivate BE
    G->>X: 打开支付UI
    activate X
    activate X
    Note right of X: 请求验证用户
    deactivate X
    X->>BE: 发送“用户验证”Webhook
    activate BE
    BE-->>X: 返回成功响应
    deactivate BE
    X-->>G: 允许输入支付数据
    deactivate X
    G->>X: 安全传输支付数据
    activate X
    X->>BE: 发送“支付成功”Webhook
    activate BE
    BE-->>X: 返回成功响应
    deactivate BE
    X-->>G: 显示购买成功界面
    X->>BE: 发送“创建订阅”Webhook
    activate BE
    BE-->>X: 返回成功响应
    deactivate BE
    X-->>G: 发送支付凭证（收据）
    X-->>R: 发送礼品邮件，其中包含匿名信息、赠送者留言和重定向URL
    activate R
    R->>BE: 打开邮件中的重定向URL并查看获赠订阅信息
    activate BE
    BE-->>R: 返回成功响应
    deactivate BE
    deactivate R
    deactivate X

向新用户赠送订阅的交互过程：

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant G as 赠送者
    participant R as 接收者
    participant BE as 应用程序
    participant X as 艾克索拉
    G->>BE: 输入新用户的电子邮箱以赠送订阅，选择订阅计划。<br>（可选）选择匿名赠送并添加留言
    activate BE
    BE->>X: 发送赠送者ID和电子邮箱、<br>接收者电子邮箱、重定向URL、订阅计划ID。<br>（可选）发送：匿名选项、<br>赠送者留言、商品ID
    activate X
    X-->>BE: 发送购买令牌
    deactivate X
    BE-->>G: 发送支付UI链接
    deactivate BE
    G->>X: 打开支付UI
    activate X
    activate X
    Note right of X: 请求验证用户
    deactivate X
    X->>BE: 发送“用户验证”Webhook
    activate BE
    BE-->>X: 返回成功响应
    deactivate BE
    X-->>G: 允许输入支付数据
    deactivate X
    G->>X: 安全传输支付数据
    activate X
    X->>BE: 发送“支付成功”Webhook
    activate BE
    BE-->>X: 返回成功响应
    deactivate BE
    X-->>G: 顯示購買成功界面
    X->>BE: 发送“创建订阅”Webhook
    activate BE
    BE-->>X: 返回成功响应
    deactivate BE
    X-->>G: 发送支付凭证（收据）
    X-->>R: 发送礼品邮件，其中包含赠送者留言和重定向URL。<br>如果选择匿名赠送，则隐藏赠送者姓名。
    deactivate X
    activate R
    R->>BE: 打开邮件中的重定向URL
    activate BE
    BE-->>R: 打开身份认证表单
    deactivate BE
    R->>BE: 创建账户并接收获赠订阅
    activate BE
    BE-->>R: 返回成功响应
    deactivate BE
    deactivate R

如何设置

您可以在您的应用中设置赠送订阅的功能：

赠送给现有用户
赠送给新用户

向现有用户赠送

在应用程序中实现购买送礼订阅的界面，其中包含以下元素：
- 输入收礼人数据的字段
- 输入送礼人留言的字段（可选）
- 匿名赠送的选项（可选）
- 选择订阅计划的元素（可选）

实现在填写礼物详情后前往支付时接收令牌。方法是，向创建令牌API调用传入purchase.subscription.gift对象和以下参数：
- recipient — 订阅接收人的ID。必需。
- email — 接收人的邮箱地址。必需。
- redirect_url — 重定向URL。提供包含受赠订阅额外信息或项目主页面的页面链接。

如令牌中未传入redirect_url，收礼人将无法从礼物通知邮件中跳转到受赠的订阅。

此外，您还可以在purchase.subscription对象中传入以下参数：
- gift.anonymous — 该礼物是否为匿名发送。如为true，将在邮件通知中隐藏送礼人姓名。默认为false。
- gift.message — 送礼人留言。在受赠订阅的邮件通知中发送。
- plan_id — 订阅计划ID。

请求接收令牌的示例：

Copy

Full screen

Small screen

 1{
 2  "purchase": {
 3    "checkout": {
 4      "currency": "USD",
 5      "amount": 10
 6    },
 7    "subscription": {
 8      "gift": {
 9        "recipient": "test_recipient_v1",
10        "email": "[email protected]",
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": "[email protected]"
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

Full screen

Small screen

 1{
 2  "purchase": {
 3    "checkout": {
 4      "currency": "USD",
 5      "amount": 10
 6    },
 7    "subscription": {
 8      "gift": {
 9        "recipient": "test_recipient_v1",
10        "email": "[email protected]",
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": "[email protected]"
44    },
45    "id": {
46      "value": "user_2"
47    },
48    "name": {
49      "value": "John Smith"
50    }
51  }
52}

使用步骤4中收到的令牌在新窗口、Iframe中打开支付界面或使用Pay Station Embed打开。

感谢您的反馈！

我们会查看您的留言并运用它改进用户体验。

上次更新时间: 2026年7月29日

发现了错别字或其他内容错误？请选择文本，然后按Ctrl+Enter。

运行机制
如何设置
向现有用户赠送
向新用户赠送