首页
/ Stripe Node.js SDK v17.8.0-beta.1 版本解析

Stripe Node.js SDK v17.8.0-beta.1 版本解析

2025-06-14 14:52:02作者:申梦珏Efrain

Stripe Node.js SDK 是 Stripe 官方提供的 JavaScript 库,用于在 Node.js 环境中与 Stripe API 进行交互。它为开发者提供了便捷的方式来处理支付、订阅、发票等电商核心功能。本次发布的 v17.8.0-beta.1 版本带来了一些重要的功能更新和接口调整。

终端读卡器测试辅助方法

新版本为 Terminal.Reader 资源增加了两个实用的测试辅助方法:

  1. succeed_input_collection - 模拟读卡器成功收集输入的场景
  2. timeout_input_collection - 模拟读卡器输入收集超时的场景

这些方法极大地方便了开发者对终端支付流程的测试,特别是在处理各种边界条件和异常情况时。在实际开发中,我们可以利用这些方法来构建更全面的测试用例,确保应用能够正确处理读卡器的各种响应状态。

账户风险控制接口变更

Account.risk_controls.rejected_reason 字段的类型从单纯的枚举类型扩展为枚举或 null 类型。这一变更反映了实际业务场景中,风险控制拒绝原因可能为空的情况。开发者需要注意在代码中处理这个字段可能为 null 的情况,避免出现类型错误。

结账会话接口调整

本次更新对 Checkout.Session 接口做了两处重要调整:

  1. collected_information.shipping_details 变为必填字段
  2. collected_information 本身也变为必填字段

这些变更意味着开发者在使用结账会话功能时,必须确保收集了完整的配送信息。对于现有系统,需要检查相关代码是否已经正确处理这些必填字段,必要时需要更新数据收集流程。

订单支付目标日期支持

新版本为 ACSS 借记和 SEPA 借记支付方式增加了目标日期(target_date)支持,涉及以下多个接口:

  • Order.payment.settings.payment_method_options.acss_debit
  • Order.payment.settings.payment_method_options.sepa_debit
  • OrderCreateParams.payment.settings.payment_method_options.acss_debit
  • OrderCreateParams.payment.settings.payment_method_options.sepa_debit
  • OrderUpdateParams.payment.settings.payment_method_options.acss_debit
  • OrderUpdateParams.payment.settings.payment_method_options.sepa_debit

这个功能特别适用于需要指定特定结算日期的业务场景,比如定期付款或延迟结算等。开发者现在可以更灵活地控制资金的实际转移时间。

升级建议

作为 beta 版本,v17.8.0-beta.1 适合在测试环境中进行评估。建议开发者:

  1. 在测试环境中充分验证新功能和接口变更
  2. 特别注意必填字段的变化,确保现有流程不受影响
  3. 为可能为 null 的字段添加适当的空值处理
  4. 评估目标日期功能是否符合业务需求

这些变更虽然不大,但可能影响现有系统的正常运行,特别是那些依赖自动收集配送信息的结账流程。建议在升级前进行全面测试,确保平滑过渡。

登录后查看全文
热门项目推荐
相关项目推荐