Stripe Java SDK v28.3.0 版本更新解析

Stripe Java SDK 是 Stripe 支付平台官方提供的 Java 语言开发工具包，它为开发者提供了与 Stripe API 交互的便捷方式。通过这个 SDK，Java 开发者可以轻松集成支付处理、订阅管理、发票开具等电子商务功能到他们的应用中。

核心功能更新

财务账户增强功能

本次更新为 Treasury 财务账户功能带来了多项重要改进：

1. 财务账户关闭功能：新增了 close 方法，允许开发者通过编程方式关闭财务账户，完善了财务账户的生命周期管理。

2. 财务账户昵称支持：现在可以为财务账户设置昵称（nickname），便于用户识别和管理多个账户。

3. 默认账户标识：新增了 is_default 字段，用于标记默认财务账户，简化了账户选择逻辑。

4. 转发设置：在更新财务账户时，现在可以配置 forwarding_settings，为资金流转提供更多控制选项。

支付方式扩展

v28.3.0 版本引入了全新的"银行支付"（Pay by Bank）支付方式：

1. 全平台支持：从账户能力配置到支付意图创建，全面支持银行支付方式。

2. 支付方法配置：支持在支付方法配置中启用银行支付，为不同支付场景提供灵活选择。

3. 多场景集成：无论是常规支付、支付链接还是结账会话，现在都可以使用银行支付方式。

支付流程优化

1. 建议代码：在支付结果、错误处理等场景中新增了 advice_code 字段，为开发者提供更详细的支付状态信息，便于问题诊断和流程优化。

2. PayPal 国家信息：现在可以获取 PayPal 支付方式的国家信息，有助于国际化支付场景的处理。

3. 折扣支持：在结账会话中新增了对折扣的支持，丰富了促销活动的实现方式。

账户管理改进

1. 公司信息增强：新增了董事声明（directorship_declaration）和所有权豁免原因（ownership_exemption_reason）字段，满足更复杂的合规需求。

2. 终极受益人证明：支持上传终极受益人所有权证明文件，完善了 KYC 流程。

3. 账户会话组件：财务账户交易、发卡等组件现在可以集成到账户会话中，提供了更完整的账户管理体验。

开发者体验提升

1. 枚举类型扩展：多个枚举类型新增了银行支付等选项，使 API 更加完备。

2. 类型系统增强：改进了类型定义，如将财务账户作为转账目的地支付方法的一种类型，使类型系统更加准确。

3. 新国家支持：支付链接和结账会话现在支持苏丹（SD）作为可选的配送国家。

技术细节

1. API 版本更新：支持最新的 2025-01-27.acacia API 版本，确保开发者可以使用最新的 Stripe 功能。

2. 小费配置：终端配置现在支持日元（JPY）作为小费货币，完善了日本市场的支付体验。

3. 电话号码收集：支付链接更新参数中新增了电话号码收集选项，便于商家获取客户联系信息。

总结

Stripe Java SDK v28.3.0 版本带来了多项重要更新，特别是在财务账户管理和新型支付方式支持方面。这些改进不仅扩展了 SDK 的功能边界，也为开发者提供了更丰富的工具来构建复杂的支付和财务管理系统。银行支付方式的引入尤其值得关注，它为特定市场提供了更符合当地习惯的支付选择。同时，各种细节改进和类型系统增强也显著提升了开发体验和代码质量。