Stripe React Native SDK

Build payments into your React Native mobile app.

The Stripe React Native SDK allows you to build payments into your native Android and iOS apps using React Native. We provide powerful and customizable UI screens and elements that you can use out-of-the-box to collect your users’ payment details.

Set up the Stripe React Native SDK

The React Native SDK is open source and fully documented. Internally, it uses of native iOS and Android SDKs. To install Stripe’s React Native SDK, run one of the following commands in your project’s directory (depending on which package manager you use):

Command Line

yarn add @stripe/stripe-react-native

Next, install some other necessary dependencies:

For iOS, navigate to the ios directory and run pod install to ensure that you also install the required native dependencies.
For Android, there are no more dependencies to install.

Stripe initialization

To initialize Stripe in your React Native app, either wrap your payment screen with the StripeProvider component, or use the initStripe initialization method. Only the API publishable key in publishableKey is required. The following example shows how to initialize Stripe using the StripeProvider component.

import { StripeProvider } from '@stripe/stripe-react-native';

function App() {
  return (
    <StripeProvider
      publishableKey="pk_test_TYooMQauvdEDq54NiTphI7jx"
      urlScheme="your-url-scheme" // required for 3D Secure and bank redirects
      merchantIdentifier="merchant.com.{{YOUR_APP_NAME}}" // required for Apple Pay
    >
      // Your app code here
    </StripeProvider>
  );
}

Use your API keys for test mode while you test and develop, and your live mode keys when you publish your app.

Get started

This wraps up the introductory guide to setting up the Stripe React Native SDK. See the links below to get started with your integration.