赠送订阅

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

运行机制

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

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

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

如何设置

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

向现有用户赠送

  1. 在应用程序中实现购买送礼订阅的界面,其中包含以下元素:
    • 输入收礼人数据的字段
    • 输入送礼人留言的字段(可选)
    • 匿名赠送的选项(可选)
    • 选择订阅计划的元素(可选)

  1. 实现在填写礼物详情后前往支付时接收令牌。方法是,向创建令牌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
{
  "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"
    }
  }
}
  1. 使用步骤2中收到的令牌在新窗口Iframe中打开支付界面或使用Pay Station Embed打开。

向新用户赠送

  1. 在应用程序中实现购买送礼订阅的界面,其中包含以下元素:
    • 输入收礼人邮箱地址的字段
    • 输入送礼人留言的字段(可选)
    • 选择匿名赠送的选项(可选)
    • 选择订阅计划的元素(可选)
  2. 实现在您的系统中创建新用户并向其分配一个ID。
  3. 创建一个激活用户帐户的链接。
注:
订阅可以仅向授权的用户销售。
  1. 实现在填写礼物详情后前往支付时接收令牌。方法是,向创建令牌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
{
  "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"
    }
  }
}
  1. 使用步骤4中收到的令牌在新窗口Iframe中打开支付界面或使用Pay Station Embed打开。
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
为此页面评分
为此页面评分
我们还有其他可改进之处吗?

不想回答

感谢您的反馈!
上次更新时间: 2024年1月22日

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

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!