Mark IssuingCardPinService @deprecated & suggest alternative (#7723)

* added changelog entry * elaborated on changelog message
stripe · Dec 21, 2023 · 87c612b · 87c612b
1 parent 4b215ad
commit 87c612b
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 0 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -14,6 +14,8 @@
 ### Payments
 * [ADDED][7713](https://github.com/stripe/stripe-android/pull/7713) `CardInputWidget`, `CardMultilineWidget`, and `CardFormView` now support [card brand choice](https://stripe.com/docs/card-brand-choice) for eligible merchants. To provide a list of preferred networks, use `setPreferredNetworks()`.
 
+* [DEPRECATED][7723](https://github.com/stripe/stripe-android/pull/7723) `IssuingCardPinService` is deprecated and will be removed in a future release. [Please use Issuing Elements instead](https://stripe.com/docs/issuing/elements)
+
 ## 20.35.2 - 2023-12-11
 
 ### PaymentSheet

diff --git a/payments-core/src/main/java/com/stripe/android/IssuingCardPinService.kt b/payments-core/src/main/java/com/stripe/android/IssuingCardPinService.kt
@@ -19,6 +19,7 @@ import kotlin.coroutines.CoroutineContext
 /**
  * Methods for retrieval / update of a Stripe Issuing card
  */
+@Deprecated("Please use Issuing Elements instead: https://stripe.com/docs/issuing/elements")
 class IssuingCardPinService @VisibleForTesting internal constructor(
     keyProvider: EphemeralKeyProvider,
     private val stripeRepository: StripeRepository,
@@ -325,6 +326,7 @@ class IssuingCardPinService @VisibleForTesting internal constructor(
         )
     }
 
+    @Suppress("DEPRECATION")
     companion object {
         private val TAG = IssuingCardPinService::class.java.name
 
@@ -361,6 +363,7 @@ class IssuingCardPinService @VisibleForTesting internal constructor(
             stripeAccountId: String? = null,
             keyProvider: EphemeralKeyProvider
         ): IssuingCardPinService {
+            Log.w(TAG, "Please use Issuing Elements instead: https://stripe.com/docs/issuing/elements")
             return IssuingCardPinService(
                 keyProvider,
                 StripeApiRepository(