开通页面与小组件
您负责收款,开通流程完全由我们负责。您只需把订单中的链接交给客户,或在网站上嵌入小组件:客户自行提交信息,我们负责校验、开通订阅,并一路引导客户直到「订阅已开通」。
效果演示
这是一个可直接操作的示例,与您的客户看到的小组件完全相同。粘贴任意形如 9959bd2c-8b17-4d16-b9c4-19d972827140 的 ID,然后点击「开通 Pro」。上方可以选择小组件的打开位置和外观:默认使用我们的样式,也可以使用您的品牌。
一切由我们负责,您只需提供链接
- 告诉客户需要提供什么,并提供直达服务方对应页面的按钮
- 提交前校验信息:ID 不完整、用团队 ID 代替了个人 ID、复制了错误的页面
- 开通订阅,并持续显示状态直到「订阅已开通」
- 服务方要求身份验证,或需要客户决定是否「立即开通」时,由我们直接询问客户
- 开通出了问题,由我们排查原因并人工完成开通
- 收款并创建订单:
POST /v1/orders - 把订单中的链接交给客户,或嵌入小组件
- 解答客户的问题,包括付款和退款:中文窗口底部会显示您的联系方式,链接文字为「遇到问题?联系卖家」(账户 →「开通页面」→「付款与退款联系方式」)。中文页面不显示我们的客服入口
您无需保存客户数据:ID、令牌和 session key 会直接发送给我们,不经过您的服务器。
接入方式
- 照常创建订单。 响应中包含该订单的开通页面链接
activation.page_url。不需要开通的交付方式(key、account)以及「新账号」没有该链接,值为null。 - 把链接交给客户 可以做成「开通订阅」按钮、机器人消息或邮件。该页面部署在面向客户的独立地址 https://activate.astrum.shop 上(不会展示我们的商店前台),电脑和手机均可使用。
- 或者在您的网站上嵌入小组件 在「感谢下单」页面加两行代码:脚本在页面中只引入一次,元素放在需要显示小组件的位置,
url填写订单中的page_url。请先在账户的「集成 → 开通页面」中添加网站地址:未添加的网站无法打开小组件。
<script src="https://activate.astrum.shop/activation.js" async></script>
<astrum-activation url="https://activate.astrum.shop/#t=k7Qm2xR9…"></astrum-activation>
小组件会自动调整高度,并适配宽度不小于 320 px 的栏位。如需在您的页面上获取状态,请监听元素上的 status 事件(event.detail.status):waiting → processing → completed;失败时为 failed。服务器端照旧:每一步都会推送 order.updated,包括客户通过页面提交信息时。
如果您的网站设置了 Content-Security-Policy 响应头,请在其中允许 https://activate.astrum.shop:在 script-src 中允许脚本,在 frame-src 中允许小组件窗口。
在沙盒中
测试订单同样带有链接:它指向一个演示页面,无需付款、也无需真实的客户账号即可走完开通流程。
小组件的展示方式
有两种方式,按您网站的需要选择。嵌入代码相同,只有 mode 属性不同。
小组件直接嵌在「感谢下单」页面上:客户无需跳转即可填写信息。
<astrum-activation
url="…">
</astrum-activation>页面上只有一个「开通订阅」按钮。点击后,小组件从底部滑出并覆盖在页面上;在电脑上则以居中窗口打开。适合页面空间有限的情况。
<astrum-activation
url="…"
mode="sheet">
</astrum-activation>两种方式的共同点:元素上的 status 事件、按账户中的列表校验网站,以及您的外观设置。
客户看到的内容
文案由我们提供,以「您」称呼客户,不含技术术语。需要客户回答时,页面会自行询问。
按顺序列出步骤,并提供「粘贴」按钮:提交前即可看到所填内容,包括账号及其套餐、ID 格式。
信息已收到;通常只需几分钟,状态会自动更新。
服务方要求验证账号持有人的身份:按钮会跳转到服务方的页面。
可以等当前订阅到期,也可以立即开通:当前订阅的剩余天数将作废。
显示前往服务的按钮(「打开 ChatGPT ↗」)、「如何确认」,以及「返回商店」(如果您在账户中填写了地址)。
您取消了订单,或客户拒绝了身份验证:款项由您退还给客户,旁边会显示带有您联系方式的「联系卖家 ↗」。
外观
开通页面和小组件默认使用 Astrum Shop 的设计和名称。经协商可以换成您的品牌。品牌外观由我们为您设置:请联系客服商定。
所有人默认使用我们的设计和名称。
使用您的 Logo 和名称,底部显示「技术支持 Astrum Shop」(与您的联系方式在同一行)。
使用您的名称、Logo、颜色和主题;页面上不出现我们的名称。
无需为您的域名单独配置页面地址:如果不想让客户离开您的网站,请嵌入小组件,它会直接在您的页面中打开,外观完全相同。
安全
链接是单笔订单的访问凭证
它只能打开该订单的开通流程,看不到余额、其他订单或商品。链接中的凭证位于 # 之后:浏览器不会把它发送到服务器,它也不会出现在日志和 Referer 中。请只把链接交给下单的客户本人。
如果您使用自己的表单
一切照旧:通过 POST /v1/orders/ 提交客户信息(见「开通」一节)。开通页面和 API 共享同一个开通流程:尝试次数共用,客户在页面上提交的信息也会显示在订单中。
