Android

Push Provisioning SDK se utiliza para tokenizar tarjetas para Google Pay y Samsung Pay. Este SDK gestiona la comunicación con los SDK de Google Pay y Samsung Pay. También simplifica el flujo de tokenización para las aplicaciones emisoras.

Esta sección está dirigida a desarrolladores de aplicaciones emisoras Android que quieran integrar Push Provisioning SDK en su aplicación.

Servicios disponibles

Thales Push Provisioning SDK proporciona los siguientes servicios:

• Le permite integrar una aplicación emisora con las API de Push Provisioning SDK, como isCardDigitized y addCard (Google Pay y Samsung Pay).
• Reduce la necesidad de comprender los SDK de Google Pay y Samsung Pay.
• Reutiliza los servicios de Push Provisioning SDK en proyectos existentes.
• Inscribe el FPAN en Google Pay o Samsung Pay.
• Accede a las API del servidor TSH.

Requisitos previos

• Versión de Java: 11
• Versión de Android Studio: Chipmunk o posterior.
• Un dispositivo con Google Play Services (para Google Pay).

Para obtener la funcionalidad completa de Google Pay, se recomienda ejecutarlo en dispositivos móviles.

Integración con la aplicación emisora

• Crea una carpeta llamada libs dentro del directorio del módulo (normalmente 'app'), como se muestra en la siguiente figura:

• Copia el archivo AAR de Push Provisioning SDK en la carpeta libs .
• Desde Push Provisioning SDK v1.12.2, copia el archivo JAR de Samsung Pay SDK en la carpeta libs .
• Desde Push Provisioning SDK v2.0.0, copia el archivo AAR de Google Pay SDK en la carpeta libs .
• Abre el build.gradle o build.gradle.kts de la aplicación y añade las siguientes dependencias:

Groovy

android {
  defaultConfig {
    ndk {
      abiFilters 'arm64-v8a', 'x86_64', 'armeabi-v7a', 'x86'
    }
  }
  buildTypes {
        debug {
            // para Samsung Pay
            manifestPlaceholders = [DEBUG_MODE: 'Y', SPAY_API_LEVEL: 2.22]
        }
        release {
            // para Samsung Pay
            manifestPlaceholders = [DEBUG_MODE: 'N' , SPAY_API_LEVEL: 2.22]
        }
    }
}

dependencies {
    debugImplementation 'com.squareup.okhttp3:logging-interceptor:4.9.1' // depuración contiene registrador
    releaseImplementation 'com.squareup.okhttp3:okhttp:4.9.1'
    implementation "com.google.android.gms:play-services-base:18.5.0"
    implementation "com.google.android.gms:play-services-basement:18.5.0"
    implementation files('libs/tpcsdk.aar') // Usa el nombre de archivo más reciente de Push Provisioning SDK 
    implementation files('libs/samsungpay_2.22.00.jar') // desde SDK v1.12.2
    implementation files('libs/play-services-tapandpay-18.7.0.aar') // desde SDK v2.0.0
    implementation 'net.java.dev.jna:jna:5.17.0@aar'
}

Kotlin

android {
  defaultConfig {
    ndk {
      abiFilters += listOf("arm64-v8a", "x86_64", "armeabi-v7a", "x86")
    }
  }
}

dependencies {
    debugImplementation ("com.squareup.okhttp3:logging-interceptor:4.9.1") // depuración contiene registrador
    releaseImplementation ("com.squareup.okhttp3:okhttp:4.9.1")
    implementation ("com.google.android.gms:play-services-base:18.2.0")
    implementation files('libs/samsungpay_2.22.00.jar') // desde SDK v1.12.2
    implementation files('libs/play-services-tapandpay-18.7.0.aar') // desde SDK v2.0.0
    implementation (files("libs/tpcsdk.aar")) // Usa el nombre de archivo más reciente de Push Provisioning SDK 
    implementation ("net.java.dev.jna:jna:5.17.0@aar")
}

Nota

• Desde Push Provisioning SDK V1.7.0, la biblioteca JNA se utiliza como dependencia. Se recomienda usar JNA V5.5.0 porque no se garantiza que otras versiones funcionen con Push Provisioning SDK.
• Desde Push Provisioning SDK V1.12.0, es obligatorio usar JNA V5.17.0 para admitir tamaños de página de 16 KB.

• Para importar una dependencia file-tree en la compilación de Gradle, abre el build.gradle o build.gradle.kts de la aplicación y añade la siguiente dependencia:

Groovy

dependencies {
    implementation fileTree(dir: "libs", include: ["*.jar", "*.aar"])

}

Kotlin

dependencies {
    implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar", "*.aar"))))
}

• Consulta la aplicación de ejemplo y la documentación de Java para aprender a usar las API de Push Provisioning SDK.

Compatibilidad con tamaños de página de 16 KB

A partir del 1 de noviembre de 2025, todas las aplicaciones desarrolladas recientemente y las actualizaciones de aplicaciones existentes enviadas a Google Play, y destinadas a dispositivos Android 15+, deben admitir tamaños de página de 16 KB. Esta compatibilidad está disponible para Push Provisioning SDK V1.12.0 y posteriores.

Al compilar un APK que admita tamaños de página de 16 KB:

• Actualiza a Push Provisioning SDK V1.12.0 o posterior.
• Actualiza la dependencia de JNA a 5.17.0 o posterior. Para JNA 5.17.0, la versión requerida de Android Gradle Plugin (AGP) es 8.0.2 o posterior. Si utilizas una versión de AGP anterior a 8.0.2, es posible que encuentres problemas de compilación.
• Cuando la versión de AGP es 8.5.1 o posterior, la aplicación se alinea automáticamente con tamaños de página de 16 KB. Si es anterior a 8.5.1, configura las opciones de empaquetado heredadas en el build.gradle archivo.

Configuración

Usa el siguiente fragmento para configurar Push Provisioning SDK en tu aplicación móvil:

Nota

Desde Push Provisioning SDK V1.9.0, tu aplicación puede establecer un Context de aplicación en lugar de un Activity al configurar Push Provisioning SDK para Google Pay y Samsung Pay. Un Activity solo es requerido por la nueva API, addCard(Activity activity, CardInfo cardInfo, TPCSDKListener<T> listener), para el push provisioning de Google Pay.

Java

protected static final int HTTP_TIMEOUT = 60;

protected CountDownLatch mCountDownLatch;

protected void awaitCountDownLatch() {
    try {
        mCountDownLatch.await(HTTP_TIMEOUT, TimeUnit.SECONDS);
    } catch (Exception e) { // Ignorado.
    }
}

protected void resetCountDownLatch() {
    mCountDownLatch = new CountDownLatch(1);
}

@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState); 
    // Configurar SDK para el push provisioning de esquema
    // Desde Push Provisioning SDK V2.0.0, solo establece OEMPayType cuando realices el aprovisionamiento de OEM Wallet. De lo contrario, deja el tipo OEM sin establecer.
    Config schemeConfig = new Config();
    schemeConfig.setIssuerId("ISSUERID");
    schemeConfig.setUrl("URL"); // URL correspondiente
    // Desde Push Provisioning SDK V1.9.0, la aplicación puede establecer `Context`
    // en lugar de `Activity` durante la configuración de Push Provisioning SDK
    // para el aprovisionamiento de esquema
    schemeConfig.setContext(getApplicationContext());
    configSdkForScheme(schemeConfig);
    
    // Configurar SDK para push provisioning OEM
    Config oemConfig = new Config();
    oemConfig.setIssuerId("ISSUERID");
    oemConfig.setUrl("URL"); // URL correspondiente
    
    // La lista puede actualizarse en consecuencia. Por ejemplo, es posible que solo necesites tener un tipo de OEMPayType.
    List<OEMPayType> oemPayTypes = Arrays.asList(
        //Desde Push Provisioning SDK V2.0.0, OEMPayType.NONE ya no es compatible
        OEMPayType.GOOGLE_PAY,
        OEMPayType.SAMSUNG_PAY,
        OEMPayType.HUAWEI_PAY);

    for (OEMPayType oemPayType:oemPayTypes) {
        if (oemPayType == OEMPayType.SAMSUNG_PAY) {
            oemConfig.setContext(getApplicationContext());
            oemConfig.setServiceId("SERVICEID");
            oemConfig.setVisaClientAppId("VisaClientAppID");
        } else if (oemPayType == OEMPayType.HUAWEI_PAY) {
            String callbackUrl = "tpcsdk://com.thalesgroup.tpc.demo/tokenRequestorsPage";
            oemConfig.setCallbackUrl(callbackUrl);
            oemConfig.setActivity(getActivity());
        } else if (oemPayType == OEMPayType.GOOGLE_PAY) {
            //Desde Push Provisioning SDK V1.9.0, la aplicación puede establecer `Context` en lugar de `Activity` durante la configuración de Push Provisioning SDK para Google Pay
            oemConfig.setContext(getApplicationContext());
        }
        configSdk(oemPayType, oemConfig);
    }
}

public void configSdkForScheme(Config configs) throws InterruptedException {
    // Desde Push Provisioning SDK V2.0.0, para el push provisioning de esquema, no establezcas OEMPayType
    resetCountDownLatch();
    TPCManager.getInstance().config(configs, new TPCSDKListener<Boolean>() {
        @Override
        public void onStart() {
        }

        @Override
        public void onSuccess(TPCResult<Boolean> result) {
            Log.d("CONFIG_SDK", "Configuración de esquema exitosa...");
            mCountDownLatch.countDown();
        }

        @Override
        public void onError(TPCSDKException exception) {
            Log.e("CONFIG_SDK", "La configuración de esquema falló con el error: " + exception.getMessage());
            mCountDownLatch.countDown();
        }
    });
    awaitCountDownLatch();
}

public void configSdk(OEMPayType oemPayType, Config configs) throws InterruptedException {
    configs.setOemPayType(oemPayType);
    resetCountDownLatch();
    TPCManager.getInstance().config(configs, new TPCSDKListener<Boolean>() {
        @Override
        public void onStart() {
        }

        @Override
        public void onSuccess(TPCResult<Boolean> result) {
            Log.d("CONFIG_SDK", "Configuración exitosa..." + oemPayType.getOemType());
            mCountDownLatch.countDown();
        }

        @Override
        public void onError(TPCSDKException exception) {
            Log.e("CONFIG_SDK", "La configuración falló con el error: " + exception.getMessage());
            mCountDownLatch.countDown();
        }
    });
    awaitCountDownLatch();
}

Kotlin

class MainViewModel : ViewModel() {
    fun configureMultipleOEM(activity: Activity){
        viewModelScope.launch {
            // Configurar SDK para el push provisioning de esquema
            // Desde Push Provisioning SDK V2.0.0, solo establece OEMPayType cuando realices el aprovisionamiento de OEM Wallet. De lo contrario, deja el tipo OEM sin establecer.
            val schemeConfig = Config()
            schemeConfig.issuerId = "ISSUERID"
            schemeConfig.url = "URL" // URL correspondiente
            // Desde Push Provisioning SDK V1.9.0, la aplicación puede establecer `Context`
            // en lugar de `Activity` durante la configuración de Push Provisioning SDK
            // para el aprovisionamiento de esquema
            schemeConfig.context = applicationContext

            configSdkForScheme(schemeConfig).collect {
                println(it)
            }

            // Configurar SDK para push provisioning OEM
            val oemConfig = Config()
            oemConfig.issuerId = "ISSUERID"
            oemConfig.url = "URL" // URL correspondiente

            // La lista puede actualizarse en consecuencia. Por ejemplo, es posible que solo necesites tener un tipo de OEMPayType.
            val oemPayTypes: List<OEMPayType> = listOf(
                //Desde Push Provisioning SDK V2.0.0, OEMPayType.NONE ya no es compatible
                OEMPayType.GOOGLE_PAY,
                OEMPayType.SAMSUNG_PAY,
                OEMPayType.HUAWEI_PAY
            )
            for (oemPayType in oemPayTypes) {
                when (oemPayType) {
                    OEMPayType.SAMSUNG_PAY -> {
                        oemConfig.serviceId = "SERVICEID"
                        oemConfig.context = applicationContext
                        oemConfig.visaClientAppId = "VisaClientAppID";
                    }
                    OEMPayType.HUAWEI_PAY -> {
                        val callbackUrl = "tpcsdk://com.thalesgroup.tpc.demo/tokenRequestorsPage"
                        oemConfig.callbackUrl = callbackUrl
                        oemConfig.activity = activity
                    }
                    OEMPayType.GOOGLE_PAY -> {
                        //Desde Push Provisioning SDK V1.9.0, la aplicación puede establecer `Context` en lugar de `Activity` durante la configuración de Push Provisioning SDK para Google Pay
                        oemConfig.context = applicationContext
                    }
                }
                configSdk(oemPayType, oemConfig).collect{
                    println(it)
                }
            }
        }
    }

    private fun configSdkForScheme(configs: Config): Flow<TPCResult<Boolean>> = callbackFlow {
        // Desde Push Provisioning SDK V2.0.0, para el push provisioning de esquema, no establezcas OEMPayType
        val callBack = object : TPCSDKListener<Boolean?> {
            override fun onStart() {}

            override fun onSuccess(result: TPCResult<Boolean?>) {
                Log.d("CONFIG_SDK", "Configuración de esquema exitosa...")
                channel.close()
            }

            override fun onError(exception: TPCSDKException) {
                Log.e("CONFIG_SDK", "La configuración de esquema falló con el error: " + exception.message)
                channel.close()
            }
        }
        TPCManager.getInstance().config(configs, callBack)
    }

    private fun configSdk(oemPayType: OEMPayType, configs: Config): Flow<TPCResult<Boolean>> =  callbackFlow {
        configs.oemPayType = oemPayType;
        val callBack = object : TPCSDKListener<Boolean?> {
            override fun onStart() {}
            override fun onSuccess(result: TPCResult<Boolean?>) {
                Log.d("CONFIG_SDK", "Configuración exitosa..." + oemPayType.oemType)
                channel.close()
            }

            override fun onError(exception: TPCSDKException) {
                Log.e("CONFIG_SDK", "La configuración falló con el error: " + exception.message)
                channel.close()

            }
        }
        TPCManager.getInstance().config(configs, callBack)
        
    }
}

Configuración de Samsung Pay

A partir de Android R (SDK de destino 30), debes declarar <queries> en el archivo de manifiesto de Android.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools" 
  package="xxx.xxx.xxx.xxx">
  
  <application>
    <!-- para Samsung Pay -->
    <meta-data
      android:name="debug_mode"
      android:value="${DEBUG_MODE}" />
    <!-- para Samsung Pay -->
    <meta-data
      android:name="spay_sdk_api_level"
      android:value="${SPAY_API_LEVEL}" />
  </application>
  
  <queries>
    <package android:name="com.samsung.android.spay" />
    <package android:name="com.samsung.android.samsungpay.gear" />
  </queries>

Ofuscación

Si tu aplicación tiene problemas de ProGuard con Samsung Pay, usa las siguientes reglas:

# Samsung Pay
-keep class com.samsung.android.sdk.** { *; }
-keep interface com.samsung.android.sdk.** { *; }

A continuación se muestran las reglas de ofuscación recomendadas por Google:

# Google Pay
# Conservar las clases e interfaces del cliente del SDK TapAndPay
-keep class com.google.android.gms.tapandpay.** { *; }

# Evitar la eliminación o el cambio de nombre de las clases SafeParcelable y sus campos CREATOR
-keep class * implements com.google.android.gms.common.internal.safeparcelable.SafeParcelable {
    public static final android.os.Parcelable$Creator *;
}

# Conservar los campos creador Parcelable estándar
-keepclassmembers class * implements android.os.Parcelable {
    public static final android.os.Parcelable$Creator CREATOR;
}