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.
The Lite SDK allows you to build your own payment method selection screen while Yuno handles the actual payment process and security.

​
Alternative mounting options

The basic flow uses automatic payment method display. For more control, use these alternatives:

​
Custom payment method selection (startPaymentLite)

Select which payment method to display: 
// 1. Fetch available methods
const methods = await fetchPaymentMethods(sessionId);

// 2. Display in your UI
// 3. Start payment with selected method

await YunoSdk.startPaymentLite(
  {
    checkoutSession: session.checkoutSession,
    methodSelected: {
      paymentMethodType: selectedMethod, // 'CARD', 'PIX', etc.
      vaultedToken: null, // or saved token
    },
    showPaymentStatus: true,
  },
  'US' // Optional country code override
);

​
Simplified flow (startPaymentSeamlessLite)

Similar to Lite but with automatic payment creation: 
await YunoSdk.startPaymentSeamlessLite({
  checkoutSession: session.checkoutSession,
  methodSelected: {
    paymentMethodType: 'CARD',
    vaultedToken: null, // or saved token
  },
  showPaymentStatus: true,
  countryCode: 'US',
});

​
Vaulted token payments

Use saved payment methods for a faster checkout experience. 
await YunoSdk.startPaymentLite({
  checkoutSession: session.checkoutSession,
  methodSelected: {
    paymentMethodType: 'CARD',
    vaultedToken: 'vtok_saved_card_123',
  },
  showPaymentStatus: true,
});

​
Parameters

ParameterDescription
checkoutSessionCheckout session ID from your backend.
methodSelected.paymentMethodTypePayment method type (e.g. CARD, PIX).
methodSelected.vaultedTokenSaved payment method token, or null for new card.
showPaymentStatusWhen true, SDK shows payment result UI.
countryCodeOptional ISO country code override (e.g. US).