订阅 | Coin Moebius

Coin Moebius 可以在你菜单里的每一个法币渠道上销售定期订阅。商家在一个商品上把价格和周期配置一次；站点上的买按钮则完全保持不变。支付渠道负责运行定期计费、持有银行卡、重试失败的续费，并托管取消页。Coin Moebius 把生命周期事件转发给你的代码。

设置一个定期商品

在后台的商品标签里，把计费字段设为按月或按年，而非一次性。一个可选的免费试用字段会出现，用于在首次扣款前授予你想要的任何试用天数。保存这个商品。

买按钮的 HTML 不变。同一个 product-id="pro-plan" 属性既适用于一次性也适用于定期；worker 在结账时检查商品的计费设置，并在适用时通过渠道的订阅 API 走流程。

<coin-moebius-buy
  project-id="proj_YOUR_ID"
  product-id="pro-plan"
  label="Subscribe to Pro">
</coin-moebius-buy>

你不必构建的部分

渠道运行排期。我们不存储银行卡。我们不跑定时任务。我们不重试失败的扣款。我们不发催款邮件。我们不托管取消页。系统的那一整侧都活在 Stripe（或你连接的任一法币渠道）里。你是把定期计费里最难的部分外包给那家已经为数百万商家运行着它的公司。

订阅事件

续费和取消会作为你的服务器可以响应的 webhook 事件出现。五种规格化类型覆盖整个生命周期：

事件	何时触发
`subscription.created`	新订阅。携带首个周期的金额。
`subscription.renewed`	一个非首次周期成功了。把访问权延长到新的周期结束。
`subscription.payment_failed`	一个周期的银行卡被拒。渠道的催款会按其排期重试；你通常只是为了可见性记录一下。
`subscription.canceled`	终态取消。买家取消了、催款耗尽了，或商家取消了。
`subscription.updated`	状态变更、银行卡更新、套餐变更。检查新的状态。

在不存储买家的前提下识别买家

Coin Moebius 是一个支付路由器，不是一个客户数据库。我们从不存储买家的邮箱、姓名、地址或渠道的内部客户 id。如果你的应用有用户账户（大多数订阅应用都有），就把你自己的不透明用户 id 作为 customer-ref 传到买按钮上。按钮把它作为 metadata.customerRef 转发给 worker，我们把它穿过渠道、在每个事件上回传，并只存那个不透明字符串。对我们而言它毫无含义；对你而言它是通往你自己用户系统的外键。

<coin-moebius-buy
  project-id="proj_YOUR_ID"
  product-id="pro-plan"
  customer-ref="user_bob_42">
</coin-moebius-buy>

当你需要更深的买家详情（邮箱、卡号后四位、争议备注）时，后台会把每笔银行卡交易链接出去，通往处理它的那个渠道（Stripe、PayPal、Square 或 Authorize.Net），买家记录真正存在那里。你点击穿过去；我们从不复制它。

取消：链接出去，别去构建

买家在渠道的托管门户里取消：Stripe Customer Portal、买家的 PayPal 账户页，等等。该门户处理取消、银行卡更新、收据下载和套餐变更，全是你不必构建的界面。你只需一个 API 调用就能把买家送进门户：

const res = await fetch(
  `https://api.coinmoebius.com/api/subscriptions/${projectId}/${subId}/portal-url`,
  { method: 'POST', body: JSON.stringify({ returnUrl: 'https://you.example/account' }) },
);
const { url } = await res.json();
window.location.assign(url);

如今哪些渠道支持订阅

Stripe 和 PayPal 通过托管买按钮端到端地工作。在后台里把一个商品设为按月或按年，把按钮粘到你的页面上，点击即开启一个真实的订阅。渠道运行续费。

Square 和 Authorize.Net 的订阅不通过托管买按钮运行。你通过自己与渠道的集成来创建订阅（对于 Authorize.Net，那意味着用 Accept.js 在你自己的页面上收集银行卡；Square 有它自己的托管订阅结账可供你使用），然后把渠道的 webhook 指向我们。从那里起，系统的其余部分（webhook 路由、后台、状态端点、客户关联）的工作方式就和 Stripe 与 PayPal 的订阅完全一样。见下一节。

加密货币渠道（NOWPayments）在本产品中不支持定期计费。在我们评估过的每一个网关上，定期加密货币都摩擦重重；我们宁可什么都不发布，也不愿端出一个半残的方案。

订阅

订阅