Skip to main content
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.
Explore advanced configurations and custom integrations for the React Native SDK.

Deep linking / external browser return

Handle users returning to your app after external payment flows like 3DS authentication challenges, bank transfer redirects, PIX payments, and alternative payment methods that redirect to external browsers.

1. Set callback_url in checkout session

Include callback_url when creating the checkout session on your backend:
iOS - Info.plist:
Android - AndroidManifest.xml:

4. Continue payment after return

After handling the deep link, continue the payment flow:

Performance

Lazy loading

Initialize the SDK only when the user enters the payment flow to save resources.

Error handling

Listen to the onPaymentStatus event to handle failures gracefully.

Platform-specific configuration

Handle differences between iOS and Android in your React Native app.

Conditional configuration

Platform differences