@stripe/stripe-react-native 0.2.4 → 0.5.0

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

@@ -17,7 +17,7 @@ export interface PaymentMethod {
     Upi: PaymentMethods.Upi;
 }
 export declare namespace PaymentMethodCreateParams {
-    type Params = CardParams | IdealParams | OxxoParams | P24Params | AlipayParams | GiropayParams | SepaParams | EpsParams | AuBecsDebitParams | SofortParams | GrabPayParams | FPXParams | AfterpayClearpayParams | BancontactParams;
+    type Params = CardParams | IdealParams | OxxoParams | P24Params | AlipayParams | GiropayParams | SepaParams | EpsParams | AuBecsDebitParams | SofortParams | GrabPayParams | FPXParams | AfterpayClearpayParams | KlarnaParams | BancontactParams;
     type BillingDetails = {
         email?: string;
         name?: string;
@@ -91,6 +91,10 @@ export declare namespace PaymentMethodCreateParams {
         type: 'AfterpayClearpay';
         shippingDetails: ShippingDetails;
     }
+    type KlarnaParams = {
+        type: 'Klarna';
+        billingDetails: Pick<Required<BillingDetails>, 'email' | 'addressCountry'> & BillingDetails;
+    };
     interface EpsParams extends Required<BaseParams> {
         type: 'Eps';
     }

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

@@ -62,7 +62,7 @@ export declare type ConfirmPaymentResult = {
     paymentIntent?: undefined;
     error: StripeError<ConfirmPaymentError>;
 };
-export declare type HandleCardActionResult = {
+export declare type HandleNextActionResult = {
     paymentIntent: PaymentIntent;
     error?: undefined;
 } | {
@@ -119,10 +119,14 @@ export declare type ApplePayResult = {
 };
 export interface InitStripeParams {
     publishableKey: string;
-    stripeAccountId?: string;
-    threeDSecureParams?: ThreeDSecureConfigurationParams;
     merchantIdentifier?: string;
+    threeDSecureParams?: ThreeDSecureConfigurationParams;
+    stripeAccountId?: string;
     urlScheme?: string;
+    setReturnUrlSchemeOnAndroid?: boolean;
+    /**
+     * @deprecated Use setReturnUrlSchemeOnAndroid instead
+     */
     setUrlSchemeOnAndroid?: boolean;
 }
 export interface InitialiseParams extends InitStripeParams {
@@ -155,6 +159,7 @@ export declare type CreateTokenCardParams = {
     type: 'Card';
     address?: Card.Address;
     name?: string;
+    currency?: string;
 };
 export declare type BankAcccountHolderType = 'Company' | 'Individual';
 export declare type CreateTokenBankAccountParams = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stripe/stripe-react-native",
-  "version": "0.2.4",
+  "version": "0.5.0",
   "author": "Stripe",
   "description": "Stripe SDK for React Native",
   "main": "lib/commonjs/index",
@@ -21,17 +21,18 @@
   "scripts": {
     "test": "jest",
     "typescript": "tsc --noEmit",
-    "lint": "eslint \"**/*.{js,ts,tsx}\" --ignore-pattern \"docs/api-reference/*\"",
+    "lint": "eslint \"**/*.{js,ts,tsx}\" --ignore-pattern \"docs/api-reference/*\" --ignore-pattern example/android/stripe-android",
     "prepare": "bob build",
     "release": "./scripts/publish",
     "example": "yarn --cwd example",
     "pods": "cd example && pod-install --quiet",
     "bootstrap": "yarn example && yarn && yarn pods",
-    "docs": "yarn typedoc ./src/index.tsx --out ./docs/api-reference --tsconfig ./tsconfig.json --theme minimal --theme ./docs/stripe-theme",
+    "bootstrap-no-pods": "yarn example && yarn",
+    "docs": "yarn typedoc ./src/index.tsx --out ./docs/api-reference --tsconfig ./tsconfig.json --readme none",
     "run-example-ios": "cd example;ENVFILE=.env.ci react-native run-ios --configuration Release --simulator \"iPhone 12\"",
     "run-example-android": "cd example;ENVFILE=.env.ci react-native run-android --variant=release",
-    "test:ios": "node ./run-appium-tests.js ios",
-    "test:android": "node ./run-appium-tests.js android"
+    "test:ios": "mkdir -p .tmp/screenshots && node ./run-appium-tests.js ios",
+    "test:android": "mkdir -p .tmp/screenshots && node ./run-appium-tests.js android"
   },
   "keywords": [
     "react-native",
@@ -46,24 +47,19 @@
   "homepage": "https://github.com/stripe/stripe-react-native/#readme",
   "devDependencies": {
     "@babel/plugin-transform-typescript": "^7.13.0",
-    "@commitlint/config-conventional": "^8.3.4",
     "@react-native-community/bob": "^0.16.2",
     "@react-native-community/eslint-config": "^2.0.0",
-    "@release-it/conventional-changelog": "^1.1.4",
     "@types/jest": "^26.0.23",
     "@types/react": "^16.9.19",
     "@types/react-native": "0.62.13",
-    "@types/webdriverio": "^5.0.0",
     "@wdio/appium-service": "^7.5.7",
-    "@wdio/cli": "^7.5.7",
-    "@wdio/local-runner": "^7.5.7",
-    "@wdio/mocha-framework": "^7.5.3",
-    "@wdio/spec-reporter": "^7.5.7",
-    "@wdio/sync": "^7.5.7",
+    "@wdio/cli": "^7.16.15",
+    "@wdio/local-runner": "^7.16.15",
+    "@wdio/mocha-framework": "^7.16.15",
+    "@wdio/spec-reporter": "^7.16.14",
+    "@wdio/sync": "^7.16.15",
     "appium": "^1.22.1",
     "appium-chromedriver": "4.26.2",
-    "appium-doctor": "^1.16.0",
-    "commitlint": "^8.3.5",
     "eslint": "^7.14.0",
     "eslint-config-prettier": "^6.11.0",
     "eslint-plugin-prettier": "^3.1.3",
@@ -76,13 +72,11 @@
     "prettier": "^2.0.5",
     "react": "17.0.2",
     "react-native": "0.66.4",
-    "release-it": "^13.5.8",
     "ts-node": "^9.1.1",
-    "typedoc": "^0.21.5",
-    "typescript": "^4.2.3",
+    "typedoc": "^0.22.12",
+    "typescript": "~4.2.3",
     "wdio-chromedriver-service": "^7.0.0",
-    "wdio-native-app-compare-service": "^1.2.0",
-    "webdriverio": "^7.5.7"
+    "webdriverio": "^7.16.15"
   },
   "peerDependencies": {
     "react": "*",
@@ -98,15 +92,9 @@
   },
   "husky": {
     "hooks": {
-      "commit-msg": "commitlint -E HUSKY_GIT_PARAMS",
       "pre-commit": "yarn lint && yarn typescript"
     }
   },
-  "commitlint": {
-    "extends": [
-      "@commitlint/config-conventional"
-    ]
-  },
   "eslintConfig": {
     "extends": [
       "@react-native-community",

package/src/NativeStripeSdk.tsx

@@ -9,7 +9,7 @@ import type {
   RetrievePaymentIntentResult,
   RetrieveSetupIntentResult,
   ConfirmPaymentResult,
-  HandleCardActionResult,
+  HandleNextActionResult,
   ConfirmSetupIntentResult,
   CreateTokenForCVCUpdateResult,
   InitPaymentSheetResult,
@@ -31,9 +31,9 @@ type NativeStripeSdkType = {
     data: PaymentMethodCreateParams.Params,
     options: PaymentMethodCreateParams.Options
   ): Promise<CreatePaymentMethodResult>;
-  handleCardAction(
+  handleNextAction(
     paymentIntentClientSecret: string
-  ): Promise<HandleCardActionResult>;
+  ): Promise<HandleNextActionResult>;
   confirmPayment(
     paymentIntentClientSecret: string,
     data: PaymentMethodCreateParams.Params,
@@ -66,6 +66,9 @@ type NativeStripeSdkType = {
   createTokenForCVCUpdate(cvc: string): Promise<CreateTokenForCVCUpdateResult>;
   handleURLCallback(url: string): Promise<boolean>;
   createToken(params: CreateTokenParams): Promise<CreateTokenResult>;
+  isGooglePaySupported(
+    params: GooglePay.IsGooglePaySupportedParams
+  ): Promise<boolean>;
   initGooglePay(params: GooglePay.InitParams): Promise<GooglePayInitResult>;
   presentGooglePay(
     params: GooglePay.PresentGooglePayParams

package/src/components/StripeProvider.tsx

@@ -2,12 +2,7 @@ import React, { useEffect } from 'react';
 
 import NativeStripeSdk from '../NativeStripeSdk';
 import { isAndroid, shouldAttributeExpo } from '../helpers';
-import type {
-  AppInfo,
-  ThreeDSecureConfigurationParams,
-  InitStripeParams,
-  InitialiseParams,
-} from '../types';
+import type { AppInfo, InitStripeParams, InitialiseParams } from '../types';
 import pjson from '../../package.json';
 
 const EXPO_PARTNER_ID = 'pp_partner_JBN7LkABco2yUu';
@@ -15,15 +10,9 @@ const EXPO_PARTNER_ID = 'pp_partner_JBN7LkABco2yUu';
 /**
  *  Stripe Provider Component Props
  */
-export interface Props {
-  publishableKey: string;
-  merchantIdentifier?: string;
-  threeDSecureParams?: ThreeDSecureConfigurationParams;
-  stripeAccountId?: string;
+export type Props = InitStripeParams & {
   children: React.ReactElement | React.ReactElement[];
-  urlScheme?: string;
-  setUrlSchemeOnAndroid?: boolean;
-}
+};
 
 const repository: any = pjson.repository;
 
@@ -69,6 +58,7 @@ export function StripeProvider({
   threeDSecureParams,
   stripeAccountId,
   urlScheme,
+  setReturnUrlSchemeOnAndroid,
   setUrlSchemeOnAndroid,
 }: Props) {
   useEffect(() => {
@@ -82,7 +72,8 @@ export function StripeProvider({
         stripeAccountId,
         threeDSecureParams,
         urlScheme,
-        setUrlSchemeOnAndroid,
+        setReturnUrlSchemeOnAndroid:
+          setReturnUrlSchemeOnAndroid || setUrlSchemeOnAndroid,
       });
     } else {
       NativeStripeSdk.initialise({
@@ -100,6 +91,7 @@ export function StripeProvider({
     stripeAccountId,
     threeDSecureParams,
     urlScheme,
+    setReturnUrlSchemeOnAndroid,
     setUrlSchemeOnAndroid,
   ]);
 

package/src/functions.ts

@@ -1,4 +1,5 @@
-import { createError, isiOS } from './helpers';
+import { createError, isAndroid, isiOS } from './helpers';
+import { MissingRoutingNumber } from './types/Errors';
 import NativeStripeSdk from './NativeStripeSdk';
 import {
   ApplePay,
@@ -12,7 +13,7 @@ import {
   CreateTokenForCVCUpdateResult,
   CreateTokenResult,
   GooglePayInitResult,
-  HandleCardActionResult,
+  HandleNextActionResult,
   InitPaymentSheetResult,
   PaymentMethodCreateParams,
   PaymentSheet,
@@ -57,6 +58,16 @@ export const createPaymentMethod = async (
 export const createToken = async (
   params: CreateTokenParams
 ): Promise<CreateTokenResult> => {
+  if (
+    params.type === 'BankAccount' &&
+    params.country?.toLowerCase() === 'us' &&
+    !params.routingNumber
+  ) {
+    return {
+      error: MissingRoutingNumber,
+    };
+  }
+
   try {
     const { token, error } = await NativeStripeSdk.createToken(params);
 
@@ -228,11 +239,36 @@ export const confirmApplePayPayment = async (
   }
 };
 
+export const handleNextAction = async (
+  paymentIntentClientSecret: string
+): Promise<HandleNextActionResult> => {
+  try {
+    const { paymentIntent, error } = await NativeStripeSdk.handleNextAction(
+      paymentIntentClientSecret
+    );
+    if (error) {
+      return {
+        error,
+      };
+    }
+    return {
+      paymentIntent: paymentIntent!,
+    };
+  } catch (error) {
+    return {
+      error: createError(error),
+    };
+  }
+};
+
+/**
+ * @deprecated This method is deprecated, you should use `handleNextAction` as a drop-in replacement instead.
+ */
 export const handleCardAction = async (
   paymentIntentClientSecret: string
-): Promise<HandleCardActionResult> => {
+): Promise<HandleNextActionResult> => {
   try {
-    const { paymentIntent, error } = await NativeStripeSdk.handleCardAction(
+    const { paymentIntent, error } = await NativeStripeSdk.handleNextAction(
       paymentIntentClientSecret
     );
     if (error) {
@@ -362,6 +398,14 @@ export const confirmPaymentSheetPayment =
     }
   };
 
+export const isGooglePaySupported = async (
+  params?: GooglePay.IsGooglePaySupportedParams
+): Promise<boolean> => {
+  return (
+    isAndroid && (await NativeStripeSdk.isGooglePaySupported(params ?? {}))
+  );
+};
+
 export const initGooglePay = async (
   params: GooglePay.InitParams
 ): Promise<GooglePayInitResult> => {

package/src/hooks/useGooglePay.tsx

@@ -6,10 +6,26 @@ import { useStripe } from './useStripe';
  * useGooglePay hook
  */
 export function useGooglePay() {
-  const { initGooglePay, presentGooglePay, createGooglePayPaymentMethod } =
-    useStripe();
+  const {
+    isGooglePaySupported,
+    initGooglePay,
+    presentGooglePay,
+    createGooglePayPaymentMethod,
+  } = useStripe();
   const [loading, setLoading] = useState(false);
 
+  const _isGooglePaySupported = useCallback(
+    async (params?: GooglePay.IsGooglePaySupportedParams) => {
+      setLoading(true);
+
+      const result = await isGooglePaySupported(params);
+      setLoading(false);
+
+      return result;
+    },
+    [isGooglePaySupported]
+  );
+
   const _initGooglePay = useCallback(
     async (params: GooglePay.InitParams) => {
       setLoading(true);
@@ -48,6 +64,7 @@ export function useGooglePay() {
 
   return {
     loading,
+    isGooglePaySupported: _isGooglePaySupported,
     initGooglePay: _initGooglePay,
     presentGooglePay: _presentGooglePay,
     createGooglePayPaymentMethod: _createGooglePayPaymentMethod,

package/src/hooks/useStripe.tsx

@@ -6,7 +6,7 @@ import type {
   RetrievePaymentIntentResult,
   RetrieveSetupIntentResult,
   ConfirmPaymentResult,
-  HandleCardActionResult,
+  HandleNextActionResult,
   ConfirmSetupIntentResult,
   CreateTokenForCVCUpdateResult,
   ApplePayResult,
@@ -35,7 +35,7 @@ import {
   confirmApplePayPayment,
   confirmSetupIntent,
   createTokenForCVCUpdate,
-  handleCardAction,
+  handleNextAction,
   handleURLCallback,
   presentApplePay,
   updateApplePaySummaryItems,
@@ -43,6 +43,7 @@ import {
   presentPaymentSheet,
   confirmPaymentSheetPayment,
   createToken,
+  isGooglePaySupported,
   initGooglePay,
   createGooglePayPaymentMethod,
   presentGooglePay,
@@ -138,11 +139,11 @@ export function useStripe() {
     []
   );
 
-  const _handleCardAction = useCallback(
+  const _handleNextAction = useCallback(
     async (
       paymentIntentClientSecret: string
-    ): Promise<HandleCardActionResult> => {
-      return handleCardAction(paymentIntentClientSecret);
+    ): Promise<HandleNextActionResult> => {
+      return handleNextAction(paymentIntentClientSecret);
     },
     []
   );
@@ -191,6 +192,13 @@ export function useStripe() {
     []
   );
 
+  const _isGooglePaySupported = useCallback(
+    async (params?: GooglePay.IsGooglePaySupportedParams): Promise<boolean> => {
+      return isGooglePaySupported(params);
+    },
+    []
+  );
+
   const _initGooglePay = useCallback(
     async (params: GooglePay.InitParams): Promise<GooglePayInitResult> => {
       return initGooglePay(params);
@@ -226,7 +234,8 @@ export function useStripe() {
     retrieveSetupIntent: _retrieveSetupIntent,
     confirmPayment: _confirmPayment,
     createPaymentMethod: _createPaymentMethod,
-    handleCardAction: _handleCardAction,
+    handleNextAction: _handleNextAction,
+    handleCardAction: _handleNextAction,
     isApplePaySupported: isApplePaySupported,
     presentApplePay: _presentApplePay,
     confirmApplePayPayment: _confirmApplePayPayment,
@@ -238,6 +247,7 @@ export function useStripe() {
     presentPaymentSheet: _presentPaymentSheet,
     initPaymentSheet: _initPaymentSheet,
     createToken: _createToken,
+    isGooglePaySupported: _isGooglePaySupported,
     initGooglePay: _initGooglePay,
     presentGooglePay: _presentGooglePay,
     createGooglePayPaymentMethod: _createGooglePayPaymentMethod,

package/src/types/Card.ts

@@ -38,6 +38,7 @@ export namespace Card {
   }
 
   export interface Params {
+    id: string;
     country: string;
     brand: Card.Brand;
     currency?: string;

package/src/types/Errors.ts

@@ -66,3 +66,9 @@ export enum GooglePayError {
   Canceled = 'Canceled',
   Unknown = 'Unknown',
 }
+
+export const MissingRoutingNumber = {
+  code: CreateTokenError.Failed,
+  message:
+    'You must provide a routing number for US bank accounts. This should be the ACH routing number.',
+};

package/src/types/GooglePay.ts

@@ -28,8 +28,7 @@ export namespace GooglePay {
     clientSecret: string;
   }
 
-  export interface InitParams {
-    testEnv: boolean;
+  export type InitParams = {
     merchantName: string;
     countryCode: string;
     /**
@@ -42,14 +41,16 @@ export namespace GooglePay {
      * Default to `false`.
      */
     isEmailRequired?: boolean;
+  } & IsGooglePaySupportedParams;
+
+  export type IsGooglePaySupportedParams = {
+    testEnv?: boolean;
     /**
      * If `true`, Google Pay is considered ready if the customer's Google Pay wallet
-     * has existing payment methods.
-     *
-     * Default to `false`.
+     * has an existing payment method.
      */
     existingPaymentMethodRequired?: boolean;
-  }
+  };
 
   export interface BillingAddressConfig {
     isRequired?: boolean;

package/src/types/PaymentMethods.ts

@@ -33,6 +33,7 @@ export namespace PaymentMethodCreateParams {
     | GrabPayParams
     | FPXParams
     | AfterpayClearpayParams
+    | KlarnaParams
     // | WeChatPayParams
     | BancontactParams;
 
@@ -124,6 +125,12 @@ export namespace PaymentMethodCreateParams {
     shippingDetails: ShippingDetails;
   }
 
+  export type KlarnaParams = {
+    type: 'Klarna';
+    billingDetails: Pick<Required<BillingDetails>, 'email' | 'addressCountry'> &
+      BillingDetails;
+  };
+
   export interface EpsParams extends Required<BaseParams> {
     type: 'Eps';
   }

package/src/types/index.ts

@@ -91,7 +91,7 @@ export type ConfirmPaymentResult =
       error: StripeError<ConfirmPaymentError>;
     };
 
-export type HandleCardActionResult =
+export type HandleNextActionResult =
   | {
       paymentIntent: PaymentIntent;
       error?: undefined;
@@ -171,10 +171,14 @@ export type ApplePayResult =
 
 export interface InitStripeParams {
   publishableKey: string;
-  stripeAccountId?: string;
-  threeDSecureParams?: ThreeDSecureConfigurationParams;
   merchantIdentifier?: string;
+  threeDSecureParams?: ThreeDSecureConfigurationParams;
+  stripeAccountId?: string;
   urlScheme?: string;
+  setReturnUrlSchemeOnAndroid?: boolean;
+  /**
+   * @deprecated Use setReturnUrlSchemeOnAndroid instead
+   */
   setUrlSchemeOnAndroid?: boolean;
 }
 
@@ -224,6 +228,7 @@ export type CreateTokenCardParams = {
   type: 'Card';
   address?: Card.Address;
   name?: string;
+  currency?: string;
 };
 
 export type BankAcccountHolderType = 'Company' | 'Individual';

package/stripe-react-native.podspec

@@ -16,5 +16,5 @@ Pod::Spec.new do |s|
   s.source_files = 'ios/**/*.{h,m,mm,swift}'
 
   s.dependency 'React-Core'
-  s.dependency 'Stripe', '~> 21.11.1'
+  s.dependency 'Stripe', '~> 21.13.0'
 end

package/android/build/.transforms/58a84c8dde5bf16d639a134b8787b5f4.bin

@@ -1 +0,0 @@
-i/