Mastercard Open Finance Connect React Native SDK provides an easy way for developers to integrate Mastercard Open Finance Connect into their React Native application.
The Connect React Native SDK can be used with Mastercard Open Finance in the United States and Australia only.
The functionality available with Connect varies slightly between regions. For details of how to integrate Connect using the Connect SDKs see the following:
- United States
- Australia
Note that this Connect SDK is not suitable for Mastercard Open Finance Europe.
The Connect React Native SDK supports following Android and iOS versions.
- Android:
- Android 7.0 (Nougat) or later
- minSdkVersion 24 or later
- iOS:
- iOS 15.1 or later
React Native 0.87.1 requires Node.js 22.13.0 or later and Xcode 16.1 or later for iOS builds.
The SDK's Android build uses Gradle 9.4.1 and Android Gradle Plugin 9.2.1. Partner apps use their own Gradle wrapper.
The Connect React Native SDK has the following peerDependencies:
- react-native-webview 14.0.1
- react-native-safe-area-context 5.10.1
- react >=19.3.0
- react-native >=0.87.1
Connect provides its own SafeAreaProvider inside its modal; the partner app does not need to add one specifically for Connect. On Android, setting androidEdgeToEdgeMode to before disables the SDK's safe-area edge padding.
Github contains a sample React Native project that is integrated with the Connect React Native SDK. This sample project is named ConnectReactNativeDemoApp. Ensure that you have the necessary setup for React Native version 0.87.1 to successfully run and explore this demo application.
Connect URL events can request external OAuth navigation. To reduce abuse risk from untrusted WebView content:
- Only valid
https://URLs are allowed for external OAuth navigation. HTTP, custom deep links and other schemes are blocked. - The
redirectUrlis validated separately and can use a custom scheme, as shown below.
Example:
<Connect
connectUrl={connectUrl}
redirectUrl="connect://maob/redirect"
eventHandlers={eventHandlers}
/>