Documentation Index
Fetch the complete documentation index at: https://docs.y.uno/llms.txt
Use this file to discover all available pages before exploring further.
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.
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
| Parameter | Description |
|---|
checkoutSession | Checkout session ID from your backend. |
methodSelected.paymentMethodType | Payment method type (e.g. CARD, PIX). |
methodSelected.vaultedToken | Saved payment method token, or null for new card. |
showPaymentStatus | When true, SDK shows payment result UI. |
countryCode | Optional ISO country code override (e.g. US). |
