autumn-add-payments

Autumn Payments

代码示例和最新 API 请始终参阅 docs.useautumn.com。

Autumn 会自动处理 Stripe 结账、升级、降级和取消。

---

快速参考

支付流程

1. checkout - 返回 Stripe URL（新客户）或预览数据（回头客）
2. attach - 在卡片已保存时确认购买

结账结果

字段	说明
url	Stripe 结账 URL（已保存卡片时为 null）
product	包含场景信息的目标产品
current_product	客户当前的产品
lines	发票明细项
total	以主要货币单位表示的金额
currency	货币代码

---

产品场景

场景	含义	操作
new	尚未订阅	订阅
active	当前方案	当前方案
scheduled	已安排	已安排
upgrade	更高级别	升级
downgrade	更低级别	降级
renew	已取消	续订

---

React 实现

import { useCustomer, usePricingTable } from "autumn-js/react";

const { checkout, attach } = useCustomer();
const { products } = usePricingTable();

// Checkout flow
const data = await checkout({ productId: "pro" });
if (data.url) {
  window.location.href = data.url;  // New customer
} else {
  // Show confirmation dialog, then:
  await attach({ productId: "pro" });
}

// Cancel
const { cancel } = useCustomer();
await cancel({ productId: "pro" });
// Or downgrade to free:
await attach({ productId: "free" });

---

后端实现

import { Autumn } from "autumn-js";

const autumn = new Autumn({ secretKey: process.env.AUTUMN_SECRET_KEY });

// Checkout
const { data } = await autumn.checkout({ customer_id, product_id: "pro" });
if (data.url) return redirect(data.url);

// Attach (after user confirms)
await autumn.attach({ customer_id, product_id: "pro" });

// Get products with scenarios
const { data: productsData } = await autumn.products.list({ customer_id });

---

预付费定价

对于按席位计费或预付费产品，请传入数量：

await autumn.checkout({
  customer_id,
  product_id: "credits_pack",
  options: [{ feature_id: "credits", quantity: 500 }],
});

---

按钮文本模式

function getButtonText(product: Product): string {
  const { scenario, properties } = product;
  if (properties?.has_trial) return "Start Trial";
  if (scenario === "active") return "Current Plan";
  
  const text = { upgrade: "Upgrade", downgrade: "Downgrade", new: "Subscribe" };
  return text[scenario] ?? "Enable";
}

---

常见注意事项

1. URL 字段 - 使用的是 data.url，而不是 data.checkout_url
2. 不要编写自定义逻辑 - 使用 products.list 获取场景信息
3. 自动按比例计费 - Autumn 会自动处理升级/降级的按比例计费
4. 通过免费方案取消 - 建议关联免费方案，而不是直接取消
5. 成功 URL - 传入 success_url，以便在 Stripe 结账后重定向

---

资源

• 结账文档
• 关联文档
• LLMs.txt