📍 Bolt Help / Developer Resources / Bolt SDKs / React Native SDK
React Native SDK
Integrate Bolt Embeddable Checkout into your cross-platform mobile applications using the Bolt React Native SDK. Supports credit card tokenization, 3D Secure, Apple Pay, and Google Pay.

Overview

INFO

The React Native SDK is currently designed for use with Bolt Embeddable Checkout. See the Embeddable Checkout API Reference for full backend API documentation.

The Bolt React Native SDK (@boltpay/react-native) provides everything you need to accept payments in your React Native app — credit card tokenization, 3D Secure verification, Apple Pay, and Google Pay — all integrated with Bolt Embeddable Checkout.

Feature How it works
Credit Card & 3DS WebView-based, loading secure pages from connect.bolt.com. Card data never touches your app (PCI compliant).
Apple Pay Native PKPaymentButton on iOS via a Fabric view component, with a TurboModule for the payment sheet.
Google Pay Native PayButton on Android via a Fabric view component, with a TurboModule for the payment sheet.

Installation

Install the SDK and its peer dependency:

npm install @boltpay/react-native react-native-webview
# or
yarn add @boltpay/react-native react-native-webview

For iOS, install the native pods:

cd ios && pod install

Requirements

Dependency Minimum Version
React Native >= 0.73.0
React >= 18.0.0
react-native-webview >= 13.0.0

Quick Start

1. Initialize Bolt

Create a Bolt client instance and wrap your app with the BoltProvider context:

import { Bolt, BoltProvider } from '@boltpay/react-native';

const bolt = new Bolt({
  publishableKey: 'YOUR_PUBLISHABLE_KEY',
  environment: 'sandbox', // or 'production'
});

function App() {
  return (
    <BoltProvider client={bolt}>
      <CheckoutScreen />
    </BoltProvider>
  );
}

2. Accept a Payment

From here, choose the payment method that fits your use case:

  • Credit Card Payments — Tokenize card details and handle 3D Secure challenges.
  • Apple Pay — Accept Apple Pay on iOS devices.
  • Google Pay — Accept Google Pay on Android devices.
  • Styling — Customize the look and feel of Bolt components.
  • API Reference — Full reference for all exports, props, types, and error codes.

Example App

The SDK repository includes a full checkout demo in the example/ directory. To run it:

yarn example ios
# or
yarn example android

Resources

sdk react-native mobile cross-platform payments