Skip to main content
This page documents a legacy SDK. Starting a new integration? Use the Yuno SDK. Already on a legacy SDK? Follow the migration guide.The new Yuno SDK (Web v2.x, iOS v3.x, Android v3.x, React Native v2.x) replaces the Full, Lite, Seamless, Render, Headless, and Secure Fields SDKs with one API across every platform. Legacy SDKs remain supported side by side during the transition and are scheduled for deprecation in 2027. Contact your Account Manager for migration planning.
Orientation: Choosing Your Integration Flow, before you begin, please review the Official Integration Flow.
  • Standard Flow (Full Checkout): Recommended for most merchants. Yuno handles the UI, security, and automatic updates for payment methods.
  • Custom Flow (This SDK): Use this only if you require full control over the UX. Note: You will be responsible for manually handling payment statuses, 3DS transitions, and fraud routing data collection.
The Yuno React Native SDK provides a set of components and methods to integrate Yuno’s payment features into your mobile app. It supports both iOS and Android.

Install

iOS setup:
Requirements:
  • react-native 0.70+
  • Node.js 16+
  • Android Min SDK 21
  • iOS 14.0+
The SDK includes TypeScript definitions out of the box.

Initialize

Initialize the SDK as early as possible in your app, typically in App.tsx.

Basic payment flow (Full Checkout)

The simplest integration uses the YunoPaymentMethods component to display available payment methods and startPayment to process the transaction.

Integration options

Choose the integration level that best fits your needs:

Lite SDK

Control the payment method selection UI while Yuno handles the payment process.

Headless SDK

Build a completely custom UI and handle the payment flow manually.

Enrollment

Allow customers to save their payment methods for future use.

Styling

Customize the appearance of the SDK components to match your brand.

Next steps