diff --git a/CHANGELOG.md b/CHANGELOG.md index cbc4bfb5311..22ef9aac1e0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,8 @@ * Fixes #2463 on Android API level 26 and above * [#2483](https://github.com/stripe/stripe-android/pull/2483) Fix formatting of `maxTimeout` value in `Stripe3ds2AuthParams` * [#2494](https://github.com/stripe/stripe-android/pull/2494) Support starting 3DS2 challenge flow from a Fragment +* [#2496](https://github.com/stripe/stripe-android/pull/2496) Deprecate `StripeIntent.stripeSdkData` +* [#2497](https://github.com/stripe/stripe-android/pull/2497) Deprecate `StripeIntent.redirectData` * [#2513](https://github.com/stripe/stripe-android/pull/2513) Add `canDeletePaymentMethods` to `PaymentSessionConfig` * `canDeletePaymentMethods` controls whether the user can delete a payment method by swiping on it in `PaymentMethodsActivity` diff --git a/MIGRATING.md b/MIGRATING.md index cfde405d542..facd8f11fa6 100644 --- a/MIGRATING.md +++ b/MIGRATING.md @@ -1,5 +1,40 @@ # Migration Guide +## Migrating from versions < 14.5.0 +- Changes to `StripeIntent` + - `redirectData` is now deprecated. + + If a `PaymentIntent` or `SetupIntent` requires a redirect to authenticate, this information will be in `nextActionData`. + However, as before, this action will be handled by the SDK in `Stripe.confirmPayment`/`Stripe.confirmSetupIntent`. + + ```kotlin + // before + if (intent.redirectData != null) { + // requires redirect + } + + // after + when (intent.nextActionData) { + is StripeIntent.RedirectData.RedirectToUrl -> // requires redirect + } + ``` + - `stripeSdkData` is now deprecated. + + If a `PaymentIntent` or `SetupIntent` requires 3DS1 or 3DS2 authentication, this information will be in `nextActionData`. + However, as before, this action will be handled by the SDK in `Stripe.confirmPayment`/`Stripe.confirmSetupIntent`. + + ```kotlin + // before + if (intent.stripeSdkData != null) { + // requires 3D Secure auth + } + + // after + when (intent.nextActionData) { + is StripeIntent.RedirectData.SdkData -> // requires 3D Secure auth + } + ``` + ## Migrating from versions < 14.0.0 - Changes to Stripe Error localization - All [Stripe Error messages](https://stripe.com/docs/api/errors#errors-message) are now localized