Lite SDK (Payment Android)

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) 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.

This page provides a guide to the Yuno Lite SDK for Android payments. This SDK offers a streamlined integration process with essential payment capability, making it ideal for merchants who:

Need a quick implementation with minimal customization requirements
Want to focus primarily on card payment processing
Prefer a ready-to-use UI that handles the payment flow

The Lite SDK includes core features like:

Pre-built payment UI components
Card payment processing
Basic payment status handling
Essential error management

For merchants requiring more advanced features like multiple payment methods, custom UI, or advanced fraud prevention, consider using Yuno’s Full SDK instead.

Requirements

Before starting the Yuno Android SDK integration, ensure your project meets the technical requirements. Also, ensure the following prerequisites are in place:

You must have an active Yuno account.
You need your Yuno API credentials (account_id, public-api-key, and private-secret-key), which you can obtain from the Developers credentials section of the Yuno dashboard.

Step 1: Create a customer

Create a customer using the Create customer endpoint before initiating payments. The customer ID returned from this endpoint will be used when creating the checkout_session.

Step 2: Create a checkout session

Create a new checkout_session using the Create checkout session endpoint to initialize the payment flow.

Step 3: Include the library in your project

Include the Yuno SDK file in your project through Gradle. Add the repository source:

maven { url "https://yunopayments.jfrog.io/artifactory/snapshots-libs-release" }

Include the following code in the build.gradle file to add the Yuno SDK dependency:

dependencies {
    implementation 'com.yuno.payments:android-sdk:2.27.0'
}

Step 4: Initialize SDK with the public key

Initialize the SDK by calling Yuno.initialize() in your application’s onCreate() method:

class CustomApplication : Application() {
  override fun onCreate() {
    super.onCreate()
    Yuno.initialize(
      this,
      PUBLIC_API_KEY,
      config = YunoConfig(
        saveCardEnabled = false,
        keepLoader = true,
        language = YunoLanguage.ENGLISH,
      )
    )
  }
}

YunoConfig customization

Option	Description
`saveCardEnabled`	Enables the Save card checkbox.
`keepLoader`	If `true`, the SDK loader persists from OTT generation until `continuePayment()` is called. See keepLoader Parameter.
`language`	Defines the language as a `YunoLanguage` value (for example, `SPANISH`, `ENGLISH`, `PORTUGUESE`).
`styles`	Pre-defined styles.

Step 5: Start the checkout process

Call the startCheckout method in your activity:

startCheckout(
  checkoutSession = "checkout_session",
  countryCode = "US",
  callbackPaymentState = { state, subState, message ->
    println("Payment State: $state, Substate: $subState, Error: ${message?.code}")
  }
)

Callback states

State	Description
`SUCCEEDED`	Transaction completed successfully.
`FAIL`	Transaction failed.
`PROCESSING`	In progress, awaiting verification.
`REJECT`	Rejected (for example, insufficient funds).
`CANCELED_BY_USER`	User canceled the process.

Step 6: Initiate the payment process

Call startPaymentLite to start the process:

startPaymentLite(
    paymentSelected = PaymentSelected(
      paymentMethodType = "CARD",
      vaultedToken = null
    ),
    callbackOTT = { ott -> println("OTT: $ott") },
    callBackTokenWithInformation = { info -> println("Token Info: $info") },
    showPaymentStatus = true,
)

Step 7: Create the payment

After obtaining the One-Time Token (OTT), create the payment via your backend using the Create Payment API.

Step 8: Continue payment (Required)

If the API response has sdk_action_required: true, call continuePayment():

continuePayment(
    showPaymentStatus = true,
    checkoutSession = "checkout_session",
    countryCode = "US",
    callbackPaymentState = { state, subState, message -> ... }
)

Demo AppSee the Yuno Android SDK repository for full implementation examples.

Overview

Seamless SDK

Lite SDK

Headless SDK

Card Enrollment

Additional Features

Resources

Additional Platforms

Web Frameworks

Validate your integration

External Native Modules

Requirements

Step 1: Create a customer

Step 2: Create a checkout session

Step 3: Include the library in your project

Step 4: Initialize SDK with the public key

YunoConfig customization

Step 5: Start the checkout process

Callback states

Step 6: Initiate the payment process

Step 7: Create the payment

Step 8: Continue payment (Required)

​Requirements

​Step 1: Create a customer

​Step 2: Create a checkout session

​Step 3: Include the library in your project

​Step 4: Initialize SDK with the public key

​YunoConfig customization

​Step 5: Start the checkout process

​Callback states

​Step 6: Initiate the payment process

​Step 7: Create the payment

​Step 8: Continue payment (Required)

Requirements

Step 1: Create a customer

Step 2: Create a checkout session

Step 3: Include the library in your project

Step 4: Initialize SDK with the public key

YunoConfig customization

Step 5: Start the checkout process

Callback states

Step 6: Initiate the payment process

Step 7: Create the payment

Step 8: Continue payment (Required)