@stripe/stripe-react-native 0.63.0 → 0.64.1

package/src/types/Onramp.ts

@@ -1,5 +1,9 @@
 import type { Address } from './Common';
 import type { OnrampError, StripeError } from './Errors';
+import type {
+  ApplePayBaseParams,
+  ApplePayPaymentMethodParams,
+} from './PlatformPay';
 
 /**
  * Configuration used to initialize and customize the crypto onramp experience.
@@ -28,7 +32,11 @@ export type GooglePayConfig = {
   merchantCountryCode: string;
   /** Merchant name displayed in the Google Pay sheet. */
   merchantName: string;
-  /** Whether an existing payment method is required. Defaults to false. */
+  /** Set to true to request an email address. Defaults to false. */
+  isEmailRequired?: boolean;
+  /** Set to false if you don't support credit cards. Defaults to true. */
+  allowCreditCards?: boolean;
+  /** Whether an existing payment method is required. Defaults to true. */
   existingPaymentMethodRequired?: boolean;
   /** Billing address collection configuration. */
   billingAddressConfig?: GooglePayBillingAddressConfig;
@@ -46,6 +54,39 @@ export type GooglePayBillingAddressConfig = {
   isPhoneNumberRequired?: boolean;
 };
 
+/**
+ * Google Pay parameters for the onramp collectPaymentMethod call.
+ * Only includes the fields passed to GooglePayPaymentMethodLauncher.present().
+ * Google Pay config (merchantCountryCode, testEnv, etc.) belongs in GooglePayConfig
+ * provided to configure().
+ */
+export type OnrampGooglePayParams = {
+  /** ISO 4217 alphabetic currency code (e.g. "USD"). */
+  currencyCode: string;
+  /** Amount in the currency's smallest unit. */
+  amount: number;
+  /** An optional label to display with the amount. */
+  label?: string;
+  /** A unique ID that identifies a transaction attempt. Required when sending callbacks to the Google Transaction Events API. */
+  transactionId?: string;
+};
+
+/**
+ * Platform Pay parameters for the onramp collectPaymentMethod call.
+ */
+export type OnrampPlatformPayParams = {
+  /**
+   * Google Pay parameters. Android only.
+   */
+  googlePay?: OnrampGooglePayParams;
+  /**
+   * Apple Pay parameters. iOS only.
+   * To receive `kycInfo` back from `collectPaymentMethod`, request Apple Pay billing
+   * `.name` and/or `.postalAddress` via `requiredBillingContactFields`.
+   */
+  applePay?: ApplePayBaseParams & ApplePayPaymentMethodParams;
+};
+
 /**
  * Customization options for Link/Stripe-provided UI.
  */
@@ -270,10 +311,13 @@ export type CollectPaymentMethodResult =
   | {
       /** Display data for the selected payment method. */
       displayData: PaymentMethodDisplayData;
+      /** Partial KYC data returned from Platform Pay billing details, when requested. */
+      kycInfo?: KycInfo;
       error?: undefined;
     }
   | {
       displayData?: undefined;
+      kycInfo?: undefined;
       /** Present if collection/selection failed with an error. */
       error: StripeError<OnrampError>;
     };

package/src/types/PaymentIntent.ts

@@ -33,6 +33,7 @@ export type ConfirmParams =
   | CardParams
   | IdealParams
   | OxxoParams
+  | MultibancoParams
   | P24Params
   | AlipayParams
   | AlmaParams
@@ -157,6 +158,15 @@ export interface OxxoParams {
   };
 }
 
+export interface MultibancoParams {
+  paymentMethodType: 'Multibanco';
+  paymentMethodData: {
+    billingDetails: BillingDetails & { email: string };
+    mandateData?: MandateData;
+    metadata?: MetaData;
+  };
+}
+
 export interface GrabPayParams {
   paymentMethodType: 'GrabPay';
   paymentMethodData?: {

package/src/types/PaymentMethod.ts

@@ -20,7 +20,6 @@ export interface Result {
   Fpx: FpxResult;
   Ideal: IdealResult;
   SepaDebit: SepaDebitResult;
-  Upi: UpiResult;
   USBankAccount: USBankAccountResult;
 }
 
@@ -28,6 +27,7 @@ export type CreateParams =
   | CardParams
   | IdealParams
   | OxxoParams
+  | MultibancoParams
   | P24Params
   | AlipayParams
   | SepaParams
@@ -95,6 +95,13 @@ export interface OxxoParams {
   };
 }
 
+export interface MultibancoParams {
+  paymentMethodType: 'Multibanco';
+  paymentMethodData: {
+    billingDetails: BillingDetails & { email: string };
+  };
+}
+
 export interface GrabPayParams {
   paymentMethodType: 'GrabPay';
   paymentMethodData?: {
@@ -246,10 +253,6 @@ export interface SepaDebitResult {
   last4?: string;
 }
 
-export interface UpiResult {
-  vpa?: string;
-}
-
 export type USBankAccountResult = {
   routingNumber?: string;
   accountHolderType?: BankAcccountHolderType;
@@ -276,8 +279,8 @@ export type Type =
   | 'P24'
   | 'Eps'
   | 'Bancontact'
+  | 'Multibanco'
   | 'Oxxo'
-  | 'Upi'
   | 'USBankAccount'
   | 'PayPal'
   | 'Unknown';

package/src/types/PaymentSheet.ts

@@ -15,6 +15,7 @@ import type { FutureUsage } from './PaymentIntent';
 import type { Result } from './PaymentMethod';
 import type { StripeError } from './Errors';
 import type { Result as ConfirmationTokenResult } from './ConfirmationToken';
+import type { Checkout } from './Checkout';
 
 export type SetupParamsBase = IntentParams & {
   /** Your customer-facing business name. On Android, this is required and cannot be an empty string. */
@@ -46,7 +47,7 @@ export type SetupParamsBase = IntentParams & {
   defaultShippingDetails?: AddressDetails;
   /** If true, allows payment methods that do not move money at the end of the checkout. Defaults to false.
    *
-   * Some payment methods can’t guarantee you will receive funds from your customer at the end of the checkout
+   * Some payment methods can't guarantee you will receive funds from your customer at the end of the checkout
    * because they take time to settle (eg. most bank debits, like SEPA or ACH) or require customer action to
    * complete (e.g. OXXO, Konbini, Boleto). If this is set to true, make sure your integration listens to webhooks
    * for notifications on whether a payment has succeeded or not.
@@ -65,7 +66,7 @@ export type SetupParamsBase = IntentParams & {
    *  You can override the default order in which payment methods are displayed in PaymentSheet with a list of payment method types.
    *  See https://stripe.com/docs/api/payment_methods/object#payment_method_object-type for the list of valid types.  You may also pass external payment methods.
    *  - Example: ["card", "external_paypal", "klarna"]
-   *  - Note: If you omit payment methods from this list, they’ll be automatically ordered by Stripe after the ones you provide. Invalid payment methods are ignored.
+   *  - Note: If you omit payment methods from this list, they'll be automatically ordered by Stripe after the ones you provide. Invalid payment methods are ignored.
    */
   paymentMethodOrder?: Array<String>;
   /** This is an experimental feature that may be removed at any time.
@@ -112,9 +113,30 @@ export type SetupParamsBase = IntentParams & {
   };
 };
 
+/**
+ * Parameters for initializing PaymentSheet from a Checkout Session.
+ * Use when you have called `useCheckout` and the state is `loaded`.
+ * @checkoutSessionsPreview
+ * @internal
+ */
+export type CheckoutSetupParams = {
+  /** A fully loaded Checkout instance whose `state.status` is `'loaded'`. */
+  checkout: Checkout;
+  paymentIntentClientSecret?: never;
+  setupIntentClientSecret?: never;
+  intentConfiguration?: never;
+  customerEphemeralKeySecret?: never;
+  customerSessionClientSecret?: never;
+} & Omit<
+  SetupParamsBase,
+  | 'paymentIntentClientSecret'
+  | 'setupIntentClientSecret'
+  | 'intentConfiguration'
+>;
+
 export type SetupParams =
   | (SetupParamsBase & {
-      /** A short-lived token that allows the SDK to access a Customer’s payment methods. */
+      /** A short-lived token that allows the SDK to access a Customer's payment methods. */
       customerEphemeralKeySecret: string;
       customerSessionClientSecret?: never;
     })
@@ -123,7 +145,8 @@ export type SetupParams =
       /** The client secret of this Customer Session. Used on the client to set up secure access to the given customer. */
       customerSessionClientSecret: string;
     })
-  | SetupParamsBase;
+  | SetupParamsBase
+  | CheckoutSetupParams;
 
 export type IntentParams =
   | {
@@ -406,7 +429,7 @@ export type PrimaryButtonColorConfig = {
   successTextColor?: ThemedColor;
 };
 
-/** A color that’s either a single hex or a light/dark pair */
+/** A color that's either a single hex or a light/dark pair */
 export type ThemedColor = string | { light: string; dark: string };
 
 /** Represents edge insets */
@@ -649,7 +672,7 @@ export type Mode = PaymentMode | SetupMode;
 export enum CaptureMethod {
   /** (Default) Stripe automatically captures funds when the customer authorizes the payment. */
   Automatic = 'Automatic',
-  /** Place a hold on the funds when the customer authorizes the payment, but don’t capture the funds until later. (Not all payment methods support this.) */
+  /** Place a hold on the funds when the customer authorizes the payment, but don't capture the funds until later. (Not all payment methods support this.) */
   Manual = 'Manual',
   /** Asynchronously capture funds when the customer authorizes the payment.
   - Note: Recommended over `CaptureMethod.Automatic` due to improved latency, but may require additional integration changes.

package/src/types/components/PaymentMethodMessagingElementComponent.tsx

@@ -25,9 +25,25 @@ export enum PaymentMethodMessagingElementStyle {
   Light = 'light',
 }
 
+export interface PaymentMethodMessagingElementFont {
+  /**
+   * The font used for the element text.
+   *
+   * On iOS, this should be the "PostScript name" found in Font Book after installing the font.
+   * On Android, this should be the name of the font file (containing only lowercase alphanumeric characters) in android/app/src/main/res/font
+   *
+   * @default The OS's system font
+   */
+  family?: string;
+  /** The font size for text in the element. This value is required to be greater than 0.
+   * @default The OS's default text size.
+   */
+  size?: number;
+}
+
 export interface PaymentMethodMessagingElementAppearance {
   /** Font settings for the element. */
-  font?: PaymentSheetTypes.FontConfig;
+  font?: PaymentMethodMessagingElementFont;
   /** The color used for the element text. */
   textColor?: PaymentSheetTypes.ThemedColor;
   /** The color used for the text that links to available BNPL plans. */

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.10.0'
+stripe_version = '~> 25.12.0'
 
 fabric_enabled = ENV['RCT_NEW_ARCH_ENABLED'] == '1'
 
@@ -17,13 +17,6 @@ Pod::Spec.new do |s|
   s.platforms    = { ios: '13.0' }
   s.source       = { git: 'https://github.com/stripe/stripe-react-native.git', tag: s.version.to_s }
 
-  s.source_files = 'ios/**/*.{h,m,mm,swift}'
-  s.exclude_files = [ 'ios/Tests/', 'ios/NewArch/' ]
-  # 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.
-  s.private_header_files = [ 'ios/StripeSdk.h', 'ios/StripeSwiftInterop.h' ]
-
   s.header_dir = 'stripe_react_native'
   s.pod_target_xcconfig = {
     'USE_HEADERMAP' => 'YES',
@@ -44,6 +37,12 @@ Pod::Spec.new do |s|
   end
 
   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' ]
+    # 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.
+    core.private_header_files = [ 'ios/StripeSdk.h', 'ios/StripeSwiftInterop.h' ]
     core.dependency 'React-Core'
     core.dependency 'Stripe', stripe_version
     core.dependency 'StripePaymentSheet', stripe_version
@@ -54,6 +53,7 @@ Pod::Spec.new do |s|
   end
 
   s.subspec 'Onramp' do |onramp|
+    onramp.source_files = [ 'ios/StripeOnrampSdk.h', 'ios/StripeOnrampSdk.mm' ]
     onramp.dependency 'stripe-react-native/Core'
     onramp.dependency 'StripeCryptoOnramp', stripe_version
   end

package/android/spotless.gradle

@@ -1,19 +0,0 @@
-apply plugin: 'com.diffplug.spotless'
-
-allprojects {
-    repositories {
-        google()
-        mavenCentral()
-    }
-}
-
-
-spotless {
-    kotlin {
-        target 'src/**/*.kt'
-        ktlint("1.5.0").setEditorConfigPath("$projectDir/../.editorconfig")
-        trimTrailingWhitespace()
-        indentWithSpaces()
-        endWithNewline()
-    }
-}

package/android/src/main/java/com/reactnativestripesdk/FakeOnrampSdkModule.kt

@@ -1,155 +0,0 @@
-package com.reactnativestripesdk
-
-import com.facebook.react.bridge.Promise
-import com.facebook.react.bridge.ReactApplicationContext
-import com.facebook.react.bridge.ReactMethod
-import com.facebook.react.bridge.ReadableMap
-import com.facebook.react.module.annotations.ReactModule
-import com.reactnativestripesdk.utils.createFailedError
-
-@ReactModule(name = NativeOnrampSdkModuleSpec.NAME)
-class FakeOnrampSdkModule(
-  reactContext: ReactApplicationContext,
-) : NativeOnrampSdkModuleSpec(reactContext) {
-  @ReactMethod
-  override fun initialise(
-    params: ReadableMap?,
-    promise: Promise?,
-  ) {
-    promise?.resolve(null)
-  }
-
-  @ReactMethod
-  override fun configureOnramp(
-    config: ReadableMap?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun hasLinkAccount(
-    email: String?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun registerLinkUser(
-    info: ReadableMap?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun registerWalletAddress(
-    walletAddress: String?,
-    network: String?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun attachKycInfo(
-    kycInfo: ReadableMap?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun updatePhoneNumber(
-    phone: String?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun verifyIdentity(promise: Promise?) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun presentKycInfoVerification(
-    updatedAddress: ReadableMap?,
-    promise: Promise,
-  ) {
-    promise.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun collectPaymentMethod(
-    paymentMethod: String?,
-    platformPayParams: ReadableMap?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun provideCheckoutClientSecret(clientSecret: String?) {
-    // No-op
-  }
-
-  @ReactMethod
-  override fun createCryptoPaymentToken(promise: Promise?) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun performCheckout(
-    onrampSessionId: String?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun onrampAuthorize(
-    linkAuthIntentId: String?,
-    promise: Promise?,
-  ) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun logout(promise: Promise?) {
-    promise?.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun getCryptoTokenDisplayData(
-    token: ReadableMap,
-    promise: Promise,
-  ) {
-    promise.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun authenticateUserWithToken(
-    token: String,
-    promise: Promise,
-  ) {
-    promise.resolveNotImplemented()
-  }
-
-  @ReactMethod
-  override fun addListener(eventType: String?) {}
-
-  @ReactMethod
-  override fun removeListeners(count: Double) {}
-
-  private fun Promise.resolveNotImplemented() {
-    this.resolve(
-      createFailedError(
-        NotImplementedError(
-          "To enable Onramp, add 'StripeSdk_includeOnramp=true' to gradle.properties.",
-        ),
-      ),
-    )
-  }
-}