ベータの変更ログ公開プレビュー

Custom Checkout への変更を追跡します。

Elements with Checkout Sessions API uses two kinds of beta versions:

A Stripe.js beta header (e.g., custom_checkout_beta_5), which is set on your front-end integration.
バックエンドのシステムに設定される、API バージョンのベータヘッダー (例: custom_checkout_beta=v1)。

フロントエンドのベータバージョン

Specify the front-end beta version when initializing Stripe.js.

custom_checkout_beta_5

対応が必要 The initCustomCheckout function has been renamed to initCheckout
- Within React Stripe.js, CustomCheckoutProvider has been renamed to CheckoutProvider and useCustomCheckout has been renamed to useCheckout.
対応が必要 To confirm the Express Checkout Element, call confirm, passing the confirm event as expressCheckoutConfirmEvent
- Previously, Express Checkout Element was confirmed by calling event.confirm().
対応が必要 When confirm is called, Payment Element and Address Element will validate form inputs and render any errors.
対応が必要 Error messages have been standardized and improved.
- Errors returned/resolved by a function represent known scenarios like invalid payment details or insufficient funds. These are predictable issues that can be communicated to your customer by displaying the message on the checkout page.
- Errors thrown/rejected by a function represent errors in the integration itself, such as invalid parameters or configuration. These errors are not meant to be displayed to your customers.
対応が必要 Asynchronous methods, such as confirm or applyPromotionCode, resolve with a different schema:
- A type="success"|"error" discriminator field has been added.
- If successful, the updated session state is populated under the success key. Previously, this was under the session key.
- Otherwise, the error continues to be populated under the error key.
Added the email, phoneNumber, billingAddress, and shippingAddress options to confirm.
対応が必要 Address Element no longer automatically updates the billingAddress or shippingAddress fields on the Session.
- So long as Address Element is mounted, form values will automatically be used when calling confirm.
- Listen to the change event to use the Address Element value before confirmation.

custom_checkout_beta_4

Session オブジェクトに images を追加しました。
Payment Element の作成時のオプションとして fields を追加しました。
Express Checkout Element の作成時のオプションとして paymentMethods を追加しました。
対応が必要 createElement に無効なオプションを渡すと、エラーが発生するようになりました。これまでは、認識されていないオプションは通知なく無視されていました。
対応が必要 updateEmail および updatePhoneNumber は変更を非同期で適用します。顧客が値の入力を終了する前にこれらのメソッドを呼び出すと、パフォーマンスが低下することがあります。
- 各入力の変更イベントで updateEmail または updatePhoneNumber を呼び出すのではなく、フォーカスが外れたときや支払いのために顧客がフォームを送信したときなど、顧客が入力を完了するまで待ちます。
- updateEmail は、入力が適切な形式のメールアドレスであることを検証し、無効な入力が使用された場合にはエラーを返すようになりました。
- updatePhoneNumber では、まだ入力文字列に対する検証は行われません。

custom_checkout_beta_3

以下のフィールドが Session オブジェクトに追加されました。
Saved cards can now be reused. Learn how to save and reuse payment methods.
Breaking Payment Element のデフォルトのレイアウトは accordion に変更されました。
- 以前のデフォルトのレイアウトを引き続き使用するには、layout='tabs' を明示的に指定する必要があります。
Breaking 確定のデフォルトの動作は、確定の成功後に常に return_url にリダイレクトするように変更されました。
- これまでは、顧客がリダイレクトベースの支払い方法を選択した場合にのみ、confirm がリダイレクトされました。古い動作を引き続き使用するには、confirm に redirect=‘if_required’ を渡す必要があります。

custom_checkout_beta_2

Breaking lineItem.recurring.interval_count フィールドは削除され lineItem.recurring.intervalCount に置き換えられました。
Breaking lineItem.amount フィールドは削除され、以下に置き換えられました。

custom_checkout_beta_1

「これは、最初のフロントエンドのベータバージョンです。」

バックエンドの変更ログ

Specify the back-end beta version when setting up your server library.

「バックエンドのベータ版に対する変更はありません。」