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 de Android que desean 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.
• Reutilice los servicios de Push Provisioning SDK en proyectos existentes.
• Inscriba el FPAN en Google Pay o Samsung Pay.
• Acceda 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 la funcionalidad completa de Google Pay, se recomienda ejecutarlo en dispositivos móviles.

Integración con la app emisora

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

• Copie el archivo AAR de Push Provisioning SDK en la libs carpeta.
• Desde Push Provisioning SDK v1.12.2, copie el archivo JAR de Samsung Pay SDK en la libs carpeta.
• Abra el build.gradle o build.gradle.kts de la aplicación y agregue 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' // la versión de depuración contiene el 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') // use el nombre de archivo más reciente de Push Provisioning SDK 
    implementation files('lib/samsungpay_2.22.00.jar') // desde la versión 1.12.2 del SDK
    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") // la versión de depuración contiene el registrador
    releaseImplementation ("com.squareup.okhttp3:okhttp:4.9.1")
    implementation ("com.google.android.gms:play-services-base:18.2.0")
    implementation (files("libs/tpcsdk.aar")) // use 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 usa 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 de árbol de archivos en la compilación de Gradle, abra el build.gradle o build.gradle.kts y agregue 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"))))
}

• Consulte 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 apps recién desarrolladas y las actualizaciones de apps existentes enviadas a Google Play, y destinadas a dispositivos con Android 15 o posterior, 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:

• Actualice a Push Provisioning SDK V1.12.0 o posterior.
• Actualice la dependencia JNA a la versión 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 usa una versión de AGP anterior a 8.0.2, puede encontrar problemas de compilación.
• Cuando la versión de AGP es 8.5.1 o posterior, la app se alinea automáticamente con tamaños de página de 16 KB. Si es anterior a 8.5.1, establezca las opciones de empaquetado heredadas en el build.gradle archivo.

Configuración

Use el siguiente fragmento para configurar Push Provisioning SDK en su aplicación móvil:

Nota

Desde Push Provisioning SDK V1.9.0, su aplicación puede establecer un Contexto en lugar de una 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 aprovisionamiento push 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); 
    Config config = new Config();
    config.setIssuerId("ISSUERID");
    config.setUrl("URL"); // URL correspondiente
    
    // La lista se puede actualizar en consecuencia. Por ejemplo, puede que solo necesite tener un tipo de OEMPayType.
    List<OEMPayType> oemPayTypes = Arrays.asList(
        OEMPayType.NONE,
        OEMPayType.GOOGLE_PAY,
        OEMPayType.SAMSUNG_PAY,
        OEMPayType.HUAWEI_PAY);

    for (OEMPayType oemPayType:oemPayTypes) {
        if (oemPayType == OEMPayType.SAMSUNG_PAY) {
            config.setContext(getApplicationContext());
            config.setServiceId("SERVICEID");
            config.setVisaClientAppId("VisaClientAppID");
        } else if (oemPayType == OEMPayType.HUAWEI_PAY) {
            String callbackUrl = "tpcsdk://com.thalesgroup.tpc.demo/tokenRequestorsPage";
            config.setCallbackUrl(callbackUrl);
            config.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
            config.setContext(getApplicationContext());
        } else if (oemPayType == OEMPayType.NONE) {
            //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
            config.setContext(getApplicationContext());
        }
        configSdk(oemPayType, config);
    }
}

public void configSdk(OEMPayType oemPayType, Config configs) throws InterruptedException {
    // para push a esquema
    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 {
            val config = Config()
            config.issuerId = "ISSUERID"
            config.url = "URL" // URL correspondiente

            // La lista se puede actualizar en consecuencia. Por ejemplo, puede que solo necesite tener un tipo de OEMPayType.
            val oemPayTypes: List<OEMPayType> = listOf(
                OEMPayType.NONE,
                OEMPayType.GOOGLE_PAY,
                OEMPayType.SAMSUNG_PAY,
                OEMPayType.HUAWEI_PAY
            )
            for (oemPayType in oemPayTypes) {
                when (oemPayType) {
                    OEMPayType.SAMSUNG_PAY -> {
                        config.serviceId = "SERVICEID"
                        config.context = applicationContext
                        config.visaClientAppId = "VisaClientAppID";
                    }
                    OEMPayType.HUAWEI_PAY -> {
                        val callbackUrl = "tpcsdk://com.thalesgroup.tpc.demo/tokenRequestorsPage"
                        config.callbackUrl = callbackUrl
                        config.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
                        config.context = applicationContext
                    }
                    OEMPayType.NONE -> {
                        //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
                        config.context = applicationContext
                    }
                }
                configSdk(oemPayType, config).collect{
                    println(it)
                }
            }
        }
    }

    private fun configSdk(oemPayType: OEMPayType, configs: Config): Flow<TPCResult<Boolean>> =  callbackFlow {
        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), debe 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 su app tiene problemas de ProGuard con Samsung Pay, use las siguientes reglas:

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