@stripe/stripe-react-native 0.7.0 → 0.8.0

package/lib/module/types/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["index.ts"],"names":[],"mappings":"m0BAeA,4D,0BACA,sE,oCACA,sE,oCACA,oE,kCACA,kE,gCACA,oE,kCACA,8D,4BACA,qG,wDACA,uG,0DACA,mF,sCACA,+E,kCACA,sD,oBAiBA,iVACA,gC","sourcesContent":["import type {\n  ApplePayError,\n  CardActionError,\n  ConfirmPaymentError,\n  ConfirmSetupIntentError,\n  CreatePaymentMethodError,\n  CreateTokenError,\n  GooglePayError,\n  PaymentSheetError,\n  RetrievePaymentIntentError,\n  RetrieveSetupIntentError,\n  StripeError,\n  VerifyMicrodepositsError,\n  CollectBankAccountError,\n} from './Errors';\nimport * as ApplePay from './ApplePay';\nimport * as PaymentIntent from './PaymentIntent';\nimport * as PaymentMethod from './PaymentMethod';\nimport * as PaymentSheet from './PaymentSheet';\nimport * as SetupIntent from './SetupIntent';\nimport * as ThreeDSecure from './ThreeDSecure';\nimport * as GooglePay from './GooglePay';\nimport * as ApplePayButtonComponent from './components/ApplePayButtonComponent';\nimport * as AuBECSDebitFormComponent from './components/AuBECSDebitFormComponent';\nimport * as CardFieldInput from './components/CardFieldInput';\nimport * as CardFormView from './components/CardFormView';\nimport * as Token from './Token';\n\nexport {\n  ApplePay,\n  PaymentIntent,\n  PaymentMethod,\n  PaymentSheet,\n  SetupIntent,\n  ThreeDSecure,\n  GooglePay,\n  ApplePayButtonComponent,\n  AuBECSDebitFormComponent,\n  CardFieldInput,\n  CardFormView,\n  Token,\n};\n\nexport * from './Errors';\nexport { Address, BillingDetails } from './Common';\n\n/**\n * @ignore\n */\nexport type Dictionary<T> = {\n  [key: string]: T;\n};\n\nexport interface AppInfo {\n  name?: string;\n  partnerId?: string;\n  url?: string;\n  version?: string;\n}\n\nexport type CreatePaymentMethodResult =\n  | {\n      paymentMethod: PaymentMethod.Result;\n      error?: undefined;\n    }\n  | {\n      paymentMethod?: undefined;\n      error: StripeError<CreatePaymentMethodError>;\n    };\n\nexport type RetrievePaymentIntentResult =\n  | {\n      paymentIntent: PaymentIntent.Result;\n      error?: undefined;\n    }\n  | {\n      paymentIntent?: undefined;\n      error: StripeError<RetrievePaymentIntentError>;\n    };\n\nexport type RetrieveSetupIntentResult =\n  | {\n      setupIntent: SetupIntent.Result;\n      error?: undefined;\n    }\n  | {\n      setupIntent?: undefined;\n      error: StripeError<RetrieveSetupIntentError>;\n    };\n\nexport type ConfirmPaymentResult =\n  | {\n      paymentIntent: PaymentIntent.Result;\n      error?: undefined;\n    }\n  | {\n      paymentIntent?: undefined;\n      error: StripeError<ConfirmPaymentError>;\n    };\n\nexport type HandleNextActionResult =\n  | {\n      paymentIntent: PaymentIntent.Result;\n      error?: undefined;\n    }\n  | {\n      paymentIntent?: undefined;\n      error: StripeError<CardActionError>;\n    };\n\nexport type ConfirmSetupIntentResult =\n  | {\n      setupIntent: SetupIntent.Result;\n      error?: undefined;\n    }\n  | {\n      setupIntent?: undefined;\n      error: StripeError<ConfirmSetupIntentError>;\n    };\n\nexport type CreateTokenForCVCUpdateResult =\n  | {\n      tokenId: string;\n      error?: undefined;\n    }\n  | {\n      tokenId?: undefined;\n      error: StripeError<ConfirmSetupIntentError>;\n    };\n\nexport type InitPaymentSheetResult =\n  | {\n      paymentOption?: PaymentSheet.PaymentOption;\n      error?: undefined;\n    }\n  | {\n      paymentOption?: undefined;\n      error: StripeError<PaymentSheetError>;\n    };\n\nexport type PresentPaymentSheetResult =\n  | {\n      paymentOption?: undefined;\n      error?: undefined;\n    }\n  | {\n      paymentOption?: PaymentSheet.PaymentOption;\n      error?: undefined;\n    }\n  | {\n      paymentOption?: undefined;\n      error: StripeError<PaymentSheetError>;\n    };\n\nexport type CreateTokenResult =\n  | {\n      token: Token.Result;\n      error?: undefined;\n    }\n  | {\n      token?: undefined;\n      error: StripeError<CreateTokenError>;\n    };\n\nexport type ConfirmPaymentSheetPaymentResult = {\n  error?: StripeError<PaymentSheetError>;\n};\n\nexport type ApplePayResult =\n  | {\n      paymentMethod: PaymentMethod.Result;\n      error?: undefined;\n    }\n  | {\n      paymentMethod?: undefined;\n      error: StripeError<ApplePayError>;\n    };\n\nexport interface InitStripeParams {\n  publishableKey: string;\n  stripeAccountId?: string;\n  threeDSecureParams?: ThreeDSecure.ConfigurationParams;\n  merchantIdentifier?: string;\n  urlScheme?: string;\n  setReturnUrlSchemeOnAndroid?: boolean;\n}\n\nexport interface InitialiseParams extends InitStripeParams {\n  appInfo: AppInfo;\n}\n\nexport type GooglePayInitResult =\n  | {\n      error?: undefined;\n    }\n  | {\n      error: StripeError<GooglePayError>;\n    };\n\nexport type PayWithGooglePayResult =\n  | {\n      error?: undefined;\n    }\n  | {\n      error: StripeError<GooglePayError>;\n    };\n\nexport type CreateGooglePayPaymentMethodResult =\n  | {\n      paymentMethod: PaymentMethod.Result;\n      error?: undefined;\n    }\n  | {\n      paymentMethod?: undefined;\n      error: StripeError<GooglePayError>;\n    };\n\nexport type OpenApplePaySetupResult =\n  | {\n      error?: undefined;\n    }\n  | {\n      error: StripeError<ApplePayError>;\n    };\n\nexport type VerifyMicrodepositsParams =\n  | {\n      amounts: number[];\n      descriptorCode?: undefined;\n    }\n  | {\n      amounts?: undefined;\n      descriptorCode: string;\n    };\n\nexport type VerifyMicrodepositsForPaymentResult =\n  | {\n      paymentIntent: PaymentIntent.Result;\n      error?: undefined;\n    }\n  | {\n      paymentIntent?: undefined;\n      error: StripeError<VerifyMicrodepositsError>;\n    };\n\nexport type VerifyMicrodepositsForSetupResult =\n  | {\n      setupIntent: SetupIntent.Result;\n      error?: undefined;\n    }\n  | {\n      setupIntent?: undefined;\n      error: StripeError<VerifyMicrodepositsError>;\n    };\n\nexport type CollectBankAccountForPaymentResult =\n  | {\n      paymentIntent: PaymentIntent.Result;\n      error?: undefined;\n    }\n  | {\n      paymentIntent?: undefined;\n      error: StripeError<CollectBankAccountError>;\n    };\n\nexport type CollectBankAccountForSetupResult =\n  | {\n      setupIntent: SetupIntent.Result;\n      error?: undefined;\n    }\n  | {\n      setupIntent?: undefined;\n      error: StripeError<CollectBankAccountError>;\n    };\n"]}
+{"version":3,"sources":["index.ts"],"names":[],"mappings":"m0BAeA,4D,0BACA,sE,oCACA,sE,oCACA,oE,kCACA,kE,gCACA,oE,kCACA,8D,4BACA,qG,wDACA,uG,0DACA,mF,sCACA,+E,kCACA,sD,oBAiBA,iVACA,gC","sourcesContent":["import type {\n  ApplePayError,\n  CardActionError,\n  ConfirmPaymentError,\n  ConfirmSetupIntentError,\n  CreatePaymentMethodError,\n  CreateTokenError,\n  GooglePayError,\n  PaymentSheetError,\n  RetrievePaymentIntentError,\n  RetrieveSetupIntentError,\n  StripeError,\n  VerifyMicrodepositsError,\n  CollectBankAccountError,\n} from './Errors';\nimport * as ApplePay from './ApplePay';\nimport * as PaymentIntent from './PaymentIntent';\nimport * as PaymentMethod from './PaymentMethod';\nimport * as PaymentSheet from './PaymentSheet';\nimport * as SetupIntent from './SetupIntent';\nimport * as ThreeDSecure from './ThreeDSecure';\nimport * as GooglePay from './GooglePay';\nimport * as ApplePayButtonComponent from './components/ApplePayButtonComponent';\nimport * as AuBECSDebitFormComponent from './components/AuBECSDebitFormComponent';\nimport * as CardFieldInput from './components/CardFieldInput';\nimport * as CardFormView from './components/CardFormView';\nimport * as Token from './Token';\n\nexport {\n  ApplePay,\n  PaymentIntent,\n  PaymentMethod,\n  PaymentSheet,\n  SetupIntent,\n  ThreeDSecure,\n  GooglePay,\n  ApplePayButtonComponent,\n  AuBECSDebitFormComponent,\n  CardFieldInput,\n  CardFormView,\n  Token,\n};\n\nexport * from './Errors';\nexport { Address, BillingDetails } from './Common';\n\n/**\n * @ignore\n */\nexport type Dictionary<T> = {\n  [key: string]: T;\n};\n\nexport interface AppInfo {\n  name?: string;\n  partnerId?: string;\n  url?: string;\n  version?: string;\n}\n\nexport type CreatePaymentMethodResult =\n  | {\n      paymentMethod: PaymentMethod.Result;\n      error?: undefined;\n    }\n  | {\n      paymentMethod?: undefined;\n      error: StripeError<CreatePaymentMethodError>;\n    };\n\nexport type RetrievePaymentIntentResult =\n  | {\n      paymentIntent: PaymentIntent.Result;\n      error?: undefined;\n    }\n  | {\n      paymentIntent?: undefined;\n      error: StripeError<RetrievePaymentIntentError>;\n    };\n\nexport type RetrieveSetupIntentResult =\n  | {\n      setupIntent: SetupIntent.Result;\n      error?: undefined;\n    }\n  | {\n      setupIntent?: undefined;\n      error: StripeError<RetrieveSetupIntentError>;\n    };\n\nexport type ConfirmPaymentResult =\n  | {\n      paymentIntent: PaymentIntent.Result;\n      error?: undefined;\n    }\n  | {\n      paymentIntent?: undefined;\n      error: StripeError<ConfirmPaymentError>;\n    };\n\nexport type HandleNextActionResult =\n  | {\n      paymentIntent: PaymentIntent.Result;\n      error?: undefined;\n    }\n  | {\n      paymentIntent?: undefined;\n      error: StripeError<CardActionError>;\n    };\n\nexport type ConfirmSetupIntentResult =\n  | {\n      setupIntent: SetupIntent.Result;\n      error?: undefined;\n    }\n  | {\n      setupIntent?: undefined;\n      error: StripeError<ConfirmSetupIntentError>;\n    };\n\nexport type CreateTokenForCVCUpdateResult =\n  | {\n      tokenId: string;\n      error?: undefined;\n    }\n  | {\n      tokenId?: undefined;\n      error: StripeError<ConfirmSetupIntentError>;\n    };\n\nexport type InitPaymentSheetResult =\n  | {\n      paymentOption?: PaymentSheet.PaymentOption;\n      error?: undefined;\n    }\n  | {\n      paymentOption?: undefined;\n      error: StripeError<PaymentSheetError>;\n    };\n\nexport type PresentPaymentSheetResult =\n  | {\n      paymentOption?: undefined;\n      error?: undefined;\n    }\n  | {\n      paymentOption?: PaymentSheet.PaymentOption;\n      error?: undefined;\n    }\n  | {\n      paymentOption?: undefined;\n      error: StripeError<PaymentSheetError>;\n    };\n\nexport type CreateTokenResult =\n  | {\n      token: Token.Result;\n      error?: undefined;\n    }\n  | {\n      token?: undefined;\n      error: StripeError<CreateTokenError>;\n    };\n\nexport type ConfirmPaymentSheetPaymentResult = {\n  error?: StripeError<PaymentSheetError>;\n};\n\nexport type ApplePayResult =\n  | {\n      paymentMethod: PaymentMethod.Result;\n      error?: undefined;\n    }\n  | {\n      paymentMethod?: undefined;\n      error: StripeError<ApplePayError>;\n    };\n\nexport interface InitStripeParams {\n  publishableKey: string;\n  stripeAccountId?: string;\n  threeDSecureParams?: ThreeDSecure.ConfigurationParams;\n  merchantIdentifier?: string;\n  urlScheme?: string;\n  setReturnUrlSchemeOnAndroid?: boolean;\n}\n\nexport interface InitialiseParams extends InitStripeParams {\n  appInfo: AppInfo;\n}\n\nexport type GooglePayInitResult =\n  | {\n      error?: undefined;\n    }\n  | {\n      error: StripeError<GooglePayError>;\n    };\n\nexport type PayWithGooglePayResult =\n  | {\n      error?: undefined;\n    }\n  | {\n      error: StripeError<GooglePayError>;\n    };\n\nexport type CreateGooglePayPaymentMethodResult =\n  | {\n      paymentMethod: PaymentMethod.Result;\n      error?: undefined;\n    }\n  | {\n      paymentMethod?: undefined;\n      error: StripeError<GooglePayError>;\n    };\n\nexport type OpenApplePaySetupResult =\n  | {\n      error?: undefined;\n    }\n  | {\n      error: StripeError<ApplePayError>;\n    };\n\nexport type VerifyMicrodepositsParams =\n  | {\n      amounts: number[];\n      descriptorCode?: undefined;\n    }\n  | {\n      amounts?: undefined;\n      descriptorCode: string;\n    };\n\nexport type VerifyMicrodepositsForPaymentResult =\n  | {\n      paymentIntent: PaymentIntent.Result;\n      error?: undefined;\n    }\n  | {\n      paymentIntent?: undefined;\n      error: StripeError<VerifyMicrodepositsError>;\n    };\n\nexport type VerifyMicrodepositsForSetupResult =\n  | {\n      setupIntent: SetupIntent.Result;\n      error?: undefined;\n    }\n  | {\n      setupIntent?: undefined;\n      error: StripeError<VerifyMicrodepositsError>;\n    };\n\nexport type CollectBankAccountForPaymentResult =\n  | {\n      paymentIntent: PaymentIntent.Result;\n      error?: undefined;\n    }\n  | {\n      paymentIntent?: undefined;\n      error: StripeError<CollectBankAccountError>;\n    };\n\nexport type CollectBankAccountForSetupResult =\n  | {\n      setupIntent: SetupIntent.Result;\n      error?: undefined;\n    }\n  | {\n      setupIntent?: undefined;\n      error: StripeError<CollectBankAccountError>;\n    };\n\nexport type GooglePayCardToken = {\n  id: string;\n  cardLastFour: string;\n  network: number;\n  serviceProvider: number;\n  issuer: string;\n  status:\n    | 'TOKEN_STATE_NEEDS_IDENTITY_VERIFICATION'\n    | 'TOKEN_STATE_PENDING'\n    | 'TOKEN_STATE_SUSPENDED'\n    | 'TOKEN_STATE_ACTIVE'\n    | 'TOKEN_STATE_FELICA_PENDING_PROVISIONING'\n    | 'TOKEN_STATE_UNTOKENIZED';\n};\n\nexport type IsCardInWalletResult =\n  | {\n      isInWallet: boolean;\n      token?: GooglePayCardToken;\n      error?: undefined;\n    }\n  | {\n      isInWallet?: undefined;\n      token?: undefined;\n      error: StripeError<GooglePayError>;\n    };\n"]}

package/lib/typescript/src/NativeStripeSdk.d.ts

@@ -1,4 +1,4 @@
-import type { PaymentMethod, ApplePay, PaymentSheet, SetupIntent, InitialiseParams, CreatePaymentMethodResult, RetrievePaymentIntentResult, RetrieveSetupIntentResult, ConfirmPaymentResult, HandleNextActionResult, ConfirmSetupIntentResult, CreateTokenForCVCUpdateResult, InitPaymentSheetResult, PresentPaymentSheetResult, ConfirmPaymentSheetPaymentResult, ApplePayResult, CreateTokenResult, GooglePayInitResult, PayWithGooglePayResult, CreateGooglePayPaymentMethodResult, GooglePay, OpenApplePaySetupResult, Token, VerifyMicrodepositsParams } from './types';
+import type { PaymentMethod, ApplePay, PaymentSheet, SetupIntent, InitialiseParams, CreatePaymentMethodResult, RetrievePaymentIntentResult, RetrieveSetupIntentResult, ConfirmPaymentResult, HandleNextActionResult, ConfirmSetupIntentResult, CreateTokenForCVCUpdateResult, InitPaymentSheetResult, PresentPaymentSheetResult, ConfirmPaymentSheetPaymentResult, ApplePayResult, CreateTokenResult, GooglePayInitResult, PayWithGooglePayResult, CreateGooglePayPaymentMethodResult, GooglePay, OpenApplePaySetupResult, Token, VerifyMicrodepositsParams, IsCardInWalletResult } from './types';
 declare type NativeStripeSdkType = {
     initialise(params: InitialiseParams): Promise<void>;
     createPaymentMethod(params: PaymentMethod.CreateParams, options: PaymentMethod.CreateOptions): Promise<CreatePaymentMethodResult>;
@@ -27,6 +27,15 @@ declare type NativeStripeSdkType = {
     openApplePaySetup(): Promise<OpenApplePaySetupResult>;
     verifyMicrodeposits(isPaymentIntent: boolean, clientSecret: string, params: VerifyMicrodepositsParams): Promise<ConfirmSetupIntentResult | ConfirmPaymentResult>;
     collectBankAccount(isPaymentIntent: boolean, clientSecret: string, params: PaymentMethod.CollectBankAccountParams): Promise<ConfirmSetupIntentResult | ConfirmPaymentResult>;
+    getConstants(): {
+        API_VERSIONS: {
+            CORE: string;
+            ISSUING: string;
+        };
+    };
+    isCardInWallet(params: {
+        cardLastFour: string;
+    }): Promise<IsCardInWalletResult>;
 };
 declare const _default: NativeStripeSdkType;
 export default _default;

package/lib/typescript/src/components/AddToWalletButton.d.ts

@@ -0,0 +1,58 @@
+import { AccessibilityProps, StyleProp, ViewStyle, ImageSourcePropType } from 'react-native';
+import type { Token, CardActionError, StripeError, GooglePayCardToken } from '../types';
+/**
+ *  Add to wallet button component props
+ */
+export interface Props extends AccessibilityProps {
+    style?: StyleProp<ViewStyle>;
+    /** Sets the Apple Wallet/Google Pay button style. If the button is placed over a dark background, set this to 'onDarkBackground', otherwise set to 'onLightBackground'. */
+    iOSButtonStyle?: 'onDarkBackground' | 'onLightBackground';
+    /** The image asset to use as the Google Pay button. Downloadable from https://developers.google.com/pay/issuers/apis/push-provisioning/android/downloads/flutter/googlepay_flutter_buttons.zip */
+    androidAssetSource: ImageSourcePropType;
+    testID?: string;
+    /** Only set to `false` when shipping through TestFlight || App Store */
+    testEnv?: boolean;
+    /** Sets the card holder name (used only on iOS) */
+    cardHolderName: string;
+    /** Last 4 digits of the card. Required on Android. */
+    cardLastFour: string;
+    /** Sets the card holder name (used only on iOS) */
+    cardDescription?: string;
+    /** Optional, only used on iOS */
+    cardBrand?: Token.CardBrand;
+    token?: GooglePayCardToken | null;
+    /** Used by stripe to securely obtain card info of the card being provisioned. */
+    ephemeralKey: object;
+    /** Called when the flow completes. If the `error` field is `null`, then the card was successfully added to the user's native wallet. */
+    onComplete(result: {
+        error: StripeError<CardActionError> | null;
+    }): void;
+}
+/**
+ *  Add to wallet button
+ *
+ * @example
+ * ```ts
+ *  <AddToWalletButton
+ *    testEnv={true}
+ *    style={styles.myButtonStyle}
+ *    iOSButtonStyle="onLightBackground"
+ *    cardHolderName="David Wallace"
+ *    cardLastFour="4242"
+ *    cardBrand="Visa"
+ *    ephemeralKey={myEphemeralKey} // This object is retrieved from your server. See https://stripe.com/docs/issuing/cards/digital-wallets?platform=react-native#update-your-backend
+ *    onComplete={(error) => {
+ *      Alert.alert(
+ *        error ? error.code : 'Success',
+ *        error
+ *          ? error.message
+ *          : 'Card was successfully added to the wallet.'
+ *      );
+ *    }}
+ *  />
+ * ```
+ * @param __namedParameters Props
+ * @returns JSX.Element
+ * @category ReactComponents
+ */
+export declare function AddToWalletButton({ onComplete, ...props }: Props): JSX.Element;

package/lib/typescript/src/components/CardField.d.ts

@@ -8,7 +8,7 @@ export interface Props extends AccessibilityProps {
     style?: StyleProp<ViewStyle>;
     postalCodeEnabled?: boolean;
     cardStyle?: CardFieldInput.Styles;
-    placeholder?: CardFieldInput.Placeholders;
+    placeholders?: CardFieldInput.Placeholders;
     autofocus?: boolean;
     onCardChange?(card: CardFieldInput.Details): void;
     onBlur?(): void;

package/lib/typescript/src/components/CardForm.d.ts

@@ -8,7 +8,10 @@ export interface Props extends AccessibilityProps {
     style?: StyleProp<ViewStyle>;
     autofocus?: boolean;
     testID?: string;
+    /** All styles except backgroundColor are Android only */
     cardStyle?: CardFormView.Styles;
+    /** Android only */
+    placeholders?: CardFormView.Placeholders;
     onFormComplete?(card: CardFormView.Details): void;
     /**
      * WARNING: If set to `true` the full card number will be returned in the `onFormComplete` handler.

package/lib/typescript/src/functions.d.ts

@@ -1,4 +1,4 @@
-import { ApplePay, ApplePayError, ApplePayResult, ConfirmPaymentResult, ConfirmPaymentSheetPaymentResult, SetupIntent, PaymentIntent, ConfirmSetupIntentResult, CreatePaymentMethodResult, CreateTokenForCVCUpdateResult, CreateTokenResult, GooglePayInitResult, HandleNextActionResult, InitPaymentSheetResult, PaymentMethod, PaymentSheet, PayWithGooglePayResult, PresentPaymentSheetResult, RetrievePaymentIntentResult, RetrieveSetupIntentResult, StripeError, GooglePay, CreateGooglePayPaymentMethodResult, OpenApplePaySetupResult, Token, VerifyMicrodepositsParams, VerifyMicrodepositsForPaymentResult, VerifyMicrodepositsForSetupResult, CollectBankAccountForPaymentResult, CollectBankAccountForSetupResult } from './types';
+import { ApplePay, ApplePayError, ApplePayResult, ConfirmPaymentResult, ConfirmPaymentSheetPaymentResult, SetupIntent, PaymentIntent, ConfirmSetupIntentResult, CreatePaymentMethodResult, CreateTokenForCVCUpdateResult, CreateTokenResult, GooglePayInitResult, HandleNextActionResult, InitPaymentSheetResult, PaymentMethod, PaymentSheet, PayWithGooglePayResult, PresentPaymentSheetResult, RetrievePaymentIntentResult, RetrieveSetupIntentResult, StripeError, GooglePay, CreateGooglePayPaymentMethodResult, OpenApplePaySetupResult, Token, VerifyMicrodepositsParams, VerifyMicrodepositsForPaymentResult, VerifyMicrodepositsForSetupResult, CollectBankAccountForPaymentResult, CollectBankAccountForSetupResult, IsCardInWalletResult } from './types';
 export declare const createPaymentMethod: (params: PaymentMethod.CreateParams, options?: PaymentMethod.CreateOptions) => Promise<CreatePaymentMethodResult>;
 export declare const createToken: (params: Token.CreateParams) => Promise<CreateTokenResult>;
 export declare const retrievePaymentIntent: (clientSecret: string) => Promise<RetrievePaymentIntentResult>;
@@ -31,3 +31,12 @@ export declare const createGooglePayPaymentMethod: (params: GooglePay.CreatePaym
 export declare const openApplePaySetup: () => Promise<OpenApplePaySetupResult>;
 export declare const collectBankAccountForPayment: (clientSecret: string, params: PaymentMethod.CollectBankAccountParams) => Promise<CollectBankAccountForPaymentResult>;
 export declare const collectBankAccountForSetup: (clientSecret: string, params: PaymentMethod.CollectBankAccountParams) => Promise<CollectBankAccountForSetupResult>;
+export declare const isCardInWallet: (params: {
+    cardLastFour: string;
+}) => Promise<IsCardInWalletResult>;
+export declare const Constants: {
+    API_VERSIONS: {
+        CORE: string;
+        ISSUING: string;
+    };
+};

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

@@ -11,5 +11,6 @@ export { ApplePayButton, Props as ApplePayButtonProps, } from './components/Appl
 export { AuBECSDebitForm, Props as AuBECSDebitFormProps, } from './components/AuBECSDebitForm';
 export { StripeContainer, Props as StripeContainerProps, } from './components/StripeContainer';
 export { GooglePayButton, Props as GooglePayButtonProps, } from './components/GooglePayButton';
+export { AddToWalletButton, Props as AddToWalletButtonProps, } from './components/AddToWalletButton';
 export * from './functions';
 export * from './types/index';

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

@@ -7,7 +7,7 @@ export interface Result {
     liveMode: boolean;
     customerId: string;
     billingDetails: BillingDetails;
-    type: Type;
+    paymentMethodType: Type;
     AuBecsDebit: AuBecsDebitResult;
     BacsDebit: BacsDebitResult;
     Card: CardResult;
@@ -16,96 +16,138 @@ export interface Result {
     SepaDebit: SepaDebitResult;
     Sofort: SofortResult;
     Upi: UpiResult;
+    USBankAccount: USBankAccountResult;
 }
 export declare type CreateParams = CardParams | IdealParams | OxxoParams | P24Params | AlipayParams | GiropayParams | SepaParams | EpsParams | AuBecsDebitParams | SofortParams | GrabPayParams | FPXParams | AfterpayClearpayParams | KlarnaParams | BancontactParams | USBankAccountParams;
 export declare type ConfirmParams = CreateParams;
-export declare type CreateOptions = {};
+export declare type CreateOptions = {
+    setupFutureUsage?: FutureUsage;
+};
 export declare type ConfirmOptions = CreateOptions;
 export declare type ShippingDetails = BillingDetails;
-interface BaseParams {
-    billingDetails?: BillingDetails;
-}
-export declare type CardParams = (BaseParams & {
-    type: 'Card';
-    token?: string;
-    setupFutureUsage?: FutureUsage;
-}) | (BaseParams & {
-    type: 'Card';
-    paymentMethodId: string;
-    cvc?: string;
-});
-export interface IdealParams extends BaseParams {
-    type: 'Ideal';
-    bankName?: string;
-    setupFutureUsage?: FutureUsage;
+export declare type CardParams = {
+    paymentMethodType: 'Card';
+    paymentMethodData?: {
+        token?: string;
+        billingDetails?: BillingDetails;
+    };
+} | {
+    paymentMethodType: 'Card';
+    paymentMethodData: {
+        paymentMethodId: string;
+        cvc?: string;
+        billingDetails?: BillingDetails;
+    };
+};
+export interface IdealParams {
+    paymentMethodType: 'Ideal';
+    paymentMethodData?: {
+        bankName?: string;
+        billingDetails?: BillingDetails;
+    };
 }
 export interface FPXParams {
-    type: 'Fpx';
-    testOfflineBank?: boolean;
+    paymentMethodType: 'Fpx';
+    paymentMethodData?: {
+        testOfflineBank?: boolean;
+    };
 }
 export interface AlipayParams {
-    type: 'Alipay';
+    paymentMethodType: 'Alipay';
 }
-export interface OxxoParams extends Required<BaseParams> {
-    type: 'Oxxo';
+export interface OxxoParams {
+    paymentMethodType: 'Oxxo';
+    paymentMethodData: {
+        billingDetails: BillingDetails;
+    };
 }
-export interface SofortParams extends BaseParams {
-    type: 'Sofort';
-    country: string;
-    setupFutureUsage?: FutureUsage;
+export interface SofortParams {
+    paymentMethodType: 'Sofort';
+    paymentMethodData: {
+        country: string;
+        billingDetails: BillingDetails;
+    };
 }
-export interface GrabPayParams extends BaseParams {
-    type: 'GrabPay';
+export interface GrabPayParams {
+    paymentMethodType: 'GrabPay';
+    paymentMethodData?: {
+        billingDetails?: BillingDetails;
+    };
 }
-export interface BancontactParams extends Required<BaseParams> {
-    type: 'Bancontact';
-    setupFutureUsage?: FutureUsage;
+export interface BancontactParams {
+    paymentMethodType: 'Bancontact';
+    paymentMethodData: {
+        billingDetails: BillingDetails;
+    };
 }
-export interface SepaParams extends Required<BaseParams> {
-    type: 'SepaDebit';
-    iban: string;
-    setupFutureUsage?: FutureUsage;
+export interface SepaParams {
+    paymentMethodType: 'SepaDebit';
+    paymentMethodData: {
+        iban: string;
+        billingDetails: BillingDetails;
+    };
 }
-export interface GiropayParams extends Required<BaseParams> {
-    type: 'Giropay';
+export interface GiropayParams {
+    paymentMethodType: 'Giropay';
+    paymentMethodData: {
+        billingDetails: BillingDetails;
+    };
 }
-export interface AfterpayClearpayParams extends Required<BaseParams> {
-    type: 'AfterpayClearpay';
-    shippingDetails: ShippingDetails;
+export interface AfterpayClearpayParams {
+    paymentMethodType: 'AfterpayClearpay';
+    paymentMethodData: {
+        shippingDetails: ShippingDetails;
+        billingDetails: BillingDetails;
+    };
 }
 export declare type KlarnaParams = {
-    type: 'Klarna';
-    billingDetails: Pick<Required<BillingDetails>, 'email'> & {
-        address: Pick<Required<Address>, 'country'>;
-    } & BillingDetails;
+    paymentMethodType: 'Klarna';
+    paymentMethodData: {
+        billingDetails: Pick<Required<BillingDetails>, 'email'> & {
+            address: Pick<Required<Address>, 'country'>;
+        } & BillingDetails;
+    };
 };
-export interface EpsParams extends Required<BaseParams> {
-    type: 'Eps';
+export interface EpsParams {
+    paymentMethodType: 'Eps';
+    paymentMethodData: {
+        billingDetails: BillingDetails;
+    };
 }
-export interface P24Params extends Required<BaseParams> {
-    type: 'P24';
+export interface P24Params {
+    paymentMethodType: 'P24';
+    paymentMethodData: {
+        billingDetails: BillingDetails;
+    };
 }
-export interface WeChatPayParams extends BaseParams {
-    type: 'WeChatPay';
-    appId: string;
+export interface WeChatPayParams {
+    paymentMethodType: 'WeChatPay';
+    paymentMethodData: {
+        appId: string;
+        billingDetails?: BillingDetails;
+    };
 }
 export interface AuBecsDebitParams {
-    type: 'AuBecsDebit';
-    formDetails: FormDetails;
+    paymentMethodType: 'AuBecsDebit';
+    paymentMethodData: {
+        formDetails: FormDetails;
+    };
 }
-/** Before using this payment method type, ensure you have already collected the bank information
- * for this intent with `collectBankAccountForPayment`. Otherwise, you will need to pass in the bank account
- * details manually.*/
+/**
+ * If paymentMethodData is null, it is assumed that the bank account details have already been attached
+ * via `collectBankAccountForPayment` or `collectBankAccountForSetup`.
+ */
 export declare type USBankAccountParams = {
-    type: 'USBankAccount';
-    billingDetails?: Pick<Required<BillingDetails>, 'name'> & BillingDetails;
-    accountNumber?: string;
-    routingNumber?: string;
-    /** Defaults to Individual */
-    accountHolderType?: BankAcccountHolderType;
-    /** Defaults to Checking */
-    accountType?: BankAcccountType;
-    setupFutureUsage?: FutureUsage;
+    paymentMethodType: 'USBankAccount';
+    paymentMethodData?: {
+        billingDetails: Pick<Required<BillingDetails>, 'name'> & BillingDetails;
+        accountNumber: string;
+        routingNumber: string;
+        /** Defaults to Individual */
+        accountHolderType?: BankAcccountHolderType;
+        /** Defaults to Checking */
+        accountType?: BankAcccountType;
+    };
 };
 export interface AuBecsDebitResult {
     fingerprint?: string;
@@ -158,10 +200,11 @@ export declare type USBankAccountResult = {
 };
 export declare type Type = 'AfterpayClearpay' | 'Card' | 'Alipay' | 'GrabPay' | 'Ideal' | 'Fpx' | 'CardPresent' | 'SepaDebit' | 'AuBecsDebit' | 'BacsDebit' | 'Giropay' | 'P24' | 'Eps' | 'Bancontact' | 'Oxxo' | 'Sofort' | 'Upi' | 'USBankAccount' | 'Unknown';
 export declare type CollectBankAccountParams = {
-    type: 'USBankAccount';
-    billingDetails: {
-        name: string;
-        email?: string;
+    paymentMethodType: 'USBankAccount';
+    paymentMethodData: {
+        billingDetails: {
+            name: string;
+            email?: string;
+        };
     };
 };
-export {};

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

@@ -16,7 +16,7 @@ export interface Result {
     nextAction: NextAction | null;
 }
 export declare type ConfirmParams = PaymentMethod.CreateParams;
-export declare type ConfirmOptions = PaymentMethod.ConfirmOptions;
+export declare type ConfirmOptions = {};
 export declare type FutureUsage = 'Unknown' | 'None' | 'OnSession' | 'OffSession' | 'OneTime';
 export declare enum Status {
     Succeeded = "Succeeded",

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

@@ -57,7 +57,7 @@ export interface NativeProps {
         focusedField: FieldName | null;
     }>): void;
     cardStyle?: Styles;
-    placeholder?: Placeholders;
+    placeholders?: Placeholders;
 }
 export interface Methods {
     focus(): void;

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

@@ -20,6 +20,15 @@ export interface Details {
 }
 export interface Styles {
     backgroundColor?: string;
+    borderWidth?: number;
+    borderColor?: string;
+    borderRadius?: number;
+    textColor?: string;
+    fontSize?: number;
+    placeholderColor?: string;
+    cursorColor?: string;
+    textErrorColor?: string;
+    fontFamily?: string;
 }
 export interface Placeholders {
     number?: string;
@@ -34,6 +43,8 @@ export interface NativeProps {
     style?: StyleProp<ViewStyle>;
     autofocus?: boolean;
     cardStyle?: Styles;
+    /** Android only */
+    placeholders?: Placeholders;
     onFocusChange(event: NativeSyntheticEvent<{
         focusedField: FieldName | null;
     }>): void;

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

@@ -177,3 +177,20 @@ export declare type CollectBankAccountForSetupResult = {
     setupIntent?: undefined;
     error: StripeError<CollectBankAccountError>;
 };
+export declare type GooglePayCardToken = {
+    id: string;
+    cardLastFour: string;
+    network: number;
+    serviceProvider: number;
+    issuer: string;
+    status: 'TOKEN_STATE_NEEDS_IDENTITY_VERIFICATION' | 'TOKEN_STATE_PENDING' | 'TOKEN_STATE_SUSPENDED' | 'TOKEN_STATE_ACTIVE' | 'TOKEN_STATE_FELICA_PENDING_PROVISIONING' | 'TOKEN_STATE_UNTOKENIZED';
+};
+export declare type IsCardInWalletResult = {
+    isInWallet: boolean;
+    token?: GooglePayCardToken;
+    error?: undefined;
+} | {
+    isInWallet?: undefined;
+    token?: undefined;
+    error: StripeError<GooglePayError>;
+};

package/package.json

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

package/src/NativeStripeSdk.tsx

@@ -24,6 +24,7 @@ import type {
   OpenApplePaySetupResult,
   Token,
   VerifyMicrodepositsParams,
+  IsCardInWalletResult,
 } from './types';
 
 type NativeStripeSdkType = {
@@ -86,6 +87,10 @@ type NativeStripeSdkType = {
     clientSecret: string,
     params: PaymentMethod.CollectBankAccountParams
   ): Promise<ConfirmSetupIntentResult | ConfirmPaymentResult>;
+  getConstants(): { API_VERSIONS: { CORE: string; ISSUING: string } };
+  isCardInWallet(params: {
+    cardLastFour: string;
+  }): Promise<IsCardInWalletResult>;
 };
 
 const { StripeSdk } = NativeModules;

package/src/components/AddToWalletButton.tsx

@@ -0,0 +1,86 @@
+import React from 'react';
+import {
+  AccessibilityProps,
+  StyleProp,
+  ViewStyle,
+  requireNativeComponent,
+  NativeSyntheticEvent,
+  ImageSourcePropType,
+} from 'react-native';
+import type {
+  Token,
+  CardActionError,
+  StripeError,
+  GooglePayCardToken,
+} from '../types';
+
+const AddToWalletButtonNative =
+  requireNativeComponent<any>('AddToWalletButton');
+
+/**
+ *  Add to wallet button component props
+ */
+export interface Props extends AccessibilityProps {
+  style?: StyleProp<ViewStyle>;
+  /** Sets the Apple Wallet/Google Pay button style. If the button is placed over a dark background, set this to 'onDarkBackground', otherwise set to 'onLightBackground'. */
+  iOSButtonStyle?: 'onDarkBackground' | 'onLightBackground';
+  /** The image asset to use as the Google Pay button. Downloadable from https://developers.google.com/pay/issuers/apis/push-provisioning/android/downloads/flutter/googlepay_flutter_buttons.zip */
+  androidAssetSource: ImageSourcePropType;
+  testID?: string;
+  /** Only set to `false` when shipping through TestFlight || App Store */
+  testEnv?: boolean;
+  /** Sets the card holder name (used only on iOS) */
+  cardHolderName: string;
+  /** Last 4 digits of the card. Required on Android. */
+  cardLastFour: string;
+  /** Sets the card holder name (used only on iOS) */
+  cardDescription?: string;
+  /** Optional, only used on iOS */
+  cardBrand?: Token.CardBrand;
+  // Optional, only for Android and only for cards that are in the "yellow path" (as defined by Google- https://developers.google.com/pay/issuers/apis/push-provisioning/android/wallet-operations#resolving_yellow_path). Obtain this value via the `isCardInWallet` method.
+  token?: GooglePayCardToken | null;
+  /** Used by stripe to securely obtain card info of the card being provisioned. */
+  ephemeralKey: object;
+  /** Called when the flow completes. If the `error` field is `null`, then the card was successfully added to the user's native wallet. */
+  onComplete(result: { error: StripeError<CardActionError> | null }): void;
+}
+
+/**
+ *  Add to wallet button
+ *
+ * @example
+ * ```ts
+ *  <AddToWalletButton
+ *    testEnv={true}
+ *    style={styles.myButtonStyle}
+ *    iOSButtonStyle="onLightBackground"
+ *    cardHolderName="David Wallace"
+ *    cardLastFour="4242"
+ *    cardBrand="Visa"
+ *    ephemeralKey={myEphemeralKey} // This object is retrieved from your server. See https://stripe.com/docs/issuing/cards/digital-wallets?platform=react-native#update-your-backend
+ *    onComplete={(error) => {
+ *      Alert.alert(
+ *        error ? error.code : 'Success',
+ *        error
+ *          ? error.message
+ *          : 'Card was successfully added to the wallet.'
+ *      );
+ *    }}
+ *  />
+ * ```
+ * @param __namedParameters Props
+ * @returns JSX.Element
+ * @category ReactComponents
+ */
+export function AddToWalletButton({ onComplete, ...props }: Props) {
+  return (
+    <AddToWalletButtonNative
+      {...props}
+      onCompleteAction={(
+        value: NativeSyntheticEvent<{
+          error: StripeError<CardActionError> | null;
+        }>
+      ) => onComplete(value.nativeEvent)}
+    />
+  );
+}

package/src/components/CardField.tsx

@@ -32,7 +32,7 @@ export interface Props extends AccessibilityProps {
   style?: StyleProp<ViewStyle>;
   postalCodeEnabled?: boolean;
   cardStyle?: CardFieldInput.Styles;
-  placeholder?: CardFieldInput.Placeholders;
+  placeholders?: CardFieldInput.Placeholders;
   autofocus?: boolean;
   onCardChange?(card: CardFieldInput.Details): void;
   onBlur?(): void;
@@ -72,7 +72,7 @@ export const CardField = forwardRef<CardFieldInput.Methods, Props>(
       onFocus,
       onBlur,
       cardStyle,
-      placeholder,
+      placeholders,
       postalCodeEnabled,
       ...props
     },
@@ -186,11 +186,11 @@ export const CardField = forwardRef<CardFieldInput.Methods, Props>(
           textErrorColor: cardStyle?.textErrorColor,
           fontFamily: cardStyle?.fontFamily,
         }}
-        placeholder={{
-          number: placeholder?.number,
-          expiration: placeholder?.expiration,
-          cvc: placeholder?.cvc,
-          postalCode: placeholder?.postalCode,
+        placeholders={{
+          number: placeholders?.number,
+          expiration: placeholders?.expiration,
+          cvc: placeholders?.cvc,
+          postalCode: placeholders?.postalCode,
         }}
         {...props}
       />