Stripe Ruby SDK v15.1.0-beta.2 版本深度解析

Stripe Ruby SDK 是 Stripe 官方提供的 Ruby 语言支付接口封装库，它让开发者能够轻松地在 Ruby 应用中集成 Stripe 的各种支付功能。本次发布的 v15.1.0-beta.2 版本是一个预发布版本，带来了多项重要的功能更新和优化。

核心更新内容

1. 新增外汇报价(FxQuote)功能

本次更新引入了全新的 FxQuote 资源，开发者现在可以通过 SDK 直接创建、列出和检索外汇报价。这对于处理跨境支付的场景尤为重要，可以帮助开发者更好地管理汇率风险。

相关方法包括：

• create - 创建新的外汇报价
• list - 列出所有外汇报价
• retrieve - 检索特定外汇报价

2. 支付意图(PaymentIntent)功能增强

支付意图是 Stripe 支付流程中的核心概念，本次更新对其进行了多项增强：

• 新增了 fx_quote 参数，允许开发者在外汇报价的基础上创建支付意图
• 扩展了 AmountDetail 对象，新增了 discount_amount、line_items、shipping 和 tax 等字段，使支付金额的构成更加透明
• 新增了 PaymentIntentAmountDetailsLineItem 资源，用于详细记录支付中的各个项目

3. 财务合规信息处理能力提升

针对全球化的财务合规需求，本次更新增强了相关功能：

• 在多个资源中新增了 financial_id 字段，包括 Charge、PaymentMethod 等
• 扩展了支持的财务注册国家选项，新增了阿塞拜疆(AZ)、孟加拉国(BD)等8个国家/地区

4. 优惠券功能改进

优惠券系统得到了增强，新增了：

• script 参数，允许开发者定义更复杂的优惠券逻辑
• type 字段，用于区分不同类型的优惠券

5. 支付方式配置更新

支付方式配置中新增了对巴西即时支付系统 PIX 的支持，这使得开发者能够更便捷地为巴西用户提供本地化的支付体验。

移除的功能

为了保持代码库的简洁性和维护性，本次更新移除了以下功能：

• 移除了 Invoice 资源中的 attach_payment_intent 方法
• 移除了尚未被 Stripe API 支持的请求签名认证器(RequestSigningAuthenticator)，同时移除了对 base64 的依赖

技术细节优化

除了功能性的更新外，本次发布还包含了一些技术细节的优化：

• 对 CheckoutSession 的 LineItem 进行了调整，使 quantity 参数变为可空
• 在多个资源中新增了 customer_reference 和 order_reference 字段，提高了支付信息的可追溯性
• 为美国金融监管机构数据新增了支持字段

开发者建议

对于考虑升级到该版本的开发者，需要注意以下几点：

1. 这是一个预发布版本，不建议直接在生产环境使用
2. 移除的 attach_payment_intent 方法需要检查是否有依赖此功能的代码
3. 新增的外汇报价功能为处理跨境支付提供了更好的工具，值得评估是否适合您的业务场景
4. 财务合规相关功能的增强有助于满足不同地区的要求

本次更新体现了 Stripe 对全球化支付场景的持续关注，特别是在外汇、财务合规等方面提供了更完善的支持。Ruby 开发者现在可以更便捷地构建符合各地法规的国际化支付解决方案。