stripe-react-native

Breaking changes

• #1248 Renamed the paymentSummaryItems field in initPaymentSheet()'s applePay params to cartItems. So your change will look like this:

 initPaymentSheet({
   ...
   applePay: {
-    paymentSummaryItems: [
+    cartItems: [
   }
  ...
 })

New Features

• Added the setOrderTracking property to the PlatformPayButton component and the initPaymentSheet method. Use this callback for setting the order details to give users the ability to track and manage their purchases in Wallet. To learn more about order tracking, see Apple’s Wallet Orders documentation. #1248
• Added the buttonType field to initPaymentSheet()'s applePay params. Use this to set the text displayed by the call to action button in the Apple Pay sheet.#1248
• Added the request field to initPaymentSheet()'s, confirmPlatformPayPayment()'s, and confirmPlatformPaySetupIntent's applePay params. Use this to support different types of payment requests, like RecurringPaymentRequest, AutomaticReloadPaymentRequest, and MultiMerchantRequest.#1248
• Added an options argument to presentPaymentSheet which includes a timeout property. #1287

Please see the changelog for additional details.

Fixes

• Fixes a build failure on Android when using stripe-android v20.19.2. #1289

Please see the changelog for additional details.

Fixes

• Fixed a bug on Android where canAddCardToWallet wouldn't correctly return the details.token object. #1282

Please see the changelog for additional details.

Fixes

• Fixed an issue with confirmPlatformPaySetupIntent on iOS. #1266
• Fixed types so that Klarna accepts the shippingDetails property. #1272
• Both PaymentIntent.Result and SetupIntent.Result types now include a paymentMethod field. This replaces the paymentMethodId field, which will be removed in a later release. #1272

Please see the changelog for additional details.

Breaking changes

• createPlatformPayPaymentMethod no longer returns a token object. #1236
  • If your integration depends on Stripe's Tokens API, please use createPlatformPayToken, which accepts identical arguments.

Fixes

• Fixed an issue with createPlatformPayPaymentMethod on iOS where a "Canceled" error could be returned in production. #1236
• Fixed an issue where the PlatformPayButton with type={PlatformPay.ButtonType.GooglePayMark} would be unclickable. #1236
• Fixed an issue on Android where CardField would render without the necessary padding. 48debb2
• Fixed an issue on iOS where providing a null value to certain method parameters would result in a crash. #1252

Please see the changelog for additional details.

Fixes

• Fixed the ShippingMethod type to contain the isPending field instead of a type field (which previously was never correct). This reflects the inputs accepted. #1227
• Fixed the ShippingMethod type to contain the startDate and endDate keys, if applicable. #1227
• Fixed instances of the "duplicate registered views" error. #1233
• Fixed extra margin that was being added to <CardForm /> on Android. #1234

Please see the changelog for additional details.

Breaking changes

New features

• Added the hasPairedAppleWatch option to canAddCardToWallet. #1219
• Added new functions and a new component to streamline integrating with Apple and Google Pay and add more feature support. See the Migrating to Platform Pay guide for more details. The old Apple and Google Pay APIs are marked as deprecated and will be removed in a future release, but are still supported in this version.

Fixes

• Fixed an issue where builds would error with the message 'const' enums are not supported. see commit
• Fixed an issue where the canAddCardToWallet method would sometimes wrongly return false with a details.status of MISSING_CONFIGURATION in production builds. #1215
• Fixed an issue on Android where, for certain countries, the postal code would not be enabled but would still be required. #1213
• Fixed an issue on iOS where canAddCardToWallet would return false if the card had already been provisioned on a paired device like an Apple Watch, but had not yet been provisioned on the current device, and would also return false if the card had been provisioned on the current device, but not on a paired Apple Watch. #1219

Please see the changelog for additional details.

Breaking changes

New features

• Added the <AddressSheet /> component, which enables you to collect local and international shipping or billing addresses from your customers with address autocomplete. #1169
• Added the defaultShippingDetails field to the params argument in initPaymentSheet(params). This will allow you to collect shipping details (either in your own UI or using the new <AddressSheet /> component) for payments in the Payment Sheet. #1169

Fixes

• Fixed a build error on Android when using Kotlin version 1.7.10. #1195

Please see the changelog for additional details.

Breaking changes

• This library now supports iOS 13 and up, due to stripe-ios increasing the deployment target. If you would like to build for iOS 12, please continue to use @stripe/[email protected]. #1190

New features

• Added Link support in Payment Sheet. #1176
• Added the resetPaymentSheetCustomer method to clear persisted authentication state in the PaymentSheet. #1176
• Added preferredNetwork and availableNetworks fields to the CardResult payment method. #1176
• Added support for custom fonts to CardForm and CardView on Android. #1150
• Added support for customizing the call to action button label in Payment Sheet by providing the primaryButtonLabel property to initPaymentSheet(). #1190

Fixes

• Fixed an issue on iOS where confirmSetupIntent would throw an error if the Card payment method was provided with the paymentMethodId parameter. #1151
• Upgraded stripe-android to 20.15.+. #1176
• Upgraded stripe-ios to 23.1.+. #1190
• Fixed FinancialConnections.Subcategory and FinancialConnections.Permission types to be camel-case instead of snake case. #1176
• Fixed an issue with Financial Connections on iOS where the app wouldn't properly redirect back after authentication. #1178
• Fixed borderWidth and borderRadius for <CardField /> and CardForm /> was inconsistent across iOS and Android. #1182

Please see the changelog for additional details.

Breaking changes

• To comply with Google's new branding guidelines for the Google Pay button, the <GooglePayButton /> component's type prop now only accepts standard or pay (pay_shadow, pay_dark, standard_shadow, and standard_dark were all removed). It defaults to standard. #1135
• Your compileSdkVersion (in android/build.gradle) now must be at least 33. Changing your compileSdkVersion does not change runtime behavior.

New features

• Add returnURL as an optional parameter to handleNextAction. Use this so the Stripe SDK can redirect back to your app after authentication. #1104

Fixes

• Fixed an issue where the error resolved on iOS wasn't the root error. #1105
• Fix Expo Config Plugin support on SDK 46. #1111
• Updated stripe-ios from 22.7.+ to 22.8.+. Updated stripe-android from 20.9.+ to 20.12.+. This updates the Google Pay button to match the new brand guidelines. #1135

Please see the changelog for additional details.

Breaking changes

New features

Fixes

• Fixed an issue where some promises on Android would never resolve when using React Native 0.65.x or under. #1089.

Please see the changelog for additional details.

Breaking changes

• Your compileSdkVersion (in android/build.gradle) now must be at least 32. Changing your compileSdkVersion does not change runtime behavior.

New features

• confirmPayment can now be called with just a client secret (e.g. await confirmPayment("payment-intent-id")), in other words the payment method can be excluded. If the payment method is excluded, it is assumed by the SDK that you have attached the payment method on the server-side during payment intent creation. #1084
• Payment Sheet now supports Link on iOS. #1086.

Fixes

• Fixed a bug on Android where collectBankAccountForPayment, collectBankAccountForSetup, collectBankAccountToken, and collectFinancialConnectionsAccounts wouldn't work with Stripe Connect accounts. #1086.
• Upgraded stripe-ios to 22.7.+ and stripe-android to 20.9.+.

Please see the changelog for additional details.

Breaking changes

New features

• Added the collectBankAccountToken & collectFinancialConnectionsAccounts functions.

Fixes

• Fixed an issue where collectBankAccountForPayment and collectBankAccountForSetup would fail on Android when using React Native 0.65.x or under. #1059
• Fixed an issue where Android apps could crash with the error IllegalStateException: Cannot remove Fragment attached to a different FragmentManager. #1054
• Bumped Gradle from 4.2.2 to 7.1.1. #1058

Breaking changes

• The <GooglePayButton /> component no longer overrides the type to use the dark mode version when the device is in Dark Mode. If you set the type value, it will always be respected. If you don't set the type value, it will match the system's theme (standard_shadow when in Light Mode, and standard_dark when in Dark Mode). #1051

New features

• Added support for pay_dark and standard_dark to the <GooglePayButton /> component's type prop. This allows you to display the dark Google Pay button. #1051
• Added support for borderColor, borderRadius, and cursorColor to CardForm's cardStyle prop on iOS (already exists on Android). #1048

Fixes

• Reduced the size of the @stripe/stripe-react-native by preventing unnecessary files from being published. #1043

Please see the changelog for additional details.

Breaking changes

• #1020 Changed some of fields for the params object that is supplied to initPaymentSheet(params):
  • Changed the applePay field. Previously this field accepted a boolean, now it accepts an object of type ApplePayParams, which includes the merchantCountryCode field, and a new paymentSummaryItems field (see "New features" below).
  • Changed the googlePay field. Previously this field accepted a boolean, now it accepts an object of type GooglePayParams, which includes the merchantCountryCode, currencyCode, and testEnv fields.
  • Since the merchantCountryCode field now lives under the applePay and googlePay objects, it has been removed from the base params object.
  • Similarly, since the currencyCode and testEnv fields now live under the googlePay object, they have been removed from the base params object .
• #1020 In ApplePay.CartSummaryItem:
  • Renamed type to isPending- (if you had type: 'pending', replace it with isPending: true. if type: 'final', either remove it or set isPending: false).
    • The same change was made to ApplePay.ShippingMethod: renamed type to isPending.
  • Added a new paymentType field. This field is required, and in all pre-existing cases where you created a CartSummaryItem, should be set to paymentType: 'Immediate' (support for types Deferred and Recurring wasn't available until this release).

New features

• Added support for iOS 15 paymentSummaryItems: PKDeferredPaymentSummaryItem and PKRecurringPaymentSummaryItem.
• You can now specify Apple Pay line items to be displayed when paying with Apple Pay in PaymentSheet by providing applePay.paymentSummaryItems to the initPaymentSheet method. #1020
• Added support for Affirm (previously, Affirm was only available in the Payment Sheet). 1036

Fixes

• Fixed behavior of CardField and CardForm on Android to match that on iOS; postal code input no longer accepts characters that are never present in postal codes (anything besides 0-9, a-z, A-Z, hyphens, and whitespace). #1027.
• Fixed an issue on older version of React Native where calling collectBankAccountForSetup or collectBankAccountForPayment and getting a Canceled result could cause a crash. #1037
• Fixed an issue where some Android builds would fail on the lintVitalRelease step. #1038

Breaking changes

New features

• Added the canAddCardToWallet method. #986.

Fixes

• Fix build errors on Xcode 14 beta 1 by upgrading stripe-ios to ~>22.5.1. #1011
• Fixed an issue on Android where the brand field in CardField's onCardChange callback wouldn't be set unless the card details were fully complete. #1012
• Fixed an issue where Payment Sheet would cause crashes on Android if merchantDisplayName wasn't provided. #1015
• Fixed a bug on Android where a crash could occur if the PaymentSheet was canceled and opened again. #1014
• Fixed an instance on iOS where CardField's expiry date would remain marked as valid, even when it's invalid. #1018

Breaking changes

New features

Fixes

• Never show postal code input in CardField if postalCodeEnabled=false (regardless of countryCode). #996

Please see the changelog for additional details.

Breaking changes

New features

• Added a defaultValues prop to the CardForm component. Currently only accepts countryCode, and is Android-only. #974
• Added the countryCode prop to the CardField component. #989
• Added option to create a PII token (represents the details of personally identifiable information) to the createToken method. #976

Fixes

• Resolve with an Error (of type Canceled) if no payment option is selected in the Payment Sheet custom flow (i.e., the x button is clicked to close the Payment Sheet). #975
• Fixed an issue on Android where the complete field in the onCardChange callback would incorrectly be set to true even if the postal code wasn't filled out. #989
• Make SetupIntent.lastSetupError and PaymentIntent.lastPaymentError object shape consistent on iOS and Android.#990

Please see the changelog for additional details.

Breaking changes

• Renamed appearance.shapes.shadow.borderRadius to appearance.shapes.shadow.blurRadius, and appearance.primaryButton.shapes.shadow.borderRadius to appearance.primaryButton.shapes.shadow.blurRadius. #962

New features

Fixes

• Fixed cases where Android apps would crash with the error: Unable to instantiate fragment com.reactnativestripesdk.PaymentLauncherFragment. #965
• Fixed appearance.shapes.shadow.offset and appearance.primaryButton.shapes.shadow.offset not applying the y-coordinate in the correct direction. #962
• Fixed a bug where handleNextAction wouldn't resolve on Android when using 3DS2. #966
• Fixed a bug where the wrong CVC icon was show in the CardForm component on Android. #966
• The card brand tint color is now correctly set in the CardField component on Android via the cardStyle.textColor prop. #851

Please see the changelog for additional details.

Breaking changes

• Removed support for primaryButtonColor field on initPaymentSheet(). Please use the new appearance.primaryButton.colors.background field instead. #940

New features

• You can now customize the appearance of your Payment Sheet via the appearance field on initPaymentSheet(). #940
• Added Affirm and AU BECS Direct Debit support to Payment Sheet. #940

Fixes

• Improved error messages on Android for failed confirmPayment and confirmSetupIntent calls, and any Google Pay related methods. #957
• Made Android card validation state consistent with iOS in the CardField onCardChange callback. #958

Please see the changelog for additional details.