调至内容部分
创建账户
或
登录
Stripe 文档徽标
/
询问人工智能
创建账户
登录
开始
付款
销售收入
平台和交易市场
资金管理
开发人员资源
概览查看所有产品快速开始
开始构建
开始开发
    设置开发环境
    发送您的第一个 API 请求
    构建并测试新功能
    上线前检查表
    发布阶段
关于 API
用 LLM 构建
在无代码的情况下使用 Stripe
设置 Stripe
创建账户
迁移到 Stripe
首页开始Start developing

上线前检查表

上线集成时请使用此检查清单。

注意

成为 Stripe 合作伙伴访问其他最佳实践并从 Stripe 接收相关的新闻和更新。

检查表进度

完成每项并勾选时,每个复选框的状态都会存储在浏览器的缓存中。您可以随时回到此页面,看看自己完成了哪一项。

您可以登录后看到下方您的一些当前设置。

Stripe 在设计其真实环境和沙盒环境时,其功能尽可能相似。在它们之间切换主要是交换您的 API 密钥。

如果您是开发人员(或曾让开发人员为您执行集成),在上线前也要考虑以下事项。如果您通过连接的网站或插件使用 Stripe,大部分内容可能不适用。

  • 警告

    除非您覆盖 API 版本,否则所有请求都将使用您的账户 API 设置。更改日志 会列出所有可用版本。默认情况下,Webhook 事件会根据您的账户 API 版本进行结构设置,除非您在创建端点 期间设置了 API 版本。

    如果您使用的是强类型语言(Go、Java、TypeScript、.NET),服务器端库会根据您使用的库版本固定 API 版本。如果您不熟悉 Stripe 的版本管理方式,请参阅版本控制。

    要确保一切同步:

    • 在管理平台内的 Workbench 中升级到最新的 API 版本
    • 对于动态语言(Node.js、PHP、Python、Ruby):在服务器端库中设置 API 版本
    • 对于强定型语言(Go、Java、TypeScript、.NET):将您选择的库升级到最新版本
  • 我们创建了多个测试值,您可以用来模拟各种状态和响应。除了这些选项之外,请进行尽职调查,使用以下内容测试您的集成:

    • 数据不完整
    • 数据无效
    • 重复数据(例如,重试同一请求以查看会发生什么情况)我们还建议让其他人测试您的集成,尤其是当该人本身不是开发人员时。
  • 不要等到上线后才发现代码未正确处理所有可能的错误类型,包括那些“本不应”发生的错误。确保代码具备防御性,不仅处理常见错误,还能应对所有可能的情况。

    在测试错误处理时,请密切注意向用户显示哪些信息。被拒绝的卡(即card_error)与后端错误(例如invalid_request_error)是不同的问题。

  • Stripe 会记录使用您的 API 密钥发出的每个请求,这些记录可以在管理平台 中查看。我们建议您在自己的系统中也记录所有重要数据,尽管这看似冗余。如果您的服务器无法联系 Stripe 或 API 密钥出现问题,您的日志可作为备份——这两种情况都可能导致我们无法记录您的请求。

    定期检查您的日志,确保仅存储所需信息,不包含敏感内容(例如信用卡详情或个人身份信息)。

  • Stripe 沙盒环境中创建的对象——如计划、优惠券、产品和 SKU——无法在真实模式中使用。这可防止测试数据意外用于生产代码。在真实模式中重新创建必要对象时,请确保使用相同的 ID 值(例如,相同的计划 ID,而不是相同的 name),以保证代码正常运行。

  • 您的 Stripe 账户可以同时拥有测试和真实的 Webhook 端点。如果您使用 Webhooks,请确保在 Stripe 账户中定义了实时端点。然后确认实时端点的功能与测试端点完全相同。

    在检查 Webhook 状态时,还需确保生产环境的端点:

    • 处理延迟的 Webhook 通知
    • 处理重复的 Webhook 通知
    • 不要求事件通知以特定顺序发生
  • 建议所有开发人员都订阅我们的 API 更新邮件列表,以便在我们发布新功能时可以及时了解。

  • 作为一项安全措施,建议定期轮换您的 API 密钥,并在上线前立即轮换。这样可防止它们在开发过程中被保存在代码库以外的位置。确保您的流程不会导致您的 API 密钥被表示或存储在多个地方(从而导致错误)或最终出现在您的版本控制软件中。

此页面的内容有帮助吗?
是否
  • 需要帮助?联系支持。
  • 加入我们的早期使用计划。
  • 查看我们的更改日志。
  • 有问题?联系销售。
  • LLM? Read llms.txt.
  • Powered by Markdoc