Vehicle Custody

Developer Hub

Wallet SDK for React Native

Integrate a mobile wallet experience into your React Native application using the VECU Wallet SDK.

This SDK is designed for host applications that need to present wallet functionality, manage credentials, and support device-based wallet flows at a high level without rebuilding the entire experience from scratch.

Stable Release

The React Native Wallet SDK is currently available as a stable release (

v1.0.3

). Review the installation and integration guidance for the recommended host app setup.

Host App Setup Required

Before testing QR, NFC, or proximity-based flows on device, your host application must complete native setup in AndroidManifest.xml, Info.plist, and iOS entitlements. For verifier-initiated NFC receive flows, add the VECU AID F056454355000001 to Info.plist. Review NFC Setup and the Installation Guide before starting integration.

What This SDK Enables

  • Render a wallet experience inside your React Native app
  • Present credential and offer workflows at a high level
  • Support QR-based and proximity-based flows through host app setup
  • Apply host-app branding through supported theming options
  • Choose between a minimal embedded experience and more customized integration

Recommended Path

If you are integrating the SDK for the first time, follow this order:

  1. Installation for package access, peer dependencies, and native app setup
  2. Permissions for camera, Bluetooth, NFC, and manifest requirements
  3. Quick Start for the minimum integration path
  4. Integration Approaches if your host app needs more control
  5. Configuration for required and optional SDK settings
  6. Theming for host-app branding

Integration Model

The host application remains responsible for:

  • obtaining the user's authentication token through its own login or authorization flow
  • passing that token into the SDK configuration
  • configuring required iOS and Android permissions
  • deciding how the wallet experience fits into app navigation

The SDK then provides the wallet experience inside that host application.

Reference Applications

The wallet application and demo application can be used as high-level reference integrations.

Use them to understand:

  • where the SDK is mounted in a host app
  • how a wallet screen can be embedded in navigation
  • how permissions and app configuration are handled at the application level

Do not treat those applications as required implementation templates. They include additional app-specific wiring beyond the minimum SDK setup.

Requirements

  • React Native 0.81.0 or later
  • React 19 or later
  • react-native-svg
  • access to the Cox Automotive package registry
  • additional native dependencies may be required depending on the flows your app enables, including camera, QR, NFC, Bluetooth, and connectivity-related features

Next Steps