@stripe/stripe-react-native 0.28.0 → 0.30.0

package/lib/typescript/src/types/PaymentSheet.d.ts

@@ -1,7 +1,10 @@
 import type { BillingDetails, AddressDetails } from './Common';
 import type { CartSummaryItem } from './ApplePay';
 import type { ButtonType, RecurringPaymentRequest, AutomaticReloadPaymentRequest, MultiMerchantRequest } from './PlatformPay';
-export declare type SetupParams = ClientSecretParams & {
+import type { FutureUsage } from './PaymentIntent';
+import type { Result } from './PaymentMethod';
+import type { StripeError } from './Errors';
+export declare type SetupParams = IntentParams & {
     /** Your customer-facing business name. On Android, this is required and cannot be an empty string. */
     merchantDisplayName: string;
     /** The identifier of the Stripe Customer object. See https://stripe.com/docs/api/customers/object#customer_object-id */
@@ -42,12 +45,18 @@ export declare type SetupParams = ClientSecretParams & {
     /** The label to use for the primary button. If not set, Payment Sheet will display suitable default labels for payment and setup intents. */
     primaryButtonLabel?: string;
 };
-export declare type ClientSecretParams = {
+export declare type IntentParams = {
     paymentIntentClientSecret: string;
     setupIntentClientSecret?: undefined;
+    intentConfiguration?: never;
 } | {
     setupIntentClientSecret: string;
     paymentIntentClientSecret?: undefined;
+    intentConfiguration?: never;
+} | {
+    setupIntentClientSecret?: never;
+    paymentIntentClientSecret?: never;
+    intentConfiguration: IntentConfiguration;
 };
 export declare type ApplePayParams = {
     /** The two-letter ISO 3166 code of the country of your business, e.g. "US"  */
@@ -264,4 +273,41 @@ export declare enum AddressCollectionMode {
     /** Collect the full billing address, regardless of the Payment Method's requirements. */
     FULL = "full"
 }
+export declare type IntentCreationError = StripeError<'Failed'>;
+export declare type IntentCreationCallbackParams = {
+    clientSecret: string;
+    error?: never;
+} | {
+    clientSecret?: never;
+    error: IntentCreationError;
+};
+export declare type IntentConfiguration = {
+    confirmHandler: (paymentMethod: Result, shouldSavePaymentMethod: boolean, intentCreationCallback: (result: IntentCreationCallbackParams) => void) => void;
+    mode: Mode;
+    paymentMethodTypes?: Array<string>;
+};
+export declare type Mode = PaymentMode | SetupMode;
+/**
+ * Controls when the funds will be captured. Seealso: https://stripe.com/docs/api/payment_intents/create#create_payment_intent-capture_method
+ */
+export declare 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.) */
+    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.
+    - Seealso: https://stripe.com/docs/payments/payment-intents/asynchronous-capture-automatic-async */
+    AutomaticAsync = "AutomaticAsync"
+}
+export declare type PaymentMode = {
+    amount: number;
+    currencyCode: string;
+    setupFutureUsage?: FutureUsage;
+    captureMethod?: CaptureMethod;
+};
+export declare type SetupMode = {
+    currencyCode?: string;
+    setupFutureUsage: FutureUsage;
+};
 export {};

package/lib/typescript/src/types/PlatformPay.d.ts

@@ -3,8 +3,6 @@ import type { Result as PaymentMethod } from './PaymentMethod';
 import type { Result as PaymentIntent } from './PaymentIntent';
 import type { Result as SetupIntent } from './SetupIntent';
 import type { StripeError, PlatformPayError } from './Errors';
-import type { ShippingContact as ApplePayShippingContact } from './ApplePay';
-import type { IsSupportedParams } from './GooglePay';
 export declare type ApplePaySheetError = {
     errorType: ApplePaySheetErrorType.InvalidShippingAddress;
     field: InvalidShippingField;
@@ -319,10 +317,41 @@ export declare type ShippingMethod = {
     /** The unix timestamp of the end date of the expected range of delivery or shipping dates for a package, or the time range when an item is available for pickup. Measured in seconds. */
     endDate?: number;
 };
+interface PostalAddress {
+    city?: string;
+    country?: string;
+    postalCode?: string;
+    state?: string;
+    street?: string;
+    isoCountryCode?: string;
+    subAdministrativeArea?: string;
+    subLocality?: string;
+}
+interface ContactName {
+    familyName?: string;
+    namePrefix?: string;
+    nameSuffix?: string;
+    givenName?: string;
+    middleName?: string;
+    nickname?: string;
+}
 /** iOS only. */
-export declare type ShippingContact = ApplePayShippingContact;
+export interface ShippingContact {
+    emailAddress?: string;
+    name: ContactName;
+    phoneNumber?: string;
+    postalAddress: PostalAddress;
+}
 /** Android only. */
-export declare type IsGooglePaySupportedParams = IsSupportedParams;
+export declare type IsGooglePaySupportedParams = {
+    /** Set to true to run in a test environment with relaxed application / merchant requirements. This environment is suggested for early development and for easily testing SDK. Defaults to false. */
+    testEnv?: boolean;
+    /**
+     * If `true`, Google Pay is considered ready if the customer's Google Pay wallet
+     * has an existing payment method. Defaults to false.
+     */
+    existingPaymentMethodRequired?: boolean;
+};
 export declare type PaymentMethodResult = {
     paymentMethod: PaymentMethod;
     error?: undefined;
@@ -351,3 +380,4 @@ export declare type ConfirmSetupIntentResult = {
     setupIntent?: undefined;
     error: StripeError<PlatformPayError>;
 };
+export {};

package/lib/typescript/src/types/PushProvisioning.d.ts

@@ -1,11 +1,19 @@
 import type { StripeError, GooglePayError } from './Errors';
 export declare type GooglePayCardToken = {
+    /** The token reference ID. */
     id: string;
-    cardLastFour: string;
+    /** Last four digits of the FPAN */
+    fpanLastFour: string;
+    /** Last four digits of the DPAN */
+    dpanLastFour: string;
     network: number;
     serviceProvider: number;
+    /** The name of the issuer. */
     issuer: string;
+    /** The GooglePayCardTokenStatus. */
     status: GooglePayCardTokenStatus;
+    /** Deprecated. Use fpanLastFour or dpanLastFour. */
+    cardLastFour: string;
 };
 export declare enum GooglePayCardTokenStatus {
     /**  */

package/lib/typescript/src/types/components/GooglePayButtonComponent.d.ts

@@ -2,5 +2,4 @@ import type { StyleProp, ViewStyle } from 'react-native';
 export interface NativeProps {
     style?: StyleProp<ViewStyle>;
     type?: number;
-    buttonType?: string;
 }

package/lib/typescript/src/types/index.d.ts

@@ -5,16 +5,13 @@ import * as PaymentMethod from './PaymentMethod';
 import * as PaymentSheet from './PaymentSheet';
 import * as SetupIntent from './SetupIntent';
 import * as ThreeDSecure from './ThreeDSecure';
-import * as GooglePay from './GooglePay';
-import * as ApplePayButtonComponent from './components/ApplePayButtonComponent';
-import * as GooglePayButtonComponent from './components/GooglePayButtonComponent';
 import * as AuBECSDebitFormComponent from './components/AuBECSDebitFormComponent';
 import * as CardFieldInput from './components/CardFieldInput';
 import * as CardFormView from './components/CardFormView';
 import * as Token from './Token';
 import * as FinancialConnections from './FinancialConnections';
 import * as PlatformPay from './PlatformPay';
-export { ApplePay, PaymentIntent, PaymentMethod, PaymentSheet, SetupIntent, ThreeDSecure, GooglePay, ApplePayButtonComponent, GooglePayButtonComponent, AuBECSDebitFormComponent, CardFieldInput, CardFormView, Token, FinancialConnections, PlatformPay, };
+export { ApplePay, PaymentIntent, PaymentMethod, PaymentSheet, SetupIntent, ThreeDSecure, AuBECSDebitFormComponent, CardFieldInput, CardFormView, Token, FinancialConnections, PlatformPay, };
 export * from './PushProvisioning';
 export * from './Errors';
 export type { Address, BillingDetails, AddressDetails } from './Common';
@@ -65,6 +62,13 @@ export declare type HandleNextActionResult = {
     paymentIntent?: undefined;
     error: StripeError<CardActionError>;
 };
+export declare type HandleNextActionForSetupResult = {
+    setupIntent: SetupIntent.Result;
+    error?: undefined;
+} | {
+    setupIntent?: undefined;
+    error: StripeError<CardActionError>;
+};
 export declare type ConfirmSetupIntentResult = {
     setupIntent: SetupIntent.Result;
     error?: undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stripe/stripe-react-native",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "author": "Stripe",
   "description": "Stripe SDK for React Native",
   "main": "lib/commonjs/index",

package/src/NativeStripeSdk.tsx

@@ -2,7 +2,6 @@ import { NativeModules } from 'react-native';
 import type {
   PaymentMethod,
   PaymentIntent,
-  ApplePay,
   PlatformPay,
   PaymentSheet,
   SetupIntent,
@@ -12,17 +11,13 @@ import type {
   RetrieveSetupIntentResult,
   ConfirmPaymentResult,
   HandleNextActionResult,
+  HandleNextActionForSetupResult,
   ConfirmSetupIntentResult,
   CreateTokenForCVCUpdateResult,
   InitPaymentSheetResult,
   PresentPaymentSheetResult,
   ConfirmPaymentSheetPaymentResult,
-  ApplePayResult,
   CreateTokenResult,
-  GooglePayInitResult,
-  PayWithGooglePayResult,
-  CreateGooglePayPaymentMethodResult,
-  GooglePay,
   OpenApplePaySetupResult,
   Token,
   VerifyMicrodepositsParams,
@@ -42,21 +37,15 @@ type NativeStripeSdkType = {
     paymentIntentClientSecret: string,
     returnURL?: string | null
   ): Promise<HandleNextActionResult>;
+  handleNextActionForSetup(
+    setupIntentClientSecret: string,
+    returnURL?: string | null
+  ): Promise<HandleNextActionForSetupResult>;
   confirmPayment(
     paymentIntentClientSecret: string,
     params?: PaymentIntent.ConfirmParams,
     options?: PaymentIntent.ConfirmOptions
   ): Promise<ConfirmPaymentResult>;
-  isApplePaySupported(): Promise<boolean>;
-  presentApplePay(params: ApplePay.PresentParams): Promise<ApplePayResult>;
-  confirmApplePayPayment(clientSecret: string): Promise<void>;
-  updateApplePaySummaryItems(
-    summaryItems: ApplePay.CartSummaryItem[],
-    errorAddressFields: Array<{
-      field: ApplePay.AddressFields;
-      message?: string;
-    }>
-  ): Promise<void>;
   confirmSetupIntent(
     paymentIntentClientSecret: string,
     params: SetupIntent.ConfirmParams,
@@ -69,10 +58,9 @@ type NativeStripeSdkType = {
   initPaymentSheet(
     params: PaymentSheet.SetupParams
   ): Promise<InitPaymentSheetResult>;
-  initPaymentSheetWithOrderTracking(
-    params: PaymentSheet.SetupParams,
-    callback?: () => void
-  ): Promise<InitPaymentSheetResult>;
+  intentCreationCallback(
+    result: PaymentSheet.IntentCreationCallbackParams
+  ): void;
   presentPaymentSheet(
     options: PaymentSheet.PresentOptions
   ): Promise<PresentPaymentSheetResult>;
@@ -80,14 +68,6 @@ type NativeStripeSdkType = {
   createTokenForCVCUpdate(cvc: string): Promise<CreateTokenForCVCUpdateResult>;
   handleURLCallback(url: string): Promise<boolean>;
   createToken(params: Token.CreateParams): Promise<CreateTokenResult>;
-  isGooglePaySupported(params: GooglePay.IsSupportedParams): Promise<boolean>;
-  initGooglePay(params: GooglePay.InitParams): Promise<GooglePayInitResult>;
-  presentGooglePay(
-    params: GooglePay.PresentParams
-  ): Promise<PayWithGooglePayResult>;
-  createGooglePayPaymentMethod(
-    params: GooglePay.CreatePaymentMethodParams
-  ): Promise<CreateGooglePayPaymentMethodResult>;
   openApplePaySetup(): Promise<OpenApplePaySetupResult>;
   verifyMicrodeposits(
     isPaymentIntent: boolean,
@@ -114,7 +94,7 @@ type NativeStripeSdkType = {
   ): Promise<FinancialConnections.SessionResult>;
   resetPaymentSheetCustomer(): Promise<null>;
   isPlatformPaySupported(params: {
-    googlePay?: GooglePay.IsSupportedParams;
+    googlePay?: PlatformPay.IsGooglePaySupportedParams;
   }): Promise<boolean>;
   createPlatformPayPaymentMethod(
     params: PlatformPay.PaymentMethodParams,
@@ -122,8 +102,8 @@ type NativeStripeSdkType = {
   ): Promise<PlatformPay.PaymentMethodResult | PlatformPay.TokenResult>;
   dismissPlatformPay(): Promise<boolean>;
   updatePlatformPaySheet(
-    summaryItems: Array<ApplePay.CartSummaryItem>,
-    shippingMethods: Array<ApplePay.ShippingMethod>,
+    summaryItems: Array<PlatformPay.CartSummaryItem>,
+    shippingMethods: Array<PlatformPay.ShippingMethod>,
     errors: Array<PlatformPay.ApplePaySheetError>
   ): Promise<void>;
   confirmPlatformPay(

package/src/components/ApplePayButtonNative.tsx

@@ -1,5 +1,5 @@
 import { requireNativeComponent } from 'react-native';
-import type { ApplePayButtonComponent } from '../types';
+import type * as ApplePayButtonComponent from '../types/components/ApplePayButtonComponent';
 const ApplePayButtonNative =
   requireNativeComponent<ApplePayButtonComponent.NativeProps>('ApplePayButton');
 export default ApplePayButtonNative;

package/src/components/GooglePayButtonNative.tsx

@@ -1,5 +1,5 @@
 import { requireNativeComponent } from 'react-native';
-import type { GooglePayButtonComponent } from '../types';
+import type * as GooglePayButtonComponent from '../types/components/GooglePayButtonComponent';
 const GooglePayButtonNative =
   requireNativeComponent<GooglePayButtonComponent.NativeProps>(
     'GooglePayButton'