具有 Checkout Sessions API 更改日志的 Element公开预览

通过 Checkout Sessions API 集成应用跟踪对 Element 的更改。

具有 Checkout Sessions API 的 Elements 使用两种 Beta 测试版本：

Stripe.js Beta 头（例如，custom_checkout_beta_5），在前端集成上设置。
API 版本 Beta 头（例如，custom_checkout_beta=v1），在后端集成上设置。

前端测试版

初始化 Stripe.js时指定前端 Beta 版本。

custom_checkout_beta_5

Breaking initCustomCheckout 函数已被重命名为 initCheckout
- 在 React Stripe.js 中，CustomCheckoutProvider 被已重命名为 CheckoutProvider，useCustomCheckout 并被已重命名为 useCheckout。
Breaking 要确认 Express Checkout Element，调用 confirm，并将 confirm 事件作为 expressCheckoutConfirmEvent 传入。
- 以前，Express Checkout Element 通过调用 event.confirm() 来确认。
Breaking 调用 confirm 时，Payment Element 和 Address Element 将验证表单输入并呈现任何错误。
Breaking 错误消息已进行标准化和改进。
- 函数解决的返回错误/表示已知情况，例如无效的付款详情或资金不足。这些是可预测的问题，可以通过在结账页面上显示 message 来传达给您的客户。
- 被函数拒绝的错误/表示集成本身的错误，例如无效的参数或配置。不应向客户显示这些错误。
Breaking 异步方法（如 confirm 或 applyPromotionCode）使用不同的架构进行解析：
- 添加了 type="success"|"error"鉴别器字段。
- 如果成功，更新的会话状态将填充在 success 密钥下。以前是在 session 密钥下。
- 否则，错误将继续填充在 error 密钥下。
向 confirm 添加了 email、phoneNumber、billingAddress 和 shippingAddress 选项。
Breaking Address Element 不再自动更新 Session 上的 billingAddress 或 shippingAddress 字段。
- 只要挂载了 Address Element，调用 confirm 时都会自动使用表单值。
- 在确认之前，侦听 change 事件以使用 Address Element 值。

custom_checkout_beta_4

向 Session 对象添加的 images。
在创建 Payment Element 时添加的 fields 选项。
在创建 Express Checkout Element 时添加的 paymentMethods 选项。
Breaking 现在，将无效选项传递到 createElement 会引发错误。以前，无法识别的选项将被静默忽略。
Breaking updateEmail 和 updatePhoneNumber 异步应用更改。在客户完成输入完整的值之前调用这些方法可能会导致性能不佳。
- 不要在每个输入的更改事件上调用 updateEmail 或 updatePhoneNumber，而应等到客户完成输入时，例如在模糊输入时或提交表单进行付款时。
- updateEmail 现在验证输入的信息是否为格式正确的电子邮件地址，如果使用了无效的输入，则返回错误。
- updatePhoneNumber 仍然不对输入字符串执行任何验证。

custom_checkout_beta_3

以下字段已添加到 Session 对象：
现可复用保存的银行卡。了解如何保存和复用支付方式。
Breaking Payment Element 的默认 layout 已更改为 accordion。
- 要继续使用以前的默认布局，必须显式指定 layout='tabs'。
Breaking confirm 的默认行为已更改为在成功确认后始终重定向到您 return_url。
- 以前，仅当客户选择基于重定向的支付方式时才会重定向 confirm。要继续使用原行为，必须将 redirect=‘if_required’ 传递到 confirm。

custom_checkout_beta_2

BreakinglineItem.recurring.interval_count 字段已被删除并替换为 lineItem.recurring.intervalCount。
BreakinglineItem.amount 字段已被删除并替换为以下内容：

custom_checkout_beta_1

这是最初的前端测试版。

后端更改日志

在设置服务器库时指定后端 Beta 测试版本。

后端 Beta 测试版没有变化。