Android Enrollment

The Android SDK makes it easy to implement enrollment flows for saving payment methods to a customer account. Include the library in your project by following the same steps as in full-checkout.

Additional resources

See Choose the right integration for you if you’re unsure which flow to follow.
Access the Release notes or the Yuno Android SDK repository to verify the latest SDK version available.
full-checkout Enrollment (Android): Automatic enrollment with pre-built UI components

Requirements

Minimum SDK Version: minSdkVersion 21 or above
Java: Java 8 enabled
AndroidX: Use AndroidX instead of older support libraries
Android Gradle Plugin: 4.0.0 or above
ProGuard: 6.2.2 or above
Kotlin Gradle Plugin: 1.4.0 or above
ELF Page Size Support: Compliant with Google’s 16 KB ELF page alignment requirements (Android 15 / ARMv9 ready)

ProGuard / R8 Configuration

If your project has minifyEnabled = true, add these rules to your proguard-rules.pro file to ensure the SDK works correctly, especially with AGP 8.x+ R8 full mode.

Official Yuno ProGuard / R8 rules

# Preserve generic type signatures and annotations
-keepattributes Signature
-keepattributes *Annotation*

# Yuno SDK
-keep class com.yuno.** { *; }
-dontwarn com.yuno.**

# Gson — R8 full mode compatibility
-keep class com.google.gson.** { *; }
-keep,allowobfuscation,allowshrinking,allowoptimization class * extends com.google.gson.reflect.TypeToken
-dontwarn com.google.gson.**

# Retrofit — R8 full mode compatibility
-keep,allowobfuscation,allowshrinking interface retrofit2.Call
-keep,allowobfuscation,allowshrinking class retrofit2.Response
-keep,allowobfuscation,allowshrinking class kotlin.coroutines.Continuation
-dontwarn retrofit2.**

# OkHttp + Okio — Suppress warnings
-dontwarn okhttp3.**
-dontwarn okio.**

Why are these rules necessary?

AGP 8.x+ enables R8 full mode by default, which aggressively strips generic type signatures. Without -keepattributes Signature, Gson’s TypeToken<T> can fail at runtime with java.lang.Class cannot be cast to java.lang.reflect.ParameterizedType.

Parameters

For the full list of parameters, see the Android SDK Common Reference.

Parameter	Description
`customerSession`	Customer session ID from Create customer session API. Required.
`countryCode`	ISO country code. Required.
`showEnrollmentStatus`	Show enrollment result screen. Optional; default true.
`callbackEnrollmentState`	Callback: enrollment state. Optional; requires `initEnrollment` in onCreate.
`keepLoader`	If `true`, the SDK loader persists during enrollment, preventing UI flickering.
`requestCode`	Optional; use if capturing result via `onActivityResult`.
`countryCode`	Country for the enrollment. Required for `apiClientEnroll`.
`customerSession`	Customer session ID. Required for `apiClientEnroll`.

full-checkout Enrollment (Android)

Yuno full-checkout for Android provides enrollment with pre-built UI, card enrollment, status handling, and basic error management. See Requirements above.

Step 1: Create a customer

Create a customer in Yuno’s system using the Create customer endpoint before enrolling payment methods. This endpoint returns a customer_id. Then create a customer session using the Create Customer Session endpoint; use the returned customer_session when calling the enrollment methods.

Step 2: Include the library in your project

Add the Yuno library to your Android project:

Add the Repository

Add Yuno’s Maven repository to your project’s Gradle configuration:

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

Add the dependency in build.gradle:

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

Permissions

The Yuno SDK includes the INTERNET permission by default, which is required to make network requests.

<uses-permission android:name="android.permission.INTERNET" />

Step 3: Initialize SDK with the public key

Initialize the SDK:

Get your Public API Key from the Yuno Dashboard
Create a custom application class if you haven’t already done so
In the onCreate() method of your application class, call Yuno.initialize() with your API key:

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

Use the data class YunoConfig to customize the SDK’s behavior. Include this configuration when calling Yuno.initialize(). The available options are:

data class YunoConfig(
    val saveCardEnabled: Boolean = false,
    val keepLoader: Boolean = false,
    val language: YunoLanguage? = null,
    val styles: YunoStyles? = null
)

For a detailed explanation of the keepLoader parameter and mandatory error handling, see the Android Reference Guide.

cardFlow removed from YunoConfigStarting from version 2.11.0, cardFlow is no longer part of YunoConfig. Card flow configuration is now handled exclusively through the CheckoutBuilder.

Step 4: Enroll a new payment method

The enrollment process is a two-step flow. First, initialize the process to set up the necessary components. Then, start the UI flow to allow the user to enroll a payment method.

4.1 Initialize the enrollment process

Call the initEnrollment method within your activity’s onCreate method to prepare your app to handle the enrollment flow. This is a mandatory setup step required by the Android operating system to register the contract that allows the SDK to send the final enrollment status back to your app.

fun ComponentActivity.initEnrollment(
    callbackEnrollmentState: ((String?) -> Unit)? = null
)

4.2 Start the enrollment flow

Call the startEnrollment method to launch the user interface and begin the enrollment of a new payment method. You can call this method at any point after initEnrollment has been executed, such as when a user taps an “Enroll New Payment Method” button.

fun Activity.startEnrollment(
    customerSession: String,
    countryCode: String,
    showEnrollmentStatus: Boolean = true,
    callbackEnrollmentState: ((String?) -> Unit)? = null,
    requestCode: Int
)

startEnrollment parameters:

Parameter	Description
`customerSession`	The session customer associated with the current enrollment process.
`countryCode`	Country code where the payment is performed. See Country coverage for a complete list of supported countries and their codes.
`showEnrollmentStatus`	Indicates whether the enrollment status should be shown. This parameter is optional and defaults to `true`.
`callbackEnrollmentState`	A function that returns the current state of the enrollment process. This parameter is optional and defaults to `null`. To register this callback, you must call `initEnrollment` method in the `onCreate` method of the activity. Check the possible states that can be returned.
`requestCode`	It is an optional parameter you must inform if you are going to use the `onActivityResult` method to capture the enrollment states.

Common reference

For full parameter and customization details, see the Android SDK Common Reference.

Overview

Seamless SDK

Lite SDK

Headless SDK

Customization

Card Enrollment

Resources

Additional Platforms

External Native Modules

Additional resources

Requirements

ProGuard / R8 Configuration

Why are these rules necessary?

Parameters

full-checkout Enrollment (Android)

Step 1: Create a customer

Step 2: Include the library in your project

Add the Repository

Permissions

Step 3: Initialize SDK with the public key

Step 4: Enroll a new payment method

4.1 Initialize the enrollment process

4.2 Start the enrollment flow

Common reference

​Additional resources

​Requirements

​ProGuard / R8 Configuration

​Why are these rules necessary?

​Parameters

​full-checkout Enrollment (Android)

​Step 1: Create a customer

​Step 2: Include the library in your project

​Add the Repository

​Permissions

​Step 3: Initialize SDK with the public key

​Step 4: Enroll a new payment method

​4.1 Initialize the enrollment process

​4.2 Start the enrollment flow

​Common reference

Additional resources

Requirements

ProGuard / R8 Configuration

Why are these rules necessary?

Parameters

full-checkout Enrollment (Android)

Step 1: Create a customer

Step 2: Include the library in your project

Add the Repository

Permissions

Step 3: Initialize SDK with the public key

Step 4: Enroll a new payment method

4.1 Initialize the enrollment process

4.2 Start the enrollment flow

Common reference