@stripe/stripe-react-native 0.65.0 → 0.66.0

package/src/specs/NativeCurrencySelectorElement.ts

@@ -0,0 +1,35 @@
+import type { HostComponent, ViewProps } from 'react-native';
+import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNativeComponent';
+import type {
+  DirectEventHandler,
+  Double,
+  WithDefault,
+} from 'react-native/Libraries/Types/CodegenTypes';
+
+export interface HeightChangeEvent {
+  height: Double;
+}
+
+export interface NativeProps extends ViewProps {
+  /**
+   * Opaque key returned by `useCheckout`. The native side uses this to look
+   * up the matching `Checkout` instance and observe its state — there's no
+   * separate session-update event from this view, since `useCheckout`
+   * already subscribes to a single `checkoutSessionDidChangeState` channel
+   * that mirrors every native-driven mutation back into JS.
+   */
+  sessionKey: string;
+
+  /** When true, the toggle is visible but ignores user interaction. */
+  disabled?: WithDefault<boolean, false>;
+
+  /**
+   * Fired whenever the element's intrinsic height changes so the RN
+   * layout system can update the containing view.
+   */
+  onHeightChange?: DirectEventHandler<HeightChangeEvent>;
+}
+
+export default codegenNativeComponent<NativeProps>(
+  'StripeCurrencySelectorElement'
+) as HostComponent<NativeProps>;

package/src/specs/NativeEmbeddedPaymentElement.ts

@@ -7,7 +7,8 @@ import type { UnsafeMixed } from './utils';
 
 export interface NativeProps extends ViewProps {
   configuration: UnsafeMixed<EmbeddedPaymentElementConfiguration>;
-  intentConfiguration: UnsafeMixed<IntentConfiguration>;
+  intentConfiguration?: UnsafeMixed<IntentConfiguration>;
+  checkout?: UnsafeMixed<{ sessionKey: string }>;
 }
 
 export interface NativeCommands {
@@ -19,10 +20,19 @@ export interface NativeCommands {
     viewRef: React.ElementRef<HostComponent<NativeProps>>,
     intentConfigurationJson: string
   ) => void;
+  updateWithCheckout: (
+    viewRef: React.ElementRef<HostComponent<NativeProps>>,
+    sessionKey: string
+  ) => void;
 }
 
 export const Commands: NativeCommands = codegenNativeCommands<NativeCommands>({
-  supportedCommands: ['confirm', 'clearPaymentOption', 'update'],
+  supportedCommands: [
+    'confirm',
+    'clearPaymentOption',
+    'update',
+    'updateWithCheckout',
+  ],
 });
 
 type ComponentType = HostComponent<NativeProps>;

package/src/specs/NativeOnrampSdkModule.ts

@@ -19,6 +19,11 @@ export interface Spec extends TurboModule {
   attachKycInfo(
     kycInfo: UnsafeObject<Onramp.KycInfo>
   ): Promise<Onramp.VoidResult>;
+  retrieveMissingIdentifiers(): Promise<Onramp.RetrieveMissingIdentifiersResult>;
+  submitIdentifiers(
+    identifiers: ReadonlyArray<UnsafeObject<Onramp.ComplianceIdentifier>>
+  ): Promise<Onramp.SubmitIdentifiersResult>;
+  presentCRSCARFDeclaration(): Promise<Onramp.CRSCARFDeclarationResult>;
   presentKycInfoVerification: (
     updatedAddress: UnsafeObject<Address> | null
   ) => Promise<Onramp.VerifyKycResult>;

package/src/specs/NativeStripeSdkModule.ts

@@ -199,12 +199,19 @@ export interface Spec extends TurboModule {
     intentConfig: UnsafeObject<IntentConfiguration>,
     configuration: UnsafeObject<EmbeddedPaymentElementConfiguration>
   ): Promise<void>;
+  createEmbeddedPaymentElementWithCheckout(
+    sessionKey: string,
+    configuration: UnsafeObject<EmbeddedPaymentElementConfiguration>
+  ): Promise<void>;
   confirmEmbeddedPaymentElement(
     viewTag: Int32
   ): Promise<EmbeddedPaymentElementResult>;
   updateEmbeddedPaymentElement(
     intentConfig: UnsafeObject<IntentConfiguration>
-  ): Promise<void>;
+  ): Promise<UnsafeObject<any> | null>;
+  updateEmbeddedPaymentElementWithCheckout(
+    sessionKey: string
+  ): Promise<UnsafeObject<any> | null>;
   clearEmbeddedPaymentOption(viewTag: Int32): Promise<void>;
   createRadarSession(): Promise<CreateRadarSessionResult>;
 
@@ -255,7 +262,14 @@ export interface Spec extends TurboModule {
     value: string
   ): Promise<UnsafeObject<Checkout.State>>;
 
-  checkoutRefresh(sessionKey: string): Promise<UnsafeObject<Checkout.State>>;
+  checkoutRunServerUpdateStart(
+    sessionKey: string
+  ): Promise<UnsafeObject<Checkout.State>>;
+
+  checkoutRunServerUpdateComplete(
+    sessionKey: string,
+    error: string | null
+  ): Promise<void>;
 
   setFinancialConnectionsForceNativeFlow(enabled: boolean): Promise<void>;
 

package/src/types/Checkout.ts

@@ -14,7 +14,7 @@ export namespace Checkout {
      * When allowed, Stripe may present prices in the customer's local
      * currency alongside the merchant's settlement currency.
      *
-     * Default: `{ allowed: true }`.
+     * Default: `{ allowed: false }`.
      */
     adaptivePricing?: AdaptivePricing;
   }
@@ -30,7 +30,7 @@ export namespace Checkout {
      * Set to `false` to prevent Stripe from activating adaptive pricing even
      * if the Checkout Session is configured for it on the server.
      *
-     * Default: `true`.
+     * Default: `false`.
      */
     allowed: boolean;
   }
@@ -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>;
 }