Stripe Node.js SDK v17.6.0-beta.2 版本解析

Stripe Node.js SDK 是 Stripe 官方提供的 JavaScript 库，用于在后端 Node.js 环境中与 Stripe API 进行交互。它为开发者提供了便捷的方式来处理支付、订阅、发票等金融业务逻辑，是构建现代支付系统的关键工具。

核心更新内容

1. 新增 Pay by Bank 支付方式支持

本次更新最重要的特性是增加了对"Pay by Bank"支付方式的全方位支持。这是一种银行直接支付方式，允许客户直接从他们的银行账户进行支付，而无需使用信用卡或借记卡。

开发者现在可以在以下场景中使用 Pay by Bank：

• 账户能力配置（Account Capabilities）
• 支付意图（PaymentIntent）
• 设置意图（SetupIntent）
• 支付方法（PaymentMethod）
• 结账会话（Checkout Session）
• 支付链接（Payment Link）

2. 企业账户验证增强

针对企业账户的验证流程进行了增强，新增了以下功能：

• 公司董事声明（directorship_declaration）字段
• 最终受益人所有权证明（proof_of_ultimate_beneficial_ownership）文档支持

这些更新使得企业账户的合规性验证更加完善，符合金融监管要求。

3. 账户会话组件扩展

账户会话（AccountSession）组件新增了多个金融相关功能：

• 金融账户交易（financial_account_transactions）
• 金融账户（financial_account）
• 发卡（issuing_card 和 issuing_cards_list）

这些扩展为开发者提供了更全面的账户管理能力。

4. 订阅取消行为选项

在计费门户（Billing Portal）配置中，新增了订阅取消时的"always_invoice"选项，用于控制订阅取消时的费用计算行为。

5. 终端设备小费配置

终端设备（Terminal）配置中新增了对日元（JPY）的小费支持，扩展了国际化支付场景。

技术实现细节

Pay by Bank 集成

要在应用中集成 Pay by Bank，开发者可以按照以下模式使用：

const paymentIntent = await stripe.paymentIntents.create({
  amount: 1000,
  currency: 'eur',
  payment_method_types: ['pay_by_bank'],
  payment_method_options: {
    pay_by_bank: {
      // 特定配置
    }
  }
});

企业验证文档上传

对于企业账户验证，现在可以上传额外的合规文档：

const account = await stripe.accounts.update('acct_123', {
  company: {
    directorship_declaration: {
      date: 1625097600,
      ip: '8.8.8.8'
    }
  },
  documents: {
    proof_of_ultimate_beneficial_ownership: {
      files: ['file_123']
    }
  }
});

升级建议

作为 beta 版本，v17.6.0-beta.2 适合在测试环境中进行评估。主要升级考虑点包括：

1. 如果计划使用 Pay by Bank 功能，需要确保前端和后端都支持这种支付方式
2. 企业账户验证流程可能需要调整以适应新的合规要求
3. 注意 API 版本兼容性，特别是 Webhook 端点使用的 API 版本

总结

Stripe Node.js SDK v17.6.0-beta.2 带来了重要的新功能和改进，特别是 Pay by Bank 支付方式的全面支持，为开发者提供了更多支付选项。同时，企业账户验证的增强也提升了合规性能力。建议开发者评估这些新功能是否满足业务需求，并在测试环境中进行充分验证。