by [Jan Jaworski](https://www.callstack.com/team/jan-jaworski) ## What is Stripe Identity? There’s no easier way to verify identities than [Stripe Identity](https://stripe.com/identity). It lets you programmatically confirm the identity of users around the globe by scanning an image of an official form of ID, so you can prevent attacks from fraudsters while minimizing friction for legitimate payments. Stripe Identity is an [open source](https://www.callstack.com/open-source) React Native wrapper for the native Stripe SDKs. The idea is to compare your Face ID with images of you and your IDs by means of biometric technology. With the Stripe Identity React Native SDK, you can confidently verify the authenticity of ID documents from over 33 countries in your React Native application. ## How to use the Stripe Identity React Native SDK To verify your user’s identity, you need to have a document upload sheet displayed in your application. There are few steps to do that. First of all, you have to install [Stripe Identity React Native SDK](https://github.com/stripe/stripe-identity-react-native). The next step is to set up a server to create a VerificationSession, which is the programmatic representation of the verification. For security reasons, the VerificationSession API is not directly accessible from the mobile client. Instead, your server provides the SDK with an ephemeral key—a short-lived API key with restricted access to the VerificationSession API. You can think of an ephemeral key as a session authorizing the SDK to retrieve and update a specific VerificationSession object for the duration of the session. After successfully creating a VerificationSession and ephemeral key, send the VerificationSession id and ephemeral key secret to the client to show the document upload sheet. The third step is to show the “document upload” sheet to the user. With Stripe Identity React Native, you can do this in two ways - via a hook called useStripeIdentity, or a method called presentIdentityVerificationSheet. That depends on whether you want to use it in functional or class based components. You can find example code in the [repository](https://github.com/stripe/stripe-identity-react-native) or [integration guide](https://github.com/stripe/stripe-identity-react-native). ## Getting started with the useStripeIdentity hook The easiest way to use the SDK is to import the useStripeIdentity hook directly in a functional component. You should pass the necessary information you fetched from your server directly to the hook. ``` import React from "react"; import { View, Button, Text, Image } from "react-native"; import { useStripeIdentity } from "@stripe/stripe-identity-react-native"; // brand logo that needs to be passed to Stripe Identity hook import logo from "./assets/{{YOUR_BRAND_LOGO}}.png"; // simplified example of fetch function for Stripe Identity // it can be replaced with more robust implementation that handles error handling, analytics, etc. // other fetching libraries like Axios can be used as a replacement for native fetch() const fetchVerificationSessionParams = async () => { try { const data = await fetch( `${YOUR_SERVER_BASE_URL}/create-verification-session`, { method: "POST", headers: { "Content-Type": "application/json" } } ); const json = await data.json(); return json; } catch (e) { return {}; } }; // options needed to make correct request to Stripe Identity const fetchOptions = async () => { const response = await fetchVerificationSessionParams(); return { sessionId: response.id, ephemeralKeySecret: response.ephemeral_key_secret, brandLogo: Image.resolveAssetSource(logo) }; }; function VerifyScreen() { // hook provided by Stripe Identity SDK allows API consumers to get important states and values without too much work from their side. const { status, present, loading } = useStripeIdentity(fetchOptions); return (

identitycheck

Stripe Identity: ID Authentication Made Simple

Join Our Newsletter. No Spam, Only the good stuff.