Stripe Connect

Stripe Connect 为 DevDeck 项目提供平台托管的支付契约。v1 支持一次性结账和订单、固定周期 订阅、全额或部分退款，以及 Stripe Billing Portal。争议处理和证据提交不包含在 v1 中。

Stripe 凭据和 Webhook 由 DevDeck 平台管理。生成项目只使用平台托管的支付 helper，不会获得 Stripe Secret Key，也不会直接调用 Stripe。

连接 Stripe

1. 在 DevDeck 中打开项目。
2. 选择配置 → 连接（Connections）。
3. 找到 Stripe Connect，然后选择连接（Connect）。
4. 在 Stripe 中完成账号资料和验证。
5. 返回 DevDeck，等待连接状态和支付契约都显示为可用。

新连接会自动安装当前契约。仍在使用旧版 Stripe 接入的项目会先显示升级操作；查看升级内容并 明确确认后，DevDeck 才会更新平台托管 helper。升级不会重新连接 OAuth、创建支付或退款， 也不会发布项目。

支付和订单

结账时，项目后端只把商品标识和数量发送给 DevDeck。平台会校验请求、根据可信服务端数据 重新计算金额、创建结算账本订单，再打开 Stripe Checkout。相同结账请求可安全重试；未支付 Checkout 会在 30 分钟后过期。

如果商城使用 Square，商品价格和库存仍以 Square 为准。DevDeck 会重新读取 Square 商品规格， 在打开 Stripe Checkout 前扣减受跟踪库存；如果 Checkout 创建失败、过期或未支付订单被取消， 平台会执行补偿恢复。

订阅

v1 支持按日、周、月或年计费的固定周期订阅。项目可以创建订阅 Checkout、按比例计费变更 有效套餐、在周期结束时取消或立即取消，也可以打开 Stripe Billing Portal。试用、用量计费、 订阅计划表和多阶段订阅不包含在 v1 中。

退款和 Square 补库存

已支付订单支持全额或部分退款。退款请求可安全重试，最终状态由 Stripe 事件同步。

退款不会自动恢复 Square 库存。只有订单已全额退款且商品确实退回后，才能单独发起补库存； 该操作必须经过用户批准。

使用 AI Builder

AI Builder 可以查询订单、订阅、账单和退款。取消未支付订单、创建退款、变更或取消订阅、 恢复 Square 库存等 Provider 修改都会显示待批准操作。请核对目标和金额后再确认。