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 para 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 aplicación 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 carpeta libs .
Desde Push Provisioning SDK v1.12.2, copie el archivo JAR de Samsung Pay SDK en la libs .
Abra el build.gradle o build.gradle.kts de la aplicación y agregue las siguientes dependencias:

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' // debug contiene logger
    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 files('lib/samsungpay_2.22.00.jar') // desde SDK v1.12.2
    implementation 'net.java.dev.jna:jna:5.17.0@aar'
}

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

dependencies {
    debugImplementation ("com.squareup.okhttp3:logging-interceptor:4.9.1") // debug contiene logger
    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 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 de árbol de archivos en la compilación de Gradle, abra el build.gradle o build.gradle.kts de la aplicación y agregue la siguiente dependencia:

dependencies {
    implementation fileTree(dir: "libs", include: ["*.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 aplicaciones recién desarrolladas y las actualizaciones de aplicaciones existentes enviadas a Google Play, y destinadas a dispositivos con Android 15 o superior, deben admitir tamaños de página de 16 KB. Esta compatibilidad está disponible para Push Provisioning SDK V1.12.0 y versiones posteriores.
Al compilar un APK que admite tamaños de página de 16 KB:
Actualice a Push Provisioning SDK V1.12.0 o posterior.
Actualice 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 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 aplicación se alinea automáticamente a tamaños de página de 16 KB. Si es anterior a 8.5.1, establezca las opciones de empaquetado heredadas en el archivo build.gradle .

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 de aplicación en lugar de una Activity al configurar Push Provisioning SDK para Google Pay y Samsung Pay. Una Activity solo es necesaria para la nueva API, addCard(Activity activity, CardInfo cardInfo, TPCSDKListener<T> listener), para el aprovisionamiento push de Google Pay.

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 puede actualizarse en consecuencia. Por ejemplo, es posible 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 Scheme Provisioning
            config.setContext(getApplicationContext());
        }
        configSdk(oemPayType, config);
    }
}

public void configSdk(OEMPayType oemPayType, Config configs) throws InterruptedException {
    // para push to scheme
    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();
}

class MainViewModel : ViewModel() {
    fun configureMultipleOEM(activity: Activity){
        viewModelScope.launch {
            val config = Config()
            config.issuerId = "ISSUERID"
            config.url = "URL" // URL correspondiente

            // La lista puede actualizarse en consecuencia. Por ejemplo, es posible 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 Scheme Provisioning
                        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 (target SDK 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 aplicación 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.** { *; }

AnteriorConfiguración del endpoint SiguienteiOS

Última actualización hace 2 meses

¿Te fue útil?