@stripe/stripe-react-native 0.57.3 → 0.59.0

package/ios/CustomerSheet/CustomerSheetUtils.swift

@@ -21,6 +21,7 @@ class CustomerSheetUtils {
         defaultBillingDetails: NSDictionary?,
         preferredNetworks: [Int]?,
         allowsRemovalOfLastSavedPaymentMethod: Bool?,
+        opensCardScannerAutomatically: Bool?,
         cardBrandAcceptance: PaymentSheet.CardBrandAcceptance
     ) -> CustomerSheet.Configuration {
         var config = CustomerSheet.Configuration()
@@ -59,6 +60,9 @@ class CustomerSheetUtils {
         if let allowsRemovalOfLastSavedPaymentMethod = allowsRemovalOfLastSavedPaymentMethod {
             config.allowsRemovalOfLastSavedPaymentMethod = allowsRemovalOfLastSavedPaymentMethod
         }
+        if let opensCardScannerAutomatically = opensCardScannerAutomatically {
+            config.opensCardScannerAutomatically = opensCardScannerAutomatically
+        }
         config.cardBrandAcceptance = cardBrandAcceptance
         return config
     }

package/ios/OldArch/StripeSdkEventEmitterCompat.h

@@ -24,5 +24,7 @@
 - (void)emitEmbeddedPaymentElementLoadingFailed:(NSDictionary *)value;
 - (void)emitOnCustomPaymentMethodConfirmHandlerCallback:(NSDictionary *)value;
 - (void)emitOnCheckoutClientSecretRequested:(NSDictionary *)value;
+- (void)emitPaymentMethodMessagingElementDidUpdateHeight:(NSDictionary *)value;
+- (void)emitPaymentMethodMessagingElementConfigureResult:(NSDictionary *)value;
 @end
 

package/ios/OldArch/StripeSdkEventEmitterCompat.m

@@ -24,7 +24,9 @@
     @"embeddedPaymentElementRowSelectionImmediateAction",
     @"embeddedPaymentElementLoadingFailed",
     @"onCustomPaymentMethodConfirmHandlerCallback",
-    @"onCheckoutClientSecretRequested"
+    @"onCheckoutClientSecretRequested",
+    @"paymentMethodMessagingElementDidUpdateHeight",
+    @"paymentMethodMessagingElementConfigureResult",
   ];
 }
 
@@ -128,4 +130,14 @@
   [self sendEventWithName:@"onCheckoutClientSecretRequested" body:value];
 }
 
+- (void)emitPaymentMethodMessagingElementDidUpdateHeight:(NSDictionary *)value
+{
+  [self sendEventWithName:@"paymentMethodMessagingElementDidUpdateHeight" body:value];
+}
+
+- (void)emitPaymentMethodMessagingElementConfigureResult:(NSDictionary *)value
+{
+  [self sendEventWithName:@"paymentMethodMessagingElementConfigureResult" body:value];
+}
+
 @end

package/ios/PaymentMethodMessagingElementConfig.swift

@@ -0,0 +1,116 @@
+//
+//  PaymentMethodMessagingElementConfig.swift
+//  stripe-react-native
+//
+//  Created by Tyler Clawson on 2/18/26.
+//
+
+@_spi(PaymentMethodMessagingElementPreview) @_spi(STP) import StripePaymentSheet
+
+internal class PaymentMethodMessagingElementConfig {
+    class func buildAppearanceFromParams(params: NSDictionary?) -> PaymentMethodMessagingElement.Appearance {
+        var appearance = PaymentMethodMessagingElement.Appearance()
+
+        guard let params = params else { return appearance }
+
+        // Parse theme/style
+        if let styleString = params["style"] as? String {
+            switch styleString {
+            case "dark":
+                appearance.style = .alwaysDark
+            case "flat":
+                appearance.style = .flat
+            case "light":
+                appearance.style = .alwaysLight
+            default:
+                appearance.style = .automatic
+            }
+        }
+
+        // Parse font
+        if let fontParams = params["font"] as? NSDictionary {
+            let scale = fontParams["scale"] as? CGFloat ?? 1
+            if let fontFamily = fontParams["family"] as? String,
+               let customFont = UIFont(name: fontFamily, size: UIFont.systemFontSize * scale) {
+                appearance.font = customFont
+            }
+        }
+
+        // Parse colors
+        if let textColorHex = parseThemedColor(params: params, key: "textColor") {
+            appearance.textColor = textColorHex
+        }
+
+        if let linkTextColorHex = parseThemedColor(params: params, key: "linkTextColor") {
+            appearance.infoIconColor = linkTextColorHex
+        }
+
+        return appearance
+    }
+
+    private class func parseThemedColor(params: NSDictionary, key: String) -> UIColor? {
+        // Check if it's a dictionary with light/dark keys
+        if let colorDict = params[key] as? [String: String] {
+            let lightHex = colorDict["light"]
+            let darkHex = colorDict["dark"]
+
+            if let light = lightHex, let dark = darkHex {
+                return UIColor { traitCollection in
+                    return traitCollection.userInterfaceStyle == .dark
+                        ? UIColor(hexString: dark)
+                        : UIColor(hexString: light)
+                }
+            }
+        }
+
+        // Check if it's a plain string
+        if let colorString = params[key] as? String {
+            return UIColor(hexString: colorString)
+        }
+
+        return nil
+    }
+
+    class func buildPaymentMethodMessagingElementConfiguration(
+        params: NSDictionary
+    ) -> (error: NSDictionary?, configuration: PaymentMethodMessagingElement.Configuration?) {
+
+        // Parse required parameters
+        guard let amount = params["amount"] as? Int else {
+            let error: NSDictionary = [
+                "code": "InvalidConfiguration",
+                "message": "amount is required",
+            ]
+            return (error, nil)
+        }
+
+        guard let currency = params["currency"] as? String else {
+            let error: NSDictionary = [
+                "code": "InvalidConfiguration",
+                "message": "currency is required",
+            ]
+            return (error, nil)
+        }
+
+        // Parse optional parameters
+        let locale = params["locale"] as? String
+        let country = params["country"] as? String
+
+        var paymentMethodTypes: [STPPaymentMethodType]?
+        if let paymentMethodTypesArray = params["paymentMethodTypes"] as? [String] {
+            paymentMethodTypes = paymentMethodTypesArray.map {
+                STPPaymentMethodType.fromIdentifier($0)
+            }
+        }
+
+        var configuration = PaymentMethodMessagingElement.Configuration(
+            amount: amount,
+            currency: currency,
+            locale: locale,
+            countryCode: country,
+            paymentMethodTypes: paymentMethodTypes,
+        )
+
+        return (nil, configuration)
+    }
+}

package/ios/PaymentMethodMessagingElementHandler.m

@@ -0,0 +1,9 @@
+#import <Foundation/Foundation.h>
+#import <React/RCTBridgeModule.h>
+#import <React/RCTViewManager.h>
+
+@interface RCT_EXTERN_MODULE(PaymentMethodMessagingElementView, RCTViewManager)
+RCT_EXPORT_VIEW_PROPERTY(appearance, NSDictionary)
+RCT_EXPORT_VIEW_PROPERTY(configuration, NSDictionary)
+RCT_EXPORT_VIEW_PROPERTY(onLoadComplete, RCTDirectEventBlock)
+@end

package/ios/PaymentMethodMessagingElementView.swift

@@ -0,0 +1,139 @@
+import Foundation
+@_spi(PaymentMethodMessagingElementPreview) @_spi(STP) import StripePaymentSheet
+import UIKit
+
+@objc(PaymentMethodMessagingElementView)
+class PaymentMethodMessagingElementView: RCTViewManager {
+
+    override static func requiresMainQueueSetup() -> Bool {
+        return true
+    }
+
+    override func view() -> UIView! {
+        return PaymentMethodMessagingElementContainerView(frame: .zero)
+    }
+}
+
+@objc(PaymentMethodMessagingElementContainerView)
+public class PaymentMethodMessagingElementContainerView: UIView, UIGestureRecognizerDelegate {
+    private var paymentMethodMessagingElementView: UIView?
+    private var messagingInstance: PaymentMethodMessagingElement?
+    private var appearanceConfig: PaymentMethodMessagingElement.Appearance?
+    private var lastConfig: NSDictionary?
+
+    @objc var appearance: NSDictionary? {
+        didSet {
+            if let appearance = appearance {
+                appearanceConfig = PaymentMethodMessagingElementConfig.buildAppearanceFromParams(params: appearance)
+                // Re-initialize if configuration already exists
+                if let config = lastConfig {
+                    initMessagingElement(config: config)
+                }
+            }
+        }
+    }
+
+    @objc var configuration: NSDictionary? {
+        didSet {
+            if let configuration = configuration {
+                lastConfig = configuration
+                initMessagingElement(config: configuration)
+            }
+        }
+    }
+
+    override init(frame: CGRect) {
+        super.init(frame: frame)
+        backgroundColor = .clear
+    }
+
+    required init?(coder: NSCoder) {
+        fatalError()
+    }
+
+    public override func didMoveToWindow() {
+        super.didMoveToWindow()
+        if window != nil {
+            // Only attach when we have a valid window
+            attachPaymentElementIfAvailable()
+        }
+    }
+
+    public override func willMove(toWindow newWindow: UIWindow?) {
+        super.willMove(toWindow: newWindow)
+        if newWindow == nil {
+            // Remove the view when moving away from window
+            removePaymentMethodMessagingElement()
+        }
+    }
+
+    private func attachPaymentElementIfAvailable() {
+        removePaymentMethodMessagingElement()
+        guard let messagingElement = messagingInstance else {
+            return
+        }
+
+        let messagingElementView = messagingElement.view
+        addSubview(messagingElementView)
+        messagingElementView.translatesAutoresizingMaskIntoConstraints = false
+
+        NSLayoutConstraint.activate([
+            messagingElementView.topAnchor.constraint(equalTo: topAnchor),
+            messagingElementView.leadingAnchor.constraint(equalTo: leadingAnchor),
+            messagingElementView.trailingAnchor.constraint(equalTo: trailingAnchor),
+            messagingElementView.bottomAnchor.constraint(equalTo: bottomAnchor),
+        ])
+
+        self.paymentMethodMessagingElementView = messagingElementView
+    }
+
+    private func removePaymentMethodMessagingElement() {
+        paymentMethodMessagingElementView?.removeFromSuperview()
+        paymentMethodMessagingElementView = nil
+    }
+
+    private func initMessagingElement(config: NSDictionary) {
+        let configResult = PaymentMethodMessagingElementConfig.buildPaymentMethodMessagingElementConfiguration(params: config)
+
+        if let error = configResult.error {
+            StripeSdkImpl.shared.emitter?.emitPaymentMethodMessagingElementConfigureResult([
+                "status": "failed",
+                "error": error,
+            ])
+            return
+        }
+
+        guard var configuration = configResult.configuration else {
+            return
+        }
+
+        // Add appearance if available
+        if let appearance = appearanceConfig {
+            configuration.appearance = appearance
+        }
+
+        var resultMap: [String: String] = [:]
+        var height: CGFloat? = 0
+
+        Task { @MainActor in
+            StripeSdkImpl.shared.emitter?.emitPaymentMethodMessagingElementConfigureResult(["status": "loading"])
+            switch await PaymentMethodMessagingElement.create(configuration: configuration) {
+            case .success(let paymentMethodMessagingElement):
+                self.messagingInstance = paymentMethodMessagingElement
+                height = self.messagingInstance?.view.systemLayoutSizeFitting(CGSize(width: paymentMethodMessagingElement.view.bounds.width, height: UIView.layoutFittingCompressedSize.height)).height
+                resultMap["status"] = "loaded"
+            case .noContent:
+                resultMap["status"] = "no_content"
+                self.messagingInstance = nil
+            case .failed(let error):
+                self.messagingInstance = nil
+                resultMap["status"] = "failed"
+                resultMap["message"] = error.localizedDescription
+            }
+
+            StripeSdkImpl.shared.emitter?.emitPaymentMethodMessagingElementDidUpdateHeight(["height": height ?? 0])
+            StripeSdkImpl.shared.emitter?.emitPaymentMethodMessagingElementConfigureResult(resultMap)
+            attachPaymentElementIfAvailable()
+        }
+    }
+}

package/ios/StripeSdk.mm

@@ -390,6 +390,40 @@ RCT_EXPORT_METHOD(openAuthenticatedWebView:(nonnull NSString *)id
   [StripeSdkImpl.shared openAuthenticatedWebView:id url:url resolver:resolve rejecter:reject];
 }
 
+RCT_EXPORT_METHOD(downloadAndShareFile:(nonnull NSString *)url
+                              filename:(nullable NSString *)filename
+                               resolve:(nonnull RCTPromiseResolveBlock)resolve
+                                reject:(nonnull RCTPromiseRejectBlock)reject)
+{
+  [StripeSdkImpl.shared downloadAndShareFile:url
+                                    filename:filename
+                                    resolver:resolve
+                                    rejecter:reject];
+}
+
+RCT_EXPORT_METHOD(authWebViewDeepLinkHandled:(nonnull NSString *)id
+                                     resolve:(nonnull RCTPromiseResolveBlock)resolve
+                                      reject:(nonnull RCTPromiseRejectBlock)reject)
+{
+  // No-op for iOS since it doesn't have this issue
+  resolve(@[]);
+}
+
+RCT_EXPORT_METHOD(storeStripeConnectDeepLink:(nonnull NSString *)url
+                                     resolve:(nonnull RCTPromiseResolveBlock)resolve
+                                      reject:(nonnull RCTPromiseRejectBlock)reject)
+{
+  // No-op for iOS - iOS doesn't need this mechanism
+  resolve([NSNull null]);
+}
+
+RCT_EXPORT_METHOD(pollAndClearPendingStripeConnectUrls:(nonnull RCTPromiseResolveBlock)resolve
+                                                reject:(nonnull RCTPromiseRejectBlock)reject)
+{
+  // No-op for iOS - iOS doesn't need this mechanism
+  resolve(@[]);
+}
+
 RCT_EXPORT_METHOD(verifyMicrodeposits:(BOOL)isPaymentIntent
                          clientSecret:(nonnull NSString *)clientSecret
                                params:(nonnull NSDictionary *)params
@@ -443,6 +477,12 @@ RCT_EXPORT_METHOD(customPaymentMethodResultCallback:(nonnull NSDictionary *)resu
   [StripeSdkImpl.shared customPaymentMethodResultCallback:result resolver:resolve rejecter:reject];
 }
 
+RCT_EXPORT_METHOD(createRadarSession:(nonnull RCTPromiseResolveBlock)resolve
+                              reject:(nonnull RCTPromiseRejectBlock)reject)
+{
+  [StripeSdkImpl.shared createRadarSession:resolve rejecter:reject];
+}
+
 /* clang-format on */
 
 #ifdef RCT_NEW_ARCH_ENABLED

package/ios/StripeSdkEmitter.swift

@@ -20,6 +20,8 @@ import Foundation
     func emitEmbeddedPaymentElementRowSelectionImmediateAction()
     func emitEmbeddedPaymentElementLoadingFailed(_ value: [String: Any])
     func emitOnCustomPaymentMethodConfirmHandlerCallback(_ value: [String: Any])
+    func emitPaymentMethodMessagingElementDidUpdateHeight(_ value: [String: Any])
+    func emitPaymentMethodMessagingElementConfigureResult(_ value: [String: Any])
 }
 
 @objc public protocol StripeOnrampSdkEmitter {

package/ios/StripeSdkImpl+CustomerSheet.swift

@@ -26,6 +26,7 @@ extension StripeSdkImpl {
                 defaultBillingDetails: params["defaultBillingDetails"] as? NSDictionary,
                 preferredNetworks: params["preferredNetworks"] as? [Int],
                 allowsRemovalOfLastSavedPaymentMethod: params["allowsRemovalOfLastSavedPaymentMethod"] as? Bool,
+                opensCardScannerAutomatically: params["opensCardScannerAutomatically"] as? Bool,
                 cardBrandAcceptance: StripeSdkImpl.computeCardBrandAcceptance(params: params)
             )
         } catch {

package/ios/StripeSdkImpl+Embedded.swift

@@ -6,7 +6,7 @@
 //
 
 import Foundation
-@_spi(EmbeddedPaymentElementPrivateBeta) @_spi(ExperimentalAllowsRemovalOfLastSavedPaymentMethodAPI) @_spi(CustomerSessionBetaAccess) @_spi(STP) @_spi(CustomPaymentMethodsBeta) import StripePaymentSheet
+@_spi(EmbeddedPaymentElementPrivateBeta) @_spi(ExperimentalAllowsRemovalOfLastSavedPaymentMethodAPI) @_spi(CustomerSessionBetaAccess) @_spi(STP) @_spi(CustomPaymentMethodsBeta) @_spi(CardFundingFilteringPrivatePreview) import StripePaymentSheet
 
 @objc(StripeSdkImpl)
 extension StripeSdkImpl {
@@ -310,7 +310,14 @@ extension StripeSdkImpl {
       configuration.paymentMethodOrder = paymentMethodOrder
     }
 
+    if let opensCardScannerAutomatically = params["opensCardScannerAutomatically"] as? Bool {
+      configuration.opensCardScannerAutomatically = opensCardScannerAutomatically
+    }
+
     configuration.cardBrandAcceptance = StripeSdkImpl.computeCardBrandAcceptance(params: params)
+    if let allowedCardFundingTypes = StripeSdkImpl.computeAllowedCardFundingTypes(params: params) {
+        configuration.allowedCardFundingTypes = allowedCardFundingTypes
+    }
 
     if let formSheetActionParams = params["formSheetAction"] as? NSDictionary,
        let actionType = formSheetActionParams["type"] as? String {

package/ios/StripeSdkImpl+PaymentSheet.swift

@@ -6,7 +6,7 @@
 //
 
 import Foundation
-@_spi(ExperimentalAllowsRemovalOfLastSavedPaymentMethodAPI) @_spi(CustomerSessionBetaAccess) @_spi(EmbeddedPaymentElementPrivateBeta) @_spi(STP) @_spi(PaymentMethodOptionsSetupFutureUsagePreview) @_spi(CustomPaymentMethodsBeta) @_spi(ConfirmationTokensPublicPreview) import StripePaymentSheet
+@_spi(ExperimentalAllowsRemovalOfLastSavedPaymentMethodAPI) @_spi(CustomerSessionBetaAccess) @_spi(EmbeddedPaymentElementPrivateBeta) @_spi(STP) @_spi(PaymentMethodOptionsSetupFutureUsagePreview) @_spi(CustomPaymentMethodsBeta) @_spi(ConfirmationTokensPublicPreview) @_spi(CardFundingFilteringPrivatePreview) import StripePaymentSheet
 
 extension StripeSdkImpl {
     internal func buildPaymentSheetConfiguration(
@@ -122,6 +122,10 @@ extension StripeSdkImpl {
             configuration.allowsRemovalOfLastSavedPaymentMethod = allowsRemovalOfLastSavedPaymentMethod
         }
 
+        if let opensCardScannerAutomatically = params["opensCardScannerAutomatically"] as? Bool {
+            configuration.opensCardScannerAutomatically = opensCardScannerAutomatically
+        }
+
         if let paymentMethodOrder = params["paymentMethodOrder"] as? [String] {
             configuration.paymentMethodOrder = paymentMethodOrder
         }
@@ -136,6 +140,9 @@ extension StripeSdkImpl {
         }
 
         configuration.cardBrandAcceptance = StripeSdkImpl.computeCardBrandAcceptance(params: params)
+        if let allowedCardFundingTypes = StripeSdkImpl.computeAllowedCardFundingTypes(params: params) {
+            configuration.allowedCardFundingTypes = allowedCardFundingTypes
+        }
 
         // Parse custom payment method configuration
         if let customPaymentMethodConfig = params["customPaymentMethodConfiguration"] as? [String: Any] {
@@ -145,6 +152,11 @@ extension StripeSdkImpl {
           )
         }
 
+        let userKeyTermsDisplay = StripeSdkImpl.computeTermsDisplayForUserKey()
+        if !userKeyTermsDisplay.isEmpty {
+            configuration.termsDisplay = userKeyTermsDisplay
+        }
+
         return (nil, configuration)
     }
 
@@ -286,6 +298,30 @@ extension StripeSdkImpl {
         }
     }
 
+    internal static func computeAllowedCardFundingTypes(params: NSDictionary) -> PaymentSheet.CardFundingType? {
+        guard let cardFundingFiltering = params["cardFundingFiltering"] as? NSDictionary,
+              let allowedTypes = cardFundingFiltering["allowedCardFundingTypes"] as? [String] else {
+            return nil
+        }
+
+        var result: PaymentSheet.CardFundingType = []
+        for type in allowedTypes {
+            switch type {
+            case "debit":
+                result.insert(.debit)
+            case "credit":
+                result.insert(.credit)
+            case "prepaid":
+                result.insert(.prepaid)
+            case "unknown":
+                result.insert(.unknown)
+            default:
+                break
+            }
+        }
+        return result.isEmpty ? nil : result
+    }
+
     static func mapCaptureMethod(_ captureMethod: String?) -> PaymentSheet.IntentConfiguration.CaptureMethod {
         if let captureMethod = captureMethod {
             switch captureMethod {
@@ -450,6 +486,13 @@ extension StripeSdkImpl {
         }
     }
 
+    internal static func computeTermsDisplayForUserKey() -> [STPPaymentMethodType: PaymentSheet.TermsDisplay] {
+        if STPAPIClient.shared.publishableKeyIsUserKey {
+            return [.card: .never]
+        }
+        return [:]
+    }
+
     internal static func mapToLinkDisplay(value: String?) -> PaymentSheet.LinkConfiguration.Display {
         switch value {
         case "automatic":