@stripe/stripe-react-native 0.65.1 → 0.67.0

package/ios/OnrampErrors.swift

@@ -0,0 +1,132 @@
+//
+//  OnrampErrors.swift
+//  stripe-react-native
+//
+//  Created by Michael Liberatore on 5/28/26.
+//
+
+#if canImport(StripeCryptoOnramp)
+import Foundation
+@_spi(CryptoOnrampAlpha) import StripeCryptoOnramp
+
+enum OnrampErrors {
+
+    /// Creates a React Native error envelope for a failed Crypto Onramp operation.
+    ///
+    /// Typed Crypto Onramp errors include onramp-specific diagnostics in addition to the standard error fields.
+    static func createFailedError(_ error: Swift.Error) -> NSDictionary {
+        return createOnrampError(code: ErrorType.Failed, error: error)
+    }
+
+    /// Creates a React Native error envelope for calls made before Crypto Onramp has been configured.
+    static func createNotConfiguredError() -> NSDictionary {
+        return createOnrampErrorMap(
+            code: ErrorType.Failed,
+            message: "Onramp is not configured."
+        )
+    }
+
+    private static func createOnrampError(code: String, error: Swift.Error) -> NSDictionary {
+        if let apiError = error as? StripeCryptoOnrampAPIError {
+            return createOnrampAPIErrorMap(
+                code: code,
+                onrampErrorType: onrampErrorType(for: apiError),
+                error: apiError
+            )
+        }
+
+        if let onrampError = error as? StripeCryptoOnrampError {
+            return createOnrampErrorMap(
+                code: code,
+                message: onrampError.userMessage,
+                localizedMessage: onrampError.localizedDescription,
+                stripeErrorCode: onrampError.code,
+                additionalFields: commonOnrampFields(error: onrampError)
+            )
+        }
+
+        return Errors.createError(code, error)
+    }
+
+    private static func createOnrampAPIErrorMap(
+        code: String,
+        onrampErrorType: String,
+        error: StripeCryptoOnrampAPIError
+    ) -> NSDictionary {
+        return createOnrampErrorMap(
+            code: code,
+            message: error.userMessage,
+            localizedMessage: error.localizedDescription,
+            type: error.type,
+            stripeErrorCode: error.code,
+            additionalFields: commonOnrampFields(error: error, onrampErrorType: onrampErrorType).merging([
+                "reason": error.reason,
+                "operation": error.operation,
+                "appPackageName": error.appIdentifier,
+                "mode": error.mode,
+                "sdkVersions": mapSDKVersions(error.sdkVersions),
+                "requestId": error.requestID,
+                "apiErrorCode": error.code,
+                "apiErrorType": error.type,
+                "apiErrorMessage": error.apiMessage,
+                "apiUserMessage": error.apiUserMessage,
+                "docUrl": error.docURL?.absoluteString,
+            ]) { _, new in new }
+        )
+    }
+
+    private static func commonOnrampFields(
+        error: StripeCryptoOnrampError,
+        onrampErrorType: String? = nil
+    ) -> [String: Any?] {
+        return [
+            "onrampErrorType": onrampErrorType,
+            "developerMessage": error.developerMessage,
+            "userMessage": error.userMessage,
+        ]
+    }
+
+    private static func mapSDKVersions(_ sdkVersions: [SDKVersion]) -> [[String: String]] {
+        return sdkVersions.map { sdkVersion in
+            [
+                "name": sdkVersion.name,
+                "version": sdkVersion.version,
+            ]
+        }
+    }
+
+    private static func onrampErrorType(for error: StripeCryptoOnrampAPIError) -> String {
+        switch error {
+        case is AppAttestationAPIError:
+            return "AppAttestationError"
+        default:
+            return "UncategorizedApiError"
+        }
+    }
+
+    private static func createOnrampErrorMap(
+        code: String,
+        message: String?,
+        localizedMessage: String? = nil,
+        declineCode: String? = nil,
+        type: String? = nil,
+        stripeErrorCode: String? = nil,
+        additionalFields: [String: Any?] = [:]
+    ) -> NSDictionary {
+        let fields: [String: Any?] = [
+            "code": code,
+            "message": message,
+            "localizedMessage": localizedMessage ?? message,
+            "declineCode": declineCode,
+            "stripeErrorCode": stripeErrorCode,
+            "type": type,
+        ].merging(additionalFields) { _, new in new }
+
+        return ["error": fields.mapValues(nullIfNil)]
+    }
+
+    private static func nullIfNil(_ value: Any?) -> Any {
+        return value ?? NSNull()
+    }
+}
+#endif

package/ios/PaymentOptionDisplayData+ReactNative.swift

@@ -6,7 +6,7 @@
 //
 
 import Foundation
-@_spi(EmbeddedPaymentElementPrivateBeta) import StripePaymentSheet
+import StripePaymentSheet
 
 extension EmbeddedPaymentElement.PaymentOptionDisplayData {
     /// Convert `PaymentOptionDisplayData` into a dictionary compatible with React Native bridge.

package/ios/PaymentSheetAppearance.swift

@@ -4,7 +4,7 @@
 //
 //  Created by Charles Cruzan on 5/11/22.
 //
-@_spi(EmbeddedPaymentElementPrivateBeta) import StripePaymentSheet
+import StripePaymentSheet
 
 internal class PaymentSheetAppearance {
     class func buildAppearanceFromParams(userParams: NSDictionary?) throws -> PaymentSheet.Appearance {

package/ios/StripeOnrampSdk.mm

@@ -65,6 +65,25 @@ RCT_EXPORT_METHOD(attachKycInfo:(nonnull NSDictionary *)info
   [StripeSdkImpl.shared attachKycInfo:info resolver:resolve rejecter:reject];
 }
 
+RCT_EXPORT_METHOD(retrieveMissingIdentifiers:(nonnull RCTPromiseResolveBlock)resolve
+                                      reject:(nonnull RCTPromiseRejectBlock)reject)
+{
+  [StripeSdkImpl.shared retrieveMissingIdentifiers:resolve rejecter:reject];
+}
+
+RCT_EXPORT_METHOD(submitIdentifiers:(nonnull NSArray *)identifiers
+                            resolve:(nonnull RCTPromiseResolveBlock)resolve
+                             reject:(nonnull RCTPromiseRejectBlock)reject)
+{
+  [StripeSdkImpl.shared submitIdentifiers:identifiers resolver:resolve rejecter:reject];
+}
+
+RCT_EXPORT_METHOD(presentUserAttestation:(nonnull RCTPromiseResolveBlock)resolve
+                                  reject:(nonnull RCTPromiseRejectBlock)reject)
+{
+  [StripeSdkImpl.shared presentUserAttestation:resolve rejecter:reject];
+}
+
 RCT_EXPORT_METHOD(presentKycInfoVerification:(NSDictionary *)updatedAddress
                                      resolve:(nonnull RCTPromiseResolveBlock)resolve
                                       reject:(nonnull RCTPromiseRejectBlock)reject)

package/ios/StripeSdk.mm

@@ -348,24 +348,24 @@ RCT_EXPORT_METHOD(checkoutSelectShippingOption:(nonnull NSString *)sessionKey
                                             rejecter:reject];
 }
 
-RCT_EXPORT_METHOD(checkoutUpdateTaxId:(nonnull NSString *)sessionKey
-                                  type:(nonnull NSString *)type
-                                 value:(nonnull NSString *)value
-                               resolve:(nonnull RCTPromiseResolveBlock)resolve
-                                reject:(nonnull RCTPromiseRejectBlock)reject)
+RCT_EXPORT_METHOD(checkoutRunServerUpdateStart:(nonnull NSString *)sessionKey
+                                        resolve:(nonnull RCTPromiseResolveBlock)resolve
+                                         reject:(nonnull RCTPromiseRejectBlock)reject)
 {
-  [StripeSdkImpl.shared checkoutUpdateTaxId:sessionKey
-                                       type:type
-                                      value:value
-                                   resolver:resolve
-                                   rejecter:reject];
+  [StripeSdkImpl.shared checkoutRunServerUpdateStart:sessionKey
+                                            resolver:resolve
+                                            rejecter:reject];
 }
 
-RCT_EXPORT_METHOD(checkoutRefresh:(nonnull NSString *)sessionKey
-                           resolve:(nonnull RCTPromiseResolveBlock)resolve
-                            reject:(nonnull RCTPromiseRejectBlock)reject)
+RCT_EXPORT_METHOD(checkoutRunServerUpdateComplete:(nonnull NSString *)sessionKey
+                                            error:(NSString *)error
+                                          resolve:(nonnull RCTPromiseResolveBlock)resolve
+                                           reject:(nonnull RCTPromiseRejectBlock)reject)
 {
-  [StripeSdkImpl.shared checkoutRefresh:sessionKey resolver:resolve rejecter:reject];
+  [StripeSdkImpl.shared checkoutRunServerUpdateComplete:sessionKey
+                                                  error:error
+                                               resolver:resolve
+                                               rejecter:reject];
 }
 
 RCT_EXPORT_METHOD(initCustomerSheet:(nonnull NSDictionary *)params

package/ios/StripeSdkEmitter.swift

@@ -22,6 +22,7 @@ import Foundation
     func emitOnCustomPaymentMethodConfirmHandlerCallback(_ value: [String: Any])
     func emitPaymentMethodMessagingElementDidUpdateHeight(_ value: [String: Any])
     func emitPaymentMethodMessagingElementConfigureResult(_ value: [String: Any])
+    func emitCheckoutSessionDidChangeState(_ value: [String: Any])
 }
 
 @objc public protocol StripeOnrampSdkEmitter {

package/ios/StripeSdkImpl+Checkout.swift

@@ -5,8 +5,9 @@
 //  Created by Nick Porter on 4/29/26.
 //
 
+import Combine
 import Foundation
-@_spi(CheckoutSessionsPreview) import StripePaymentSheet
+@_spi(ReactNativeSDK) import StripePaymentSheet
 
 extension StripeSdkImpl {
     internal func currentCheckoutStateResult(checkout: Checkout) -> NSDictionary {
@@ -35,7 +36,17 @@ extension StripeSdkImpl {
                 )
                 let sessionKey = UUID().uuidString
 
+                let cancellable = checkout.$state
+                    .dropFirst()
+                    .sink { [weak self] state in
+                        self?.emitter?.emitCheckoutSessionDidChangeState([
+                            "sessionKey": sessionKey,
+                            "state": Mappers.mapFromCheckoutState(state),
+                        ])
+                    }
+
                 self.checkoutInstances[sessionKey] = checkout
+                self.checkoutStateCancellables[sessionKey] = cancellable
 
                 resolve([
                     "sessionKey": sessionKey,
@@ -65,7 +76,11 @@ extension StripeSdkImpl {
             resolver: resolve,
             rejecter: reject
         ) { checkout, addressUpdate in
-            try await checkout.updateShippingAddress(addressUpdate)
+            try await checkout.updateShippingAddress(
+                name: addressUpdate.name,
+                phone: addressUpdate.phone,
+                address: addressUpdate.address
+            )
         }
     }
 
@@ -87,7 +102,11 @@ extension StripeSdkImpl {
             resolver: resolve,
             rejecter: reject
         ) { checkout, addressUpdate in
-            try await checkout.updateBillingAddress(addressUpdate)
+            try await checkout.updateBillingAddress(
+                name: addressUpdate.name,
+                phone: addressUpdate.phone,
+                address: addressUpdate.address
+            )
         }
     }
 
@@ -135,17 +154,12 @@ extension StripeSdkImpl {
             return
         }
 
-        let lineItemUpdate = Checkout.LineItemUpdate(
-            lineItemId: lineItemId,
-            quantity: integerQuantity
-        )
-
         performCheckoutMutation(
             sessionKey: sessionKey,
             resolver: resolve,
             rejecter: reject
         ) { checkout in
-            try await checkout.updateQuantity(with: lineItemUpdate)
+            try await checkout.updateQuantity(lineItemId: lineItemId, quantity: integerQuantity)
         }
     }
 
@@ -165,38 +179,59 @@ extension StripeSdkImpl {
         }
     }
 
-    @objc(checkoutUpdateTaxId:type:value:resolver:rejecter:)
-    public func checkoutUpdateTaxId(
+    @objc(checkoutRunServerUpdateStart:resolver:rejecter:)
+    public func checkoutRunServerUpdateStart(
         sessionKey: String,
-        type: String,
-        value: String,
         resolver resolve: @escaping RCTPromiseResolveBlock,
         rejecter reject: @escaping RCTPromiseRejectBlock
     ) {
-        let taxIdUpdate = Checkout.TaxIdUpdate(type: type, value: value)
+        Task { @MainActor [weak self] in
+            guard let self else {
+                reject(ErrorType.Failed, "Stripe SDK is unavailable", nil)
+                return
+            }
 
-        performCheckoutMutation(
-            sessionKey: sessionKey,
-            resolver: resolve,
-            rejecter: reject
-        ) { checkout in
-            try await checkout.updateTaxId(with: taxIdUpdate)
+            guard let checkout = self.checkoutInstances[sessionKey] else {
+                reject(ErrorType.Failed, "Checkout session not found", nil)
+                return
+            }
+
+            guard self.serverUpdateContinuations[sessionKey] == nil else {
+                reject(ErrorType.Failed, "A server update is already in progress for this session", nil)
+                return
+            }
+
+            do {
+                try await checkout.runServerUpdate {
+                    try await withCheckedThrowingContinuation { continuation in
+                        self.serverUpdateContinuations[sessionKey] = continuation
+                    }
+                }
+                resolve(self.currentCheckoutStateResult(checkout: checkout))
+            } catch {
+                reject(self.checkoutErrorCode(for: error), error.localizedDescription, error)
+            }
         }
     }
 
-    @objc(checkoutRefresh:resolver:rejecter:)
-    public func checkoutRefresh(
+    @objc(checkoutRunServerUpdateComplete:error:resolver:rejecter:)
+    public func checkoutRunServerUpdateComplete(
         sessionKey: String,
+        error: String?,
         resolver resolve: @escaping RCTPromiseResolveBlock,
         rejecter reject: @escaping RCTPromiseRejectBlock
     ) {
-        performCheckoutMutation(
-            sessionKey: sessionKey,
-            resolver: resolve,
-            rejecter: reject
-        ) { checkout in
-            try await checkout.refresh()
+        guard let continuation = serverUpdateContinuations.removeValue(forKey: sessionKey) else {
+            reject(ErrorType.Failed, "No pending server update for this session", nil)
+            return
+        }
+
+        if let error {
+            continuation.resume(throwing: CheckoutError.apiError(message: error))
+        } else {
+            continuation.resume()
         }
+        resolve(nil)
     }
 
     internal func buildCheckoutConfiguration(params: NSDictionary) -> Checkout.Configuration {
@@ -244,7 +279,7 @@ extension StripeSdkImpl {
         missingCountryMessage: String,
         resolver resolve: @escaping RCTPromiseResolveBlock,
         rejecter reject: @escaping RCTPromiseRejectBlock,
-        operation: @escaping (Checkout, Checkout.AddressUpdate) async throws -> Void
+        operation: @escaping (Checkout, Checkout.ContactAddress) async throws -> Void
     ) {
         guard let addressUpdate = buildCheckoutAddressUpdate(
             address: address,
@@ -268,7 +303,7 @@ extension StripeSdkImpl {
         address: NSDictionary,
         name: String?,
         phone: String?
-    ) -> Checkout.AddressUpdate? {
+    ) -> Checkout.ContactAddress? {
         guard let country = address["country"] as? String, !country.isEmpty else {
             return nil
         }
@@ -282,7 +317,7 @@ extension StripeSdkImpl {
             postalCode: address["postalCode"] as? String
         )
 
-        return Checkout.AddressUpdate(
+        return Checkout.ContactAddress(
             name: name,
             phone: phone,
             address: checkoutAddress

package/ios/StripeSdkImpl+CustomerSheet.swift

@@ -6,7 +6,7 @@
 //
 
 import Foundation
-@_spi(PrivateBetaCustomerSheet) @_spi(CustomerSessionBetaAccess) @_spi(STP) import StripePaymentSheet
+@_spi(PrivateBetaCustomerSheet) @_spi(STP) import StripePaymentSheet
 extension StripeSdkImpl {
     @objc(initCustomerSheet:customerAdapterOverrides:resolver:rejecter:)
     public func initCustomerSheet(params: NSDictionary,

package/ios/StripeSdkImpl+Embedded.swift

@@ -6,7 +6,7 @@
 //
 
 import Foundation
-@_spi(EmbeddedPaymentElementPrivateBeta) @_spi(ExperimentalAllowsRemovalOfLastSavedPaymentMethodAPI) @_spi(CustomerSessionBetaAccess) @_spi(STP) @_spi(CustomPaymentMethodsBeta) @_spi(CardFundingFilteringPrivatePreview) @_spi(CheckoutSessionsPreview) import StripePaymentSheet
+@_spi(ExperimentalAllowsRemovalOfLastSavedPaymentMethodAPI) @_spi(STP) @_spi(CustomPaymentMethodsBeta) @_spi(CardFundingFilteringPrivatePreview) import StripePaymentSheet
 
 @objc(StripeSdkImpl)
 extension StripeSdkImpl {

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) @_spi(CardFundingFilteringPrivatePreview) @_spi(CheckoutSessionsPreview) import StripePaymentSheet
+@_spi(ExperimentalAllowsRemovalOfLastSavedPaymentMethodAPI) @_spi(STP) @_spi(PaymentMethodOptionsSetupFutureUsagePreview) @_spi(CustomPaymentMethodsBeta) @_spi(ConfirmationTokensPublicPreview) @_spi(CardFundingFilteringPrivatePreview) import StripePaymentSheet
 
 extension StripeSdkImpl {
     internal func buildPaymentSheetConfiguration(