React Native installation

If you’re looking for information on how to integrate the SDK, check out our

Universal Checkout integration guide.

​

Step 1. Install the SDK

Add the SDK package using your preferred package manager:

BASH

# With yarn
yarn add @primer-io/react-native

# With npm
npm i @primer-io/react-native --save

​

Step 2. Install the iOS dependencies

After adding the SDK, navigate to the /ios folder and run pod install to ensure all iOS dependencies are properly installed.

​

Step 3.

Then import Primer in your application

TS

import { Primer, PrimerSettings } from "@primer-io/react-native";

// for example
Primer.configure({
  /* options */
} as PrimerSettings);
Primer.showUniversalCheckout(clientToken);

​

Android library versions

Some payment methods and features, such as Klarna and 3D Secure, need a separate Primer Android library. The integration guide for each one shows the library to add to android/app/build.gradle.

Add these libraries without a version:

build.gradle

dependencies {
    implementation 'io.primer:klarna-android'
}

From React Native SDK 2.49.0, the SDK applies the Primer BOM (io.primer:bom) to your app. The BOM sets each Primer library to the version that matches the Android SDK bundled with the React Native SDK, and overrides any version you set yourself.

On earlier React Native SDK versions, check the React Native SDK changelog for the library version that matches your SDK.