跳到主要内容
哒哒星球DADA PLANET

Skill · 已公开版本

stripe-best-practices · 设计稳妥的支付接入流程

选择 Checkout、PaymentIntent、订阅、税务或 Connect 接口并检查密钥与 webhook。

先看看示例

作者提供的示例,实际效果取决于你的输入和使用工具。

输入

编辑构造材料(未运行):
一次性商品;现方案在用户跳转 success 页面后直接发货;已考虑异步支付;不涉及订阅和税费配置。

输出

编辑示例 · 未运行
审阅意见:

  1. success 页面只能展示结果,不能作为发货依据,因为浏览器访问不能证明款项已成功。
  2. 将履约放到已验证签名的服务端 webhook 处理,覆盖 checkout.session.completed 与 checkout.session.async_payment_succeeded,并检查 payment_status。
  3. 用订单/会话标识保证重复事件只履约一次。
  4. 在独立 sandbox 验证异步成功与重复投递;当前尚未运行这些测试。

方法说明

选择 Checkout、PaymentIntent、订阅、税务或 Connect 接口并检查密钥与 webhook。

具体任务

审查支付完成与履约的边界:选择 Checkout、PaymentIntent、订阅、税务或 Connect 接口并检查密钥与 webhook。

必需材料

商品或订阅的支付流程

现有 Checkout/webhook 设计与测试环境

可选材料

当前 API/SDK 版本

税务注册和密钥权限配置

使用门槛

理解支付状态与订单履约的区别,拥有独立测试环境。

这个 Skill 额外提供的方法

先按业务选择 Checkout/Billing/Connect 等路径,再检查隔离 sandbox、restricted key 和服务端 webhook 履约。

编辑示例(未运行)

审查支付完成与履约的边界

任务:审查支付完成与履约的边界

输入:
编辑构造材料(未运行):
一次性商品;现方案在用户跳转 success 页面后直接发货;已考虑异步支付;不涉及订阅和税费配置。

结果片段:
审阅意见:
1. success 页面只能展示结果,不能作为发货依据,因为浏览器访问不能证明款项已成功。
2. 将履约放到已验证签名的服务端 webhook 处理,覆盖 checkout.session.completed 与 checkout.session.async_payment_succeeded,并检查 payment_status。
3. 用订单/会话标识保证重复事件只履约一次。
4. 在独立 sandbox 验证异步成功与重复投递;当前尚未运行这些测试。

这是依据固定入口方法撰写的编辑示例,没有运行上游 Skill 或访问真实账号。先按业务选择 Checkout/Billing/Connect 等路径,再检查隔离 sandbox、restricted key 和服务端 webhook 履约。

首次任务

请使用已安装的 stripe-best-practices Skill。
任务:审查支付完成与履约的边界。

我的必需材料:
- 商品或订阅的支付流程:[粘贴我的实际材料或路径;缺少时写明]
- 现有 Checkout/webhook 设计与测试环境:[粘贴我的实际材料或路径;缺少时写明]

可选补充:
- 当前 API/SDK 版本:[可选,未提供时不要假定存在]
- 税务注册和密钥权限配置:[可选,未提供时不要假定存在]

请先确认材料是否足够,只处理我提供的范围。只审查测试方案;实际扣款、退款和账户配置需明确授权。税务注册和法律适用性不能由代码开关代替。交付可直接审阅的分析结论和证据,明确尚未执行或验证的部分。不要代入页面例子的虚构数据。
验收:
1. 成功页没有独立触发履约。
2. webhook 验签、payment_status 与去重行为可测试。
3. 开发和 CI 测试数据与真实账户环境隔离。

验收方法

成功页没有独立触发履约。

webhook 验签、payment_status 与去重行为可测试。

开发和 CI 测试数据与真实账户环境隔离。

依赖与准备

需要完整 Skill 目录,保留 references/payments.md、references/connect.md、references/billing.md、references/tax.md 等引用。需要 Stripe SDK/CLI、测试账号和 webhook 端点;按入口当前官方 payments/security 等参考核实版本。优先受限 API key,不输出完整密钥。

使用边界

只审查测试方案;实际扣款、退款和账户配置需明确授权。税务注册和法律适用性不能由代码开关代替。

需要测试环境和相应账户权限;支付、税务及资金操作必须在明确边界内执行。

页面中的例子为编辑撰写,未运行上游 Skill;不代表平台兼容认证或生产实测。

排错

页面显示成功但未到账:核对真实付款状态和 webhook 事件,不补造成功记录。

重复事件多次发货:增加订单状态及事件幂等检查,用测试事件验证重复处理。

固定来源

https://github.com/stripe/ai/blob/a188b0d644166d57b93dc6fb338a0e2e8c37b5fc/skills/stripe-best-practices/SKILL.md

许可

MIT。许可原文:https://github.com/stripe/ai/blob/a188b0d644166d57b93dc6fb338a0e2e8c37b5fc/LICENSE

仓库热度

stripe/ai 仓库 1,848 Stars(2026-09-30 核验);这是父仓库指标,不是单个 Skill 的评分。