From afe52ac4021fa25527a232bbda35eab4b84fe0be Mon Sep 17 00:00:00 2001 From: Crystal Chang Date: Tue, 11 Aug 2026 17:14:57 -0400 Subject: [PATCH 1/2] add deprecation tag --- types/stripe-js/embedded-checkout.d.ts | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/types/stripe-js/embedded-checkout.d.ts b/types/stripe-js/embedded-checkout.d.ts index 60713bd9..4c0cafe8 100644 --- a/types/stripe-js/embedded-checkout.d.ts +++ b/types/stripe-js/embedded-checkout.d.ts @@ -162,6 +162,10 @@ export interface StripeEmbeddedCheckoutOptions { */ onComplete?: () => void; /** + * @deprecated `onShippingDetailsChange` is deprecated for Embedded Checkout. + * For dynamic shipping logic, use the Checkout Form SDK with + * `stripe.initCheckoutFormSdk()` instead. + * * onShippingDetailsChange is called when the customer completes the shipping details form. * * The callback is required when [permissions.update.shipping_details](https://docs.stripe.com/api/checkout/sessions/create#create_checkout_session-permissions-update-shipping_details) is set to `server_only`. From 2bdc0a6357531d5ed932cea85ae287bdc9bba70b Mon Sep 17 00:00:00 2001 From: Crystal Chang Date: Wed, 12 Aug 2026 12:39:48 -0400 Subject: [PATCH 2/2] update comment --- types/stripe-js/embedded-checkout.d.ts | 9 +-------- 1 file changed, 1 insertion(+), 8 deletions(-) diff --git a/types/stripe-js/embedded-checkout.d.ts b/types/stripe-js/embedded-checkout.d.ts index 4c0cafe8..5e4d159b 100644 --- a/types/stripe-js/embedded-checkout.d.ts +++ b/types/stripe-js/embedded-checkout.d.ts @@ -162,14 +162,7 @@ export interface StripeEmbeddedCheckoutOptions { */ onComplete?: () => void; /** - * @deprecated `onShippingDetailsChange` is deprecated for Embedded Checkout. - * For dynamic shipping logic, use the Checkout Form SDK with - * `stripe.initCheckoutFormSdk()` instead. - * - * onShippingDetailsChange is called when the customer completes the shipping details form. - * - * The callback is required when [permissions.update.shipping_details](https://docs.stripe.com/api/checkout/sessions/create#create_checkout_session-permissions-update-shipping_details) is set to `server_only`. - * For a step-by-step guide on using this callback to customize shipping options during checkout, see [Customize Shipping Options](https://docs.stripe.com/payments/checkout/custom-shipping-options). + * @deprecated Dynamic shipping updates are deprecated in Embedded Checkout. */ onShippingDetailsChange?: ( event: StripeEmbeddedCheckoutShippingDetailsChangeEvent