better-stripe
一、 凸组件 对于Stripe Accounts v2， 计费和连接市场。它提供结帐，订阅，webhook 与React同步，市场费用和分割，支付，退款和争议 钩子和无头UI组件。
版本： 0.111.0 (pre - 1.0)。在1.0之前，API可能会在小版本之间发生变化。
连接平台使用默认的GA API版本。非联网商户使用 仅限客户的帐户v2需要预览访问权限和显式预览版本。 读了 Accounts v2安装指南 在集成之前。
包和应用程序职责
BetterStripe拥有可重复使用的支付协议、财务记录、持久执行、 和无样式的React工作流。示例应用程序演示了这些公共api 凸绑定和样式渲染器。消费者不需要复制其付款方式 或UI控制器来使用包。
您的应用程序验证呼叫者，授权原始帐户或付款， 选择产品和业务策略，并决定付费购买解锁的内容。 一次性购买使用付款结账；订阅使用订阅签出。 数字下载、访问授权、许可密钥、运输和履行属于 消费应用程序。一个成功的结帐页面本身并不是付款的证明。 使用经过验证的支付状态并使履行幂等。
看到 示例边界审计 获取具体的所有权规则和其余的应用程序适配器。
安装
npm install @fantastic.dev/better-stripe
需要Node.js 20+，凸 ^1.46.0，以及React/React DOM ^18.3.1 或者 ^19.0.0.
条带sdk作为依赖项包含。
快速启动
集 STRIPE_SECRET_KEY 在您的Convex部署中，然后连接组件、客户端、
而webhook路由如下。看到 配置 对所有
环境变量和TypeScript设置。
步骤1：注册组件
// convex/convex.config.ts
import betterStripe from "@fantastic.dev/better-stripe/convex.config";
import { defineApp } from "convex/server";
import { v } from "convex/values";
// betterStripe requires STRIPE_SECRET_KEY; declare it at the app level and pass
// it to the component by reference.
const app = defineApp({
env: { STRIPE_SECRET_KEY: v.string() },
});
app.use(betterStripe, {
env: { STRIPE_SECRET_KEY: app.env.STRIPE_SECRET_KEY },
});
export default app;
步骤2：创建BetterStripe实例
// convex/stripe.ts
import { BetterStripe } from "@fantastic.dev/better-stripe";
import { components } from "./_generated/api";
export const stripe = new BetterStripe(components.betterStripe, {
STRIPE_SECRET_KEY: process.env.STRIPE_SECRET_KEY,
triggers: {
checkoutSession: {
onCompleted: async (ctx, session) => {
// App-specific transactional logic (same DB transaction)
},
},
},
});
// Export the webhook handler pair; http.ts passes their refs to registerRoutes.
// `syncWebhook` runs your sync triggers in the same transaction as the component
// upsert; `asyncWebhook` runs your async hooks after commit.
export const { syncWebhook, asyncWebhook } = stripe.webhookHandlers();
步骤3：注册webhook路由
// convex/http.ts
import { registerRoutes } from "@fantastic.dev/better-stripe";
import { httpRouter } from "convex/server";
import { components, internal } from "./_generated/api";
const http = httpRouter();
registerRoutes(http, components.betterStripe, {
webhookPath: "/stripe/webhook",
stripeSecretKey: process.env.STRIPE_SECRET_KEY,
webhookSecret: process.env.STRIPE_WEBHOOK_SECRET,
webhookSecretV2: process.env.STRIPE_WEBHOOK_SECRET_V2,
webhooks: internal.stripe,
});
export default http;
通过 webhooks: internal.stripe 在同一事务中运行同步触发器
作为组件写入。异步钩子在提交后运行。看到 webhook和触发器
用于事件目的地、签名秘密和钩子示例。
创建指向的单独的V1快照和V2瘦事件目的地
https://<your-deployment>.convex.site/stripe/webhook． 存储他们的签名秘密
作为 STRIPE_WEBHOOK_SECRET 和 STRIPE_WEBHOOK_SECRET_V2 在您的凸部署中。
遵循 webhook设置 配置两个目的地。
文档
这个 文档索引 列出所有指南。开始:
- 配置、环境变量和API版本。
- 客户端API、服务器方法和恢复工作流。
- webhook和触发器、事件设置和事务回调。
- 反应API 和 工作流实例.
- 市场经济 和 结算和支付.
- 金融的观察 和 支出修正迁移.
- 迁移指南 和 版本切换.
这个 示例应用程序 演示客户、卖家、联盟和管理流程，包括几个结帐 集成风格。
计量使用
使用本地的Stripe账单，即付即付，包括每月单位的超额费用。 以及预付信用卡。开发商选择单位、精度、费率和政策； BetterStripe拥有持久的使用/交付，津贴和信用会计， 更正，原始支付结算和可重用的React工作流。你的应用 拥有身份验证、计费活动和授权。
从……开始 为开发人员和AI代理设置，然后是 可复制的三模式食谱 和 可运行的例子． 使用现有的条纹沙盒和 凸凭证。节拍器是可选的，从来不是先决条件。
看到 反应的观点 和 配置界面 表格，确切的使用，津贴，预付余额和分页历史。 验证矩阵 记录本地付费来源 证明，包装消费者和帐户/时钟限制。现有的应用程序应该跟进 选择采用、模型转换和回滚.
贡献
看到 开发指南 对于本地设置和代码生成，
测试工具 对于固定装置，和 发布指南
出版。运行 pnpm run check:all 在提交更改之前。
许可证
麻省理工学院