APIs asíncronas en D1 SDK 4.4.0

APIs asíncronas en D1 SDK 4.4.0

Descripción general

D1 SDK 4.4.0 introduce actualizaciones de API asíncronas para Android e iOS.

En Android, las APIs actualizadas admiten integraciones basadas en corrutinas. En iOS, las APIs actualizadas admiten la concurrencia de Swift. Estos cambios se aplican a las APIs de Secure Card Display y Push Provisioning.

Usa esta guía para revisar las APIs afectadas y actualizar tu aplicación emisora.

Qué cambió

La superficie de API anterior está obsoleta en D1 SDK 4.4.0. Las APIs obsoletas ahora se proporcionan bajo el producto correspondiente:

• Usa Secure Card Display para los flujos de visualización de tarjetas.
• Usa Push Provisioning para los flujos de digitalización de la billetera.

Si tu aplicación emisora usa llamadas asíncronas, actualiza esas llamadas durante la migración:

• En Android, usa las APIs basadas en corrutinas de Kotlin.
• En iOS, usa las APIs basadas en la concurrencia de Swift.

Esta página enumera las APIs cambiadas en 4.4.0.

Migra a las APIs específicas del producto

1

Revisa tu integración actual

Identifica las APIs obsoletas de D1 SDK usadas por tu aplicación emisora.

Céntrate en las APIs usadas para los flujos de Secure Card Display y Push Provisioning.

2

Pasa a las APIs específicas del producto

• Reemplaza cada API obsoleta por la API específica del producto correspondiente.
• Usa las APIs de Secure Card Display para las funciones de visualización de tarjetas.
• Usa las APIs de Push Provisioning para las funciones de digitalización de la billetera.

3

Actualiza las llamadas asíncronas

• En Android, reemplaza las llamadas asíncronas existentes con las APIs basadas en corrutinas de Kotlin.
• En iOS, reemplaza las llamadas asíncronas existentes con las APIs de concurrencia de Swift.

4

Valida los flujos migrados

• Compila y prueba tu aplicación emisora después de la migración.
• Valida los flujos de Secure Card Display y Push Provisioning.

Actualiza la gestión asíncrona

Android

Usa las APIs basadas en corrutinas de Kotlin si tu aplicación emisora usa corrutinas de Kotlin.

Esto simplifica el código asíncrono y reduce la gestión de callbacks.

Las llamadas de Secure Card Display y Push Provisioning ahora devuelven Task<T> en lugar de usar Callback.

Usa await() en integraciones basadas en corrutinas

Importa la extensión await explícitamente:

import com.thalesgroup.gemalto.d1.await

Ejemplo basado en corrutinas:

fun getCardMetaData(d1Task: D1Task, cardID: String, activity: FragmentActivity) {
   activity.lifecycleScope.launch {
       try {
           val cardMetadata = d1Task.secureCardDisplayService.getCardMetadata(cardID).await()

           // Últimos 4 dígitos del PAN
           val last4Pan = cardMetadata.last4Pan

           // CardAsset se usa para mostrar el arte de la tarjeta
           val cardAssets = cardMetadata.getAssetList().await()
           // Continúa con la lógica de la aplicación
       } catch (exception: D1Exception) {
           // Consulta la sección de Integración de D1 SDK – Gestión de errores
       }
   }
}

Usa execute(callback) en integraciones sin corrutinas

public void getCardMetaData(@NonNull D1Task d1Task, @NonNull String cardID) {
   D1Task.Callback<CardMetadata> callback = new D1Task.Callback<CardMetadata>() {
       @Override
       public void onSuccess(CardMetadata cardMetadata) {
           // Últimos 4 dígitos del PAN
           String last4Pan = cardMetadata.getLast4Pan();

           // Nota: la obtención de la lista de activos se gestiona por separado en el método getAssetList()
           // Continúa con la lógica de la aplicación
       }

       @Override
       public void onError(D1Exception exception) {
           // Consulta la sección de Integración de D1 SDK – Gestión de errores
       }
   };

   d1Task.getSecureCardDisplayService().getCardMetadata(cardID).execute(callback);
}

iOS

Cambios de API en 4.4.0

Usa esta sección para revisar las APIs cambiadas en D1 SDK 4.4.0.

Inicializa cada servicio de producto desde d1Task antes de llamar a las APIs del producto.

Android

val pushProvisioningService = d1Task.pushProvisioningService
val secureCardDisplayService = d1Task.secureCardDisplayService

iOS

Secure Card Display

Android

getCardMetadata

Antes:

getCardMetadata(String cardID, Callback<CardMetadata> callback)

Ahora:

Task<CardMetadata> getCardMetadata(String cardID)

getCardDetails

Antes:

getCardDetails(String cardID, Callback<CardDetails> callback)

Ahora:

Task<CardDetails> getCardDetails(String cardID)

displayCardDetails

Antes:

displayCardDetails(String cardID, CardDetailsUI cardDetailsUI, Callback<Void> callback)

Ahora:

Task<Void> displayCardDetails(String cardID, CardDetailsUI cardDetailsUI)

iOS

Push Provisioning

Android

addDigitalCardToScheme

Antes:

addDigitalCardToScheme(String cardID, TokenRequestor tokenRequestor, String appURL, boolean tcsAccepted, Callback<String> callback)

Ahora:

Task<String> addDigitalCardToScheme(String cardID, TokenRequestor tokenRequestor, String appURL, boolean tcsAccepted)

addDigitalCardToOEM

Antes:

addDigitalCardToOEM(String cardID, OEMPayType oemType, Activity activity, D1Task.Callback<Object> callback)

Ahora:

Task<Object> addDigitalCardToOEM(String cardID, OEMPayType oemType, Activity activity, int options)

getTokenRequestorList

Antes:

getTokenRequestorList(String cardID, Callback<List<TokenRequestor>> callback)

Ahora:

Task<List<TokenRequestor>> getTokenRequestorList(String cardID)

getCardDigitizationState

Antes:

getCardDigitizationState(String cardID, OEMPayType oemType, D1Task.Callback<CardDigitizationState> callback)

Ahora:

Task<CardDigitizationState> getCardDigitizationState(String cardID, OEMPayType oemType)

Nuevo en 4.4.0:

Task<CardDigitizationState> getCardDigitizationState(OEMPayType oemType, String last4)

iOS