@stripe/stripe-react-native 0.65.1 → 0.66.0

package/src/types/Checkout.ts

@@ -67,16 +67,81 @@ export namespace Checkout {
         session: Session;
       };
 
+  /**
+   * A Stripe Checkout Session.
+   * @checkoutSessionsPreview
+   * @internal
+   */
+  export interface Session {
+    /** Unique identifier for this checkout session. */
+    id: string;
+    /** The business name as configured in your Stripe account. */
+    businessName?: string;
+    /** Three-letter ISO 4217 currency code in lowercase (e.g. `"usd"`). */
+    currency?: string;
+    /** Currency options available when adaptive pricing is active. */
+    currencyOptions: CurrencyOption[];
+    /** The aggregate amounts calculated per discount for all line items. */
+    discountAmounts: DiscountAmount[];
+    /** The customer's email address, if available. */
+    email?: string;
+    /** The line items the customer is purchasing. */
+    lineItems: LineItem[];
+    /** Indicates whether this session was created in live mode. */
+    livemode: boolean;
+    /** The factor used to convert between minor and major currency units. */
+    minorUnitsAmountDivisor?: number;
+    /** The selected shipping option, if any. */
+    shipping?: SelectedShipping;
+    /** The shipping address set via `updateShippingAddress`, if any. */
+    shippingAddress?: ContactAddress;
+    /** The shipping rate options available for this session. */
+    shippingOptions: ShippingOption[];
+    /** The current session status, if available. */
+    status?: Status;
+    /** Tax computation status and aggregated tax amounts. */
+    tax: Tax;
+    /** Tax and discount details for the computed total amount. */
+    total?: Total;
+    /** The billing address set via `updateBillingAddress`, if any. */
+    billingAddress?: ContactAddress;
+  }
+
+  /**
+   * The mode of a checkout session.
+   *
+   * - `unknown` - A mode not recognized by this version of the SDK.
+   * - `payment` - Accept one-time payments.
+   * - `setup` - Save payment details to charge later.
+   * - `subscription` - Set up fixed-price subscriptions.
+   * @checkoutSessionsPreview
+   * @internal
+   */
+  export type Mode = 'unknown' | 'payment' | 'setup' | 'subscription';
+
   /**
    * The status of a checkout session.
+   * @checkoutSessionsPreview
+   * @internal
+   */
+  export interface Status {
+    /** The lifecycle status of the session. */
+    type: StatusType;
+    /** The payment status. Only meaningful when type is `complete`. */
+    paymentStatus?: PaymentStatus;
+  }
+
+  /**
+   * The lifecycle status of a checkout session.
    *
    * - `unknown` - A status not recognized by this version of the SDK.
    * - `open` - The checkout session is still in progress.
    * - `complete` - The checkout session is complete.
    * - `expired` - The checkout session has expired.
+   * @checkoutSessionsPreview
    * @internal
    */
-  export type Status = 'unknown' | 'open' | 'complete' | 'expired';
+  export type StatusType = 'unknown' | 'open' | 'complete' | 'expired';
 
   /**
    * The payment status of a checkout session.
@@ -85,6 +150,7 @@ export namespace Checkout {
    * - `paid` - The payment funds are available in your account.
    * - `unpaid` - The payment funds are not yet available in your account.
    * - `noPaymentRequired` - No payment is currently required for the session.
+   * @checkoutSessionsPreview
    * @internal
    */
   export type PaymentStatus =
@@ -94,61 +160,102 @@ export namespace Checkout {
     | 'noPaymentRequired';
 
   /**
-   * A read-only snapshot of a Stripe Checkout Session.
+   * A monetary amount with both a localized display string and a value in
+   * the smallest currency unit (e.g. cents).
+   * @checkoutSessionsPreview
    * @internal
    */
-  export interface Session {
-    /** Unique identifier for this checkout session. */
-    id: string;
-    /** The current session state, if available. */
-    status?: Status;
-    /** The payment status for this checkout session. */
-    paymentStatus: PaymentStatus;
-    /** Three-letter ISO 4217 currency code in lowercase (e.g. `"usd"`). */
-    currency?: string;
-    /** Indicates whether this session was created in live mode. */
-    livemode: boolean;
-    /** A summary of monetary totals for this session, if available. */
-    totals?: Totals;
-    /** The line items purchased by the customer. */
-    lineItems: LineItem[];
-    /** The shipping rate options available for this session. */
-    shippingOptions: ShippingOption[];
-    /** The discounts applied to this session. */
-    discounts: Discount[];
-    /** The Stripe customer ID attached to this session, if any. */
-    customerId?: string;
-    /** The customer's email address, if available. */
-    customerEmail?: string;
-    /** The billing address set via `updateBillingAddress`, if any. */
-    billingAddress?: AddressUpdate;
-    /** The shipping address set via `updateShippingAddress`, if any. */
-    shippingAddress?: AddressUpdate;
+  export interface Amount {
+    /** Localized, formatted string including currency symbol (e.g. `"$10.00"`). */
+    amount: string;
+    /** Value in the smallest currency unit (e.g. cents for USD). */
+    minorUnitsAmount: number;
+  }
+
+  /**
+   * A monetary amount supporting sub-minor-unit precision.
+   *
+   * Use this for sub-cent pricing (e.g. usage-based billing) where rounding
+   * to the nearest minor unit would lose precision.
+   * @checkoutSessionsPreview
+   * @internal
+   */
+  export interface DecimalAmount {
+    /** Localized, formatted string including currency symbol. */
+    amount: string;
+    /** Value in the smallest currency unit, with decimal precision. */
+    minorUnitsAmount: number;
+  }
+
+  /**
+   * Tax and discount details for the computed total amount of a checkout session.
+   * @checkoutSessionsPreview
+   * @internal
+   */
+  export interface Total {
+    /** Total of all line items, excluding tax, discounts, and shipping. */
+    subtotal: Amount;
+    /** Sum of all exclusive tax amounts. */
+    taxExclusive: Amount;
+    /** Sum of all inclusive tax amounts. */
+    taxInclusive: Amount;
+    /** Sum of all shipping amounts. */
+    shippingRate: Amount;
+    /** Sum of all discounts. A positive number reduces the amount to be paid. */
+    discount: Amount;
+    /** Grand total, including discounts and tax. */
+    total: Amount;
+    /** Amount of customer credit balance applied to the payment. */
+    appliedBalance: Amount;
+    /** When `true`, no payment is collected and the amount is added to the next invoice. */
+    balanceAppliedToNextInvoice: boolean;
   }
 
   /**
-   * Monetary totals for a checkout session.
+   * Tax computation status and aggregated tax amounts for a checkout session.
+   * @checkoutSessionsPreview
+   * @internal
+   */
+  export interface Tax {
+    /** The current tax computation status. */
+    status: TaxStatus;
+    /** Per-tax-rate amounts, or undefined if tax has not been computed. */
+    taxAmounts?: TaxAmount[];
+  }
+
+  /**
+   * The tax computation status of a checkout session.
    *
-   * All amounts are in the smallest currency unit (e.g. cents for USD).
-   * @internal
-   */
-  export interface Totals {
-    /** The subtotal amount before discounts, shipping, and tax. */
-    subtotal: number;
-    /** The final total after discounts, shipping, and tax. */
-    total: number;
-    /** The amount currently due from the customer. */
-    due: number;
-    /** The total discount amount applied to the session. */
-    discount: number;
-    /** The total shipping amount. */
-    shipping: number;
-    /** The total tax amount applied to the session. */
-    tax: number;
+   * - `unknown` - A status not recognized by this version of the SDK.
+   * - `ready` - Tax is computed and the session is ready for confirmation.
+   * - `requiresShippingAddress` - A shipping address is needed to calculate tax.
+   * - `requiresBillingAddress` - A billing address is needed to calculate tax.
+   * @checkoutSessionsPreview
+   * @internal
+   */
+  export type TaxStatus =
+    | 'unknown'
+    | 'ready'
+    | 'requiresShippingAddress'
+    | 'requiresBillingAddress';
+
+  /**
+   * A tax amount calculated for a line item, shipping option, or aggregate session total.
+   * @checkoutSessionsPreview
+   * @internal
+   */
+  export interface TaxAmount {
+    /** The tax amount. */
+    amount: Amount;
+    /** Whether this tax is inclusive (already in subtotal) or exclusive (added on top). */
+    inclusive: boolean;
+    /** A user-facing description (e.g. `"Sales Tax"` or `"VAT 20%"`). */
+    displayName: string;
   }
 
   /**
    * A line item in a checkout session.
+   * @checkoutSessionsPreview
    * @internal
    */
   export interface LineItem {
@@ -156,78 +263,172 @@ export namespace Checkout {
     id: string;
     /** The display name shown for this line item. */
     name: string;
-    /** The quantity for this line item. */
+    /** An optional, merchant-supplied description. */
+    description?: string;
+    /** Image URLs configured on the underlying product. */
+    images: string[];
+    /** The quantity of items being purchased. */
     quantity: number;
-    /** The per-unit price in the smallest currency unit. */
-    unitAmount: number;
-    /** Three-letter ISO 4217 currency code in lowercase. */
-    currency: string;
+    /** The cost of a single unit. */
+    unitAmount?: Amount;
+    /** The unit amount with sub-cent precision. */
+    unitAmountDecimal?: DecimalAmount;
+    /** Total before any discounts or exclusive taxes. */
+    subtotal?: Amount;
+    /** Total discount amount for this line item. */
+    discount?: Amount;
+    /** Total exclusive tax for this line item. */
+    taxExclusive?: Amount;
+    /** Total inclusive tax for this line item. */
+    taxInclusive?: Amount;
+    /** Final total for this line item, including discounts and tax. */
+    total?: Amount;
+    /** Per-discount breakdown for this line item. */
+    discountAmounts: DiscountAmount[];
+    /** Per-tax-rate breakdown for this line item. */
+    taxAmounts: TaxAmount[];
+    /** Configuration for adjustable quantity, if enabled. */
+    adjustableQuantity?: AdjustableQuantity;
+  }
+
+  /**
+   * Configuration for a customer-adjustable line item quantity.
+   * @checkoutSessionsPreview
+   * @internal
+   */
+  export interface AdjustableQuantity {
+    /** The minimum quantity the customer can purchase. */
+    minimum: number;
+    /** The maximum quantity the customer can purchase. */
+    maximum: number;
   }
 
   /**
    * A shipping option available in a checkout session.
+   * @checkoutSessionsPreview
    * @internal
    */
   export interface ShippingOption {
     /** The shipping rate identifier. */
     id: string;
     /** The display name shown to the customer. */
-    displayName: string;
-    /** The shipping amount in the smallest currency unit. */
-    amount: number;
+    displayName?: string;
+    /** The shipping cost. */
+    amount: Amount;
     /** Three-letter ISO 4217 currency code in lowercase. */
     currency: string;
-    /** The estimated delivery window shown to the customer, if available. */
-    deliveryEstimate?: string;
+    /** The estimated delivery window, if available. */
+    deliveryEstimate?: DeliveryEstimate;
+  }
+
+  /**
+   * The estimated delivery range for a shipping option.
+   * @checkoutSessionsPreview
+   * @internal
+   */
+  export interface DeliveryEstimate {
+    /** The lower bound of the delivery estimate. */
+    minimum?: DeliveryEstimateBound;
+    /** The upper bound of the delivery estimate. */
+    maximum?: DeliveryEstimateBound;
   }
 
   /**
-   * A discount applied to a checkout session.
+   * A bound (minimum or maximum) of a delivery estimate.
+   * @checkoutSessionsPreview
    * @internal
    */
-  export interface Discount {
-    /** The coupon associated with this discount. */
-    coupon: Coupon;
+  export interface DeliveryEstimateBound {
+    /** The unit of time. */
+    unit: DeliveryEstimateUnit;
+    /** The number of units. */
+    value: number;
+  }
+
+  /**
+   * The unit of time for a delivery estimate.
+   * @checkoutSessionsPreview
+   * @internal
+   */
+  export type DeliveryEstimateUnit =
+    | 'unknown'
+    | 'hour'
+    | 'day'
+    | 'businessDay'
+    | 'week'
+    | 'month';
+
+  /**
+   * The shipping option selected for a checkout session, plus any computed
+   * shipping tax.
+   * @checkoutSessionsPreview
+   * @internal
+   */
+  export interface SelectedShipping {
+    /** The selected shipping option. */
+    shippingOption: ShippingOption;
+    /** Tax amounts calculated for the shipping cost. */
+    taxAmounts: TaxAmount[];
+  }
+
+  /**
+   * A discount applied to a checkout session or line item.
+   * @checkoutSessionsPreview
+   * @internal
+   */
+  export interface DiscountAmount {
+    /** The discount amount. A positive number reduces the amount to be paid. */
+    amount: Amount;
+    /** A user-facing description of the discount. */
+    displayName: string;
     /** The promotion code used to apply this discount, if any. */
     promotionCode?: string;
-    /** The discount amount in the smallest currency unit. */
-    amount: number;
   }
 
   /**
-   * A coupon associated with a checkout discount.
+   * A currency option available on a checkout session when adaptive pricing
+   * is active.
+   * @checkoutSessionsPreview
    * @internal
    */
-  export interface Coupon {
-    /** The coupon identifier. */
-    id: string;
-    /** The display name of the coupon, if one exists. */
-    name?: string;
-    /** The percentage off, if this is a percentage-based coupon. */
-    percentOff?: number;
-    /** The fixed amount off, in the smallest currency unit, if applicable. */
-    amountOff?: number;
+  export interface CurrencyOption {
+    /** The total amount in this currency. */
+    amount: Amount;
+    /** Three-letter ISO 4217 currency code in lowercase. */
+    currency: string;
+    /** Conversion details, present only for the customer's local currency. */
+    currencyConversion?: CurrencyConversion;
   }
 
   /**
-   * A locally stored address override for checkout.
-   *
-   * Address updates are merged into PaymentSheet configuration and may also be
-   * sent to Stripe when tax calculation depends on the billing or shipping
-   * address.
+   * Currency conversion details for an adaptive-pricing currency option.
+   * @checkoutSessionsPreview
    * @internal
    */
-  export interface AddressUpdate {
+  export interface CurrencyConversion {
+    /** The exchange rate used to convert source to customer currency. */
+    fxRate: string;
+    /** The merchant's original currency (three-letter ISO 4217 code). */
+    sourceCurrency: string;
+  }
+
+  /**
+   * A contact address containing a name, phone, and postal address.
+   * @checkoutSessionsPreview
+   * @internal
+   */
+  export interface ContactAddress {
     /** The customer's or recipient's name, if provided. */
     name?: string;
     /** The customer's or recipient's phone number, if provided. */
     phone?: string;
-    /** The postal address to use for the update. */
+    /** The postal address. */
     address: Address;
   }
 
   /**
    * A postal address used for billing, shipping, or tax updates.
+   * @checkoutSessionsPreview
    * @internal
    */
   export interface Address {
@@ -366,12 +567,16 @@ export interface Checkout {
   updateTaxId(type: string, value: string): Promise<void>;
 
   /**
-   * Refreshes the session by fetching the latest copy from Stripe.
+   * Runs an async operation that updates the Checkout Session on your server,
+   * then automatically refreshes the local session state.
+   *
+   * Call your server inside `serverUpdate` to modify the Checkout Session.
+   * A 20-second timeout is enforced by the native SDK.
    *
-   * Call this after making server-side changes to the Checkout Session
-   * so the local state stays in sync.
-   * - Throws: `CheckoutError` if refreshing the session fails.
+   * @param serverUpdate - An async function that calls your server to update the session.
+   * - Throws: `CheckoutError` if the operation times out or fails.
+   * @checkoutSessionsPreview
    * @internal
    */
-  refresh(): Promise<void>;
+  runServerUpdate(serverUpdate: () => Promise<void>): Promise<void>;
 }

package/src/types/Onramp.ts

@@ -199,8 +199,117 @@ 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[];
+};
+
+/**
+ * Result of retrieving missing compliance identifiers.
+ */
+export type RetrieveMissingIdentifiersResult =
+  | (ComplianceIdentifierRequirements & {
+      error?: undefined;
+    })
+  | {
+      identifiers?: undefined;
+      alternatives?: undefined;
+      /** Present if retrieval failed with an error. */
+      error: StripeError<OnrampError>;
+    };
+
+/**
+ * Result of submitting compliance identifiers for MiCA and CRS/CARF compliance.
+ */
+export type SubmitIdentifiersResult =
+  | {
+      /** Whether all required identifiers were accepted. */
+      valid: boolean;
+      /** Any identifiers that still need to be collected. */
+      identifiers: ComplianceIdentifierRequirement[];
+      /** Alternative identifier groups that may satisfy one or more requirements. */
+      alternatives: ComplianceIdentifierAlternativeGroup[];
+      /** Submitted identifier types whose values were invalid. */
+      invalidIdentifiers: ComplianceIdentifierType[];
+      error?: undefined;
+    }
+  | {
+      valid?: undefined;
+      identifiers?: undefined;
+      alternatives?: undefined;
+      invalidIdentifiers?: undefined;
+      /** Present if submission failed with an error. */
+      error: StripeError<OnrampError>;
+    };
+
+/**
+ * Result of presenting the CRS/CARF declaration.
+ */
+export type CRSCARFDeclarationResult =
+  | {
+      /** The customer accepted the declaration. */
+      status: 'Confirmed';
+      error?: undefined;
+    }
+  | {
+      status?: undefined;
+      /** Present if the declaration failed or was cancelled. */
+      error: StripeError<OnrampError>;
+    };
+
 /**
  * Result of KYC verification.
  */

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.15.0'
 
 fabric_enabled = ENV['RCT_NEW_ARCH_ENABLED'] == '1'
 

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)
-    }
-}