Stripe Payment Link 停用后,旧链接和旧订单怎样区分

先给结论:在 Stripe 的 Payment Link 对象里,active 字段只回答一个问题——这个链接的 URL 现在还能不能被顾客正常打开。按来源描述,当 active 为 false 时,访问该 URL 的顾客会看到一个页面,提示链接已停用。它不负责退款,也不撤销已经完成的历史交易。所以“旧链接”和“旧订单”要分开看:前者看链接对象当前是否可用,后者看这笔交易在停用之前是否已经发生。

支付链接、停用、历史记录
本文涉及的概念与核对环节。

区分机制

Payment Link 对象有几个关键字段可以作为核对锚点:

  • id:链接的唯一标识,形如 plink_...。同一个 id 对应同一条链接记录,停用不会让它变成另一条链接。
  • active:布尔值,表示该链接的 URL 是否处于可用状态。false 意味着新访问者会看到停用提示页。
  • url:可分享给顾客的公开 URL。链接停用后,这个地址本身仍是该链接对象的 url,只是访问结果变为停用提示。
  • line_items:该链接售卖的项目。它描述的是链接配置,不是某笔订单的成交记录。

换句话说,停用改变的是“未来还能不能用这个 URL 发起新的结账”,而不是“过去通过它完成的交易是否存在”。来源未说明停用会触发退款、作废历史付款或删除订单,因此不能把 active: false 理解成交易被撤销。

可执行的核对动作

如果你手上有一个疑似停用的链接,可以按下面顺序核对:

  1. 用链接 id 查询 Payment Link 对象,读取 active。若为 false,说明该 URL 对新访问者已停用。
  2. 记录该对象的 id 与 url,确认你讨论的是同一条链接,而不是名称相似的另一条。
  3. 对“旧订单”,不要用 active 判断。应回到对应的交易记录(例如与该链接关联的付款或订单数据)去核对成交时间与状态。来源只说明 active 控制 URL 可用性,并未把它定义为交易状态字段。
  4. 若需要向顾客解释,区分两句话:链接已停用,不能再用于新的结账;停用前已完成的交易按原交易记录处理。

一个可复算的例子(假设值)

假设某链接对象返回:id 为 plink_A,active 为 false,url 为 https://buy.example/plink_A。又假设停用前已有 3 笔通过该链接完成的付款,停用后又有人尝试访问该 URL 2 次。

按来源语义可推得:

  • 新访问的 2 次会看到“链接已停用”的提示页,不会产生新的结账入口。
  • 已完成的 3 笔付款不会因为 active 变为 false 而被自动退款或撤销;它们的处理应依据各自交易记录。
  • 该链接仍是同一条 plink_A,url 不变,变的只是 active 所表示的可用状态。

这个例子里所有数字都是假设,用来演示“链接状态”和“历史交易”是两个维度,不是真实事件。

边界提醒

以上只覆盖来源明确支持的范围:active 控制 URL 是否可用,false 时访问者看到停用提示。来源未给出停用的具体生效时间、对订阅或发票的连带影响、退款规则或任何费率结论,这些都不应凭本文推断。实际核对时,以你账户中该 Payment Link 对象的字段值和对应交易记录为准。

原始资料

docs.stripe.com

上一篇 Stripe 银行转账金额少于订单时如何辨认未结清