@stripe/stripe-react-native 0.65.1 → 0.67.0

package/src/types/Onramp.ts

@@ -1,10 +1,19 @@
 import type { Address } from './Common';
-import type { OnrampError, StripeError } from './Errors';
+import type { StripeError } from './Errors';
 import type {
   ApplePayBaseParams,
   ApplePayPaymentMethodParams,
 } from './PlatformPay';
 
+/**
+ * Generic error codes returned by Crypto Onramp APIs.
+ */
+export enum OnrampError {
+  Failed = 'Failed',
+  Canceled = 'Canceled',
+  Unknown = 'Unknown',
+}
+
 /**
  * Configuration used to initialize and customize the crypto onramp experience.
  *
@@ -199,7 +208,181 @@ export type KycInfo = {
   dateOfBirth?: DateOfBirth;
   /** Customer’s address, if collected. */
   address?: Address;
+  /** Two-letter ISO 3166-1 alpha-2 code for the country where the customer was born. */
+  birthCountry?: string;
+  /** City where the customer was born. */
+  birthCity?: string;
+  /** Two-letter ISO 3166-1 alpha-2 codes for the customer's nationalities. */
+  nationalities?: string[];
+};
+
+/**
+ * The type of compliance identifier required or submitted for regulatory compliance.
+ */
+export type ComplianceIdentifierType = string;
+
+/**
+ * The regulation requiring a compliance identifier.
+ */
+export type ComplianceRegulation = 'eu_carf' | 'eu_mica';
+
+/**
+ * A compliance identifier collected for MiCA or CRS/CARF compliance.
+ */
+export type ComplianceIdentifier = {
+  /** The type of identifier provided. */
+  type: ComplianceIdentifierType;
+  /** The identifier value. */
+  value: string;
+};
+
+/**
+ * A compliance identifier the customer still needs to provide.
+ */
+export type ComplianceIdentifierRequirement = {
+  /** The type of identifier required. */
+  type: ComplianceIdentifierType;
+  /** The regulation requiring this identifier. */
+  regulation: ComplianceRegulation;
+};
+
+/**
+ * A group describing alternative identifier types that may satisfy a requirement.
+ */
+export type ComplianceIdentifierAlternativeGroup = {
+  /** The original identifier types required. */
+  originalMissingIdentifiers: ComplianceIdentifierType[];
+  /** Alternative identifier types that may satisfy the original requirement. */
+  alternativeMissingIdentifiers: ComplianceIdentifierType[];
+};
+
+/**
+ * The compliance identifiers a customer still needs to provide.
+ */
+export type ComplianceIdentifierRequirements = {
+  /** Required identifier types and the regulations requiring them. */
+  identifiers: ComplianceIdentifierRequirement[];
+  /** Alternative identifier groups that may satisfy one or more requirements. */
+  alternatives: ComplianceIdentifierAlternativeGroup[];
+  /** Whether at least one CRS/CARF tax identification number still needs to be collected. */
+  carfTinRequired: boolean;
+};
+
+/**
+ * Typed Crypto Onramp error discriminants returned by newer native SDKs.
+ */
+export type OnrampErrorType = 'AppAttestationError' | 'UncategorizedApiError';
+
+/**
+ * A native SDK component and version included in Crypto Onramp diagnostics.
+ */
+export type SDKVersion = {
+  /** The SDK component name. */
+  name: string;
+  /** The SDK component version. */
+  version: string;
+};
+
+export type OnrampApiError = StripeError<OnrampError> & {
+  onrampErrorType: string;
+  developerMessage: string;
+  userMessage: string;
+  reason?: string;
+  operation: string;
+  appPackageName: string;
+  mode?: 'live' | 'test';
+  sdkVersions?: SDKVersion[];
+  requestId?: string;
+  apiErrorCode?: string;
+  apiErrorType?: string;
+  apiErrorMessage?: string;
+  apiUserMessage?: string;
+  docUrl?: string;
 };
+/**
+ * A typed Crypto Onramp app attestation failure.
+ */
+export type AppAttestationError = OnrampApiError & {
+  onrampErrorType: 'AppAttestationError';
+};
+
+/**
+ * A typed Crypto Onramp API error that did not map to a narrower category.
+ */
+export type UncategorizedApiError = OnrampApiError & {
+  onrampErrorType: 'UncategorizedApiError';
+};
+
+/**
+ * Error returned by Crypto Onramp APIs.
+ *
+ * Most failures use the generic Stripe error envelope. Newer native SDK
+ * versions may instead return typed SDK-owned errors via
+ * `onrampErrorType`.
+ */
+export type CryptoOnrampError =
+  | (StripeError<OnrampError> & {
+      onrampErrorType?: undefined;
+    })
+  | AppAttestationError
+  | UncategorizedApiError;
+
+/**
+ * Result of retrieving missing compliance identifiers.
+ */
+export type RetrieveMissingIdentifiersResult =
+  | (ComplianceIdentifierRequirements & {
+      error?: undefined;
+    })
+  | {
+      identifiers?: undefined;
+      alternatives?: undefined;
+      carfTinRequired?: undefined;
+      /** Present if retrieval failed with an error. */
+      error: CryptoOnrampError;
+    };
+
+/**
+ * Result of submitting compliance identifiers for MiCA and CRS/CARF compliance.
+ */
+export type SubmitIdentifiersResult =
+  | {
+      /** Whether all required MiCA identifiers and CRS/CARF tax identification numbers have been submitted. */
+      completed: boolean;
+      /** Any identifiers that still need to be collected. */
+      identifiers: ComplianceIdentifierRequirement[];
+      /** Alternative identifier groups that may satisfy one or more requirements. */
+      alternatives: ComplianceIdentifierAlternativeGroup[];
+      /** Whether at least one CRS/CARF tax identification number still needs to be collected. */
+      carfTinRequired: boolean;
+      /** Submitted identifier types whose values were invalid. */
+      invalidIdentifiers: ComplianceIdentifierType[];
+      error?: undefined;
+    }
+  | {
+      completed?: undefined;
+      identifiers?: undefined;
+      alternatives?: undefined;
+      carfTinRequired?: undefined;
+      invalidIdentifiers?: undefined;
+      /** Present if submission failed with an error. */
+      error: CryptoOnrampError;
+    };
+
+/**
+ * Result of presenting user attestation.
+ */
+export type UserAttestationResult =
+  | {
+      /** The customer accepted the attestation. */
+      status: 'Confirmed';
+      error?: undefined;
+    }
+  | {
+      status?: undefined;
+      /** Present if attestation failed or was cancelled. */
+      error: CryptoOnrampError;
+    };
 
 /**
  * Result of KYC verification.
@@ -218,7 +401,7 @@ export type VerifyKycResult =
   | {
       status?: undefined;
       /** Present if the verification failed with an error. */
-      error: StripeError<OnrampError>;
+      error: CryptoOnrampError;
     };
 
 /**
@@ -226,7 +409,7 @@ export type VerifyKycResult =
  */
 export type VoidResult = {
   /** Present if the operation failed. */
-  error?: StripeError<OnrampError>;
+  error?: CryptoOnrampError;
 };
 
 /**
@@ -254,7 +437,7 @@ export type AuthorizeResult =
       status?: undefined;
       customerId?: undefined;
       /** Present if the authorization failed with an error. */
-      error: StripeError<OnrampError>;
+      error: CryptoOnrampError;
     };
 
 /**
@@ -269,7 +452,7 @@ export type HasLinkAccountResult =
   | {
       hasLinkAccount?: undefined;
       /** Present if the lookup failed with an error. */
-      error: StripeError<OnrampError>;
+      error: CryptoOnrampError;
     };
 
 /**
@@ -284,7 +467,7 @@ export type RegisterLinkUserResult =
   | {
       customerId?: undefined;
       /** Present if registration failed with an error. */
-      error: StripeError<OnrampError>;
+      error: CryptoOnrampError;
     };
 
 /**
@@ -319,7 +502,7 @@ export type CollectPaymentMethodResult =
       displayData?: undefined;
       kycInfo?: undefined;
       /** Present if collection/selection failed with an error. */
-      error: StripeError<OnrampError>;
+      error: CryptoOnrampError;
     };
 
 /**
@@ -334,7 +517,7 @@ export type CreateCryptoPaymentTokenResult =
   | {
       cryptoPaymentToken?: undefined;
       /** Present if token creation failed with an error. */
-      error: StripeError<OnrampError>;
+      error: CryptoOnrampError;
     };
 
 /**
@@ -375,5 +558,5 @@ export type PaymentDisplayDataResult =
   | {
       displayData?: undefined;
       /** Present if collection/selection failed with an error. */
-      error: StripeError<OnrampError>;
+      error: CryptoOnrampError;
     };

package/stripe-react-native.podspec

@@ -2,7 +2,7 @@ require 'json'
 
 package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
 # Keep stripe_version in sync with https://github.com/stripe/stripe-identity-react-native/blob/main/stripe-identity-react-native.podspec
-stripe_version = '~> 25.12.0'
+stripe_version = '~> 25.17.0'
 
 fabric_enabled = ENV['RCT_NEW_ARCH_ENABLED'] == '1'
 
@@ -38,7 +38,7 @@ Pod::Spec.new do |s|
 
   s.subspec 'Core' do |core|
     core.source_files = 'ios/**/*.{h,m,mm,swift}'
-    core.exclude_files = [ 'ios/Tests/', 'ios/NewArch/', 'ios/StripeOnrampSdk.h', 'ios/StripeOnrampSdk.mm' ]
+    core.exclude_files = [ 'ios/Tests/', 'ios/NewArch/', 'ios/StripeOnrampSdk.h', 'ios/StripeOnrampSdk.mm', 'ios/OnrampErrors.swift' ]
     # These headers contain c++ code so make sure they are private to avoid
     # being exported to the umbrella header, which is used by swift interop.
     # StripeSwiftInterop.h will cause circular dependency issues.
@@ -53,7 +53,7 @@ Pod::Spec.new do |s|
   end
 
   s.subspec 'Onramp' do |onramp|
-    onramp.source_files = [ 'ios/StripeOnrampSdk.h', 'ios/StripeOnrampSdk.mm' ]
+    onramp.source_files = [ 'ios/StripeOnrampSdk.h', 'ios/StripeOnrampSdk.mm', 'ios/OnrampErrors.swift' ]
     onramp.dependency 'stripe-react-native/Core'
     onramp.dependency 'StripeCryptoOnramp', stripe_version
   end

package/ios/CurrencySelectorElementManager.swift

@@ -1,12 +0,0 @@
-import Foundation
-
-@objc(StripeCurrencySelectorElementManager)
-class StripeCurrencySelectorElementManager: RCTViewManager {
-    override static func requiresMainQueueSetup() -> Bool {
-        return true
-    }
-
-    override func view() -> UIView! {
-        return StripeCurrencySelectorElementContainerView(frame: .zero)
-    }
-}