Deprecate rememberPaymentSheet and rememberPaymentSheetFlowController

Author: cttsai-stripe

MIGRATING.md

@@ -2,9 +2,13 @@
 
 ## Migrating from versions < 21.15.0
 - Changes to `PaymentSheet`:
-  * The constructors have been deprecated and will be removed in a future release. Use the `Builder()` or the `rememberPaymentSheet()` method instead.
+  * The constructors have been deprecated and will be removed in a future release. Use the `PaymentSheet.Builder` method instead.
 - Changes to `PaymentSheet.FlowController`:
-  * `FlowController.create()` has been deprecated and will be removed in a future release. Use the `Builder()` or the `rememberPaymentSheetFlowController()` method instead.
+  * `FlowController.create()` has been deprecated and will be removed in a future release. Use the `FlowController.Builder` method instead.
+- Changes to `PaymentSheetCompose`:
+  * `rememberPaymentSheet` has been deprecated and will be removed in a future release. Use `PaymentSheet.Builder` instead.
+- Changes to `FlowControllerCompose`:
+  * `rememberPaymentSheetFlowController` has been deprecated and will be removed in a future release. Use the `FlowController.Builder` instead.
 
 ## Migrating from versions < 21.0.0
 - Basic Integration has been removed. [Please use Mobile Payment Element instead](https://docs.stripe.com/payments/mobile/migrating-to-mobile-payment-element-from-basic-integration).

paymentsheet/src/main/java/com/stripe/android/paymentsheet/FlowControllerCompose.kt

@@ -21,6 +21,7 @@ import java.util.UUID
  * @param paymentResultCallback Called when a [PaymentSheetResult] is available.
  */
 @Composable
+@Deprecated(message = "This will be removed in a future release. Use FlowController.Builder instead.")
 fun rememberPaymentSheetFlowController(
     paymentOptionCallback: PaymentOptionCallback,
     paymentResultCallback: PaymentSheetResultCallback,
@@ -49,6 +50,7 @@ fun rememberPaymentSheetFlowController(
  * @param paymentResultCallback Called when a [PaymentSheetResult] is available.
  */
 @Composable
+@Deprecated(message = "This will be removed in a future release. Use FlowController.Builder instead.")
 fun rememberPaymentSheetFlowController(
     createIntentCallback: CreateIntentCallback,
     paymentOptionCallback: PaymentOptionCallback,
@@ -82,6 +84,7 @@ fun rememberPaymentSheetFlowController(
  * @param paymentResultCallback Called when a [PaymentSheetResult] is available.
  */
 @Composable
+@Deprecated(message = "This will be removed in a future release. Use FlowController.Builder instead.")
 fun rememberPaymentSheetFlowController(
     createIntentCallback: CreateIntentCallback? = null,
     externalPaymentMethodConfirmHandler: ExternalPaymentMethodConfirmHandler,

paymentsheet/src/main/java/com/stripe/android/paymentsheet/PaymentSheetCompose.kt

@@ -22,6 +22,7 @@ import java.util.UUID
  * @param paymentResultCallback Called with the result of the payment after [PaymentSheet] is dismissed.
  */
 @Composable
+@Deprecated(message = "This will be removed in a future release. Use PaymentSheet.Builder instead.")
 fun rememberPaymentSheet(
     paymentResultCallback: PaymentSheetResultCallback,
 ): PaymentSheet {
@@ -47,6 +48,7 @@ fun rememberPaymentSheet(
  * @param paymentResultCallback Called with the result of the payment after [PaymentSheet] is dismissed.
  */
 @Composable
+@Deprecated(message = "This will be removed in a future release. Use PaymentSheet.Builder instead.")
 fun rememberPaymentSheet(
     createIntentCallback: CreateIntentCallback,
     paymentResultCallback: PaymentSheetResultCallback,
@@ -77,6 +79,7 @@ fun rememberPaymentSheet(
  * @param externalPaymentMethodConfirmHandler Called when a user confirms payment for an external payment method.
  */
 @Composable
+@Deprecated(message = "This will be removed in a future release. Use PaymentSheet.Builder instead.")
 fun rememberPaymentSheet(
     createIntentCallback: CreateIntentCallback? = null,
     externalPaymentMethodConfirmHandler: ExternalPaymentMethodConfirmHandler,