​
Overview

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.
FeatureHow it works
Credit Card & 3DSWebView-based, loading secure pages from connect.bolt.com. Card data never touches your app (PCI compliant).
Apple PayNative PKPaymentButton on iOS via a Fabric view component, with a TurboModule for the payment sheet.
Google PayNative 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

DependencyMinimum 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