Push a solicitantes de tokens (Token Connect)

Enviar a solicitantes de token (Token Connect)

Utilice esta guía para enviar una tarjeta desde la aplicación del emisor a un solicitante de token usando Mastercard MDES Token Connect.

Los solicitantes de token pueden incluir comercios de comercio electrónico y proveedores de carteras.

Para la documentación de productos de Mastercard, consulte Resumen de MDES Token Connect.

Descripción general

Con Token Connect, la aplicación del emisor:

1. Recupera la lista de solicitantes de token elegibles para una tarjeta.
2. Solicita una URL de push para el solicitante de token seleccionado.
3. Redirige al usuario final a la experiencia del solicitante de token para completar Tokenización.

Requisitos previos

• El usuario final se autentica en la aplicación del emisor.
• La aplicación del emisor ha inicializado el SDK de D1 y ha completado el inicio de sesión.
• El consumidor y la tarjeta están registrados en D1.

Experiencia del usuario final

El siguiente diagrama ilustra un flujo representativo de Token Connect. El mismo patrón se aplica a cualquier solicitante de token compatible con Token Connect.

Ejemplo de experiencia del usuario final para enviar una tarjeta a un solicitante de token usando Token Connect.

Flujo

Recuperar solicitantes de token elegibles

Recupere los solicitantes de token elegibles para una tarjeta.

Enviar a un solicitante de token

Genere una URL de push para el solicitante de token seleccionado y redirija al usuario final.

Diagramas de secuencia

1

Obtener solicitantes de token elegibles

La aplicación del emisor usa el SDK de D1 para recuperar la lista de solicitantes de token que admiten Token Connect para una tarjeta determinada.

Cada solicitante de token incluye:

• Un nombre para mostrar.
• Un logotipo de marca.
• Uno o más métodos de aprovisionamiento admitidos (por ejemplo, Android, iOS o web).

Android >= 4.4.0

fun getEligibleTokenRequestors(d1Task: D1Task, cardID: String) {
    activity.lifecycleScope.launch(Dispatchers.Main) {
        try {
            val tkRequestorList = withContext(Dispatchers.IO) {
                d1Task.pushProvisioningService.getTokenRequestorList(
                    cardID
                ).await()
            }

            // Gestionar el objeto tkRequestorList del servidor
            // Ej.: para mostrarlo en la interfaz de usuario como la imagen de ejemplo anterior
            for (tkRequestor : TokenRequestor in tkRequestorList) {
                val tkRequestorID : String = tkRequestor.id
                val tkRequestorName : String = tkRequestor.name
                val tkRequestorAssets : MutableList<AssetContent>? = tkRequestor.assets // Logotipo del solicitante de token
                val tkrProvisioningMethods : MutableList<ProvisioningMethod> = tkRequestor.provisioningMethods // Métodos de aprovisionamiento del solicitante de token
            }
        } catch (exception: D1Exception) {
            // Consulta la sección Integración del SDK D1 – Gestión de errores
        }
    }
}

Android < 4.4.0

fun getEligibleTokenRequestors(d1Task: D1Task, cardID: String) {
    val callback: D1Task.Callback<List<TokenRequestor>> = object : D1Task.Callback<List<TokenRequestor>> {

        override fun onSuccess(tkRequestorList: List<TokenRequestor>) {
            // Gestiona el objeto tkRequestorList del servidor.
            // Ejemplo para mostrarlo en la interfaz de usuario como la imagen de ejemplo anterior.
            for (tkRequestor : TokenRequestor in tkRequestorList) {
                val tkRequestorID : String = tkRequestor.id
                val tkRequestorName : String = tkRequestor.name
                val tkRequestorAssets : MutableList<AssetContent>? = tkRequestor.assets // Logotipo del solicitante de token.
                val tkrProvisioningMethods : MutableList<ProvisioningMethod> = tkRequestor.provisioningMethods // Métodos de aprovisionamiento del solicitante de token.
            }
        }

        override fun onError(exception: D1Exception) {
            // Consulte la sección Integración del SDK de D1 – Gestión de errores.
        }
    }

    d1Task.getTokenRequestorList(cardID, callback)
}

iOS >= 4.4.0

let cardID = "" // obtenido, por ejemplo, del servidor
        
do {
    let service = try d1Task.pushProvisioningService()
    let tokenRequestors = try await service.tokenRequestorList(cardID)
    // Mostrar tokenRequestors en la interfaz de usuario
    for tokenRequestor in tokenRequestors {
        print("ID: \(tokenRequestor.id ?? \"\")")
        print("Nombre: \(tokenRequestor.name ?? \"\")")

        if let asset = tokenRequestor.asset?.first,
           let imageData = Data(base64Encoded: asset.encodedData) {
            let image = UIImage(data: imageData)
            _ = image
        }
    }
} catch let d1Error as D1Error {
    // Consulta la sección Integración del SDK D1 – Gestión de errores
} catch let error {
    // Gestiona otro error
}

iOS < 4.4.0

let cardID = "" // Obtenido, por ejemplo, de su backend

d1Task.tokenRequestorList(cardID) { tokenRequestors, error in
    if let error = error {
        // Consulte la sección de gestión de errores de integración del SDK D1
    } else if let tokenRequestors = tokenRequestors {
        // Mostrar tokenRequestors en la interfaz de usuario
        for tokenRequestor in tokenRequestors {
            print("ID: \(tokenRequestor.id ?? \"\")")
            print("Nombre: \(tokenRequestor.name ?? \"\")")

            if let asset = tokenRequestor.asset?.first,
               let imageData = Data(base64Encoded: asset.encodedData) {
                let image = UIImage(data: imageData)
                _ = image
            }
        }
    }
}

2

Enviar una tarjeta a un solicitante de token

Después de que el usuario final selecciona un solicitante de token, la aplicación del emisor solicita un URL de push llamando a addDigitalCardToScheme().

La aplicación del emisor luego redirige al usuario final al solicitante de token usando la URL de push devuelta.

Android >= 4.4.0

fun pushCardToTokenRequestor(d1Task: D1Task, cardID: String, tokenRequestor: TokenRequestor) {
    val appURL = "d1demoapp://com.thalesgroup.gemalto.d1.validation/PushToSchemeResult" // La URL personalizada de la aplicación del emisor que el solicitante de token llama al finalizar el flujo de digitalización
    val tcsAccepted = true

    // Para Click to Pay, el valor del atributo Mastercard tokenRequester.id es 50123197928.
    activity.lifecycleScope.launch(Dispatchers.Main) {
        try {
            val pushUrl = withContext(Dispatchers.IO) {
                d1Task.pushProvisioningService.addDigitalCardToScheme(
                    cardID,
                    tokenRequestor,
                    appURL,
                    tcsAccepted
                ).await()
            }
            // Iniciar la aplicación del solicitante de token
            activity.startActivity(Intent(Intent.ACTION_VIEW, Uri.parse(pushUrl)))
        } catch (exception: D1Exception) {
            // Consulta la sección Integración del SDK D1 – Gestión de errores
        }
    }
}

Android < 4.4.0

//cardID: Recibido con la API getConsumerDetails.
//tokenRequestor: Seleccionado por el usuario.
fun pushCardToTokenRequestor(d1Task: D1Task, cardID: String, tokenRequestor: TokenRequestor) {
    val appURL = "d1demoapp://com.thalesgroup.gemalto.d1.validation/PushToSchemeResult" // La URL personalizada de la aplicación del emisor que el solicitante de token llama al finalizar el flujo de digitalización.
    val tcsAccepted = true

    val callback: D1Task.Callback<String> = object : D1Task.Callback<String> {

        override fun onSuccess(pushUrl: String) {
            // Inicia la aplicación del solicitante de token.
            getActivity().startActivity(Intent(Intent.ACTION_VIEW, Uri.parse(pushUrl)))
        }

        override fun onError(exception: D1Exception) {
            // Consulte la sección Integración del SDK de D1 – Gestión de errores.
        }
    }

    // Para Click to Pay, el valor del atributo Mastercard tokenRequestor.id es 50123197928.
    d1Task.addDigitalCardToScheme(
        cardID,
        tokenRequestor,
        appURL,
        tcsAccepted,
        callback
    )
}

iOS >= 4.4.0

let provisionMethod = PushProvisioningService.ProvisioningMethod(pushHandler: "pushHandler", platformType: "iOS")
let tokenRequestor = PushProvisioningService.TokenRequestor(id: "test", name: "test", asset: nil, provisioningMethods: [provisionMethod])
let cardID = "" // obtenido, por ejemplo, del servidor
let appURL = "test://sample.com.demo/tokenRequestorsPage"
// la URL de la aplicación del emisor, que se configura mediante el mecanismo de deep link.
// La aplicación del solicitante de token llamará a esta URL para pasar el resultado de la información de la tarjeta enviada.
do {
    let service = try d1Task.pushProvisioningService()
    let provisionString = try await service.addDigitalCardToScheme(cardID,
                                                                   tokenRequestor: tokenRequestor,
                                                                   appURL: appURL,
                                                                   termsAndConditionsAccepted: true)
    if let provisionURL = URL(string: provisionString) {
        if await UIApplication.shared.canOpenURL(provisionURL) {
            await UIApplication.shared.open(provisionURL)
        }
    }
} catch let d1Error as D1Error {
    // Consulta la sección Integración del SDK D1 – Gestión de errores
} catch let error {
    // Gestiona otro error
}

iOS < 4.4.0

let cardID = "" // Obtenido, por ejemplo, de su backend

// La URL de deep link de la aplicación del emisor que el solicitante de token llama después del flujo de tokenización.
let appURL = "test://sample.com.demo/tokenRequestorsPage"

// tokenRequestor es seleccionado por el usuario final y devuelto por tokenRequestorList().

d1Task.addDigitalCardToScheme(
    cardID,
    tokenRequestor: tokenRequestor,
    appURL: appURL,
    termsAndConditionsAccepted: true
) { provisionString, error in
    if let error = error {
        // Consulte la sección de gestión de errores de integración del SDK D1
    } else if let provisionString = provisionString,
              let pushUrl = URL(string: provisionString),
              UIApplication.shared.canOpenURL(pushUrl) {
        UIApplication.shared.open(pushUrl)
    }
}

Qué sucede a continuación

• El SDK de D1 devuelve una URL de push.
• La aplicación del emisor abre la URL de push en la aplicación del solicitante de token o en una vista web.
• El solicitante de token realiza el flujo de tokenización.
• Cuando el flujo se completa, el solicitante de token redirige al usuario final de vuelta a la aplicación del emisor usando la appURL.

• Para configurar appURL, implemente deep links en su aplicación del emisor: Android, iOS.
• El solicitante de token devuelve el resultado de la tokenización a la aplicación del emisor. Para obtener detalles, consulte la guía de Mastercard: Recibir respuesta del solicitante de token.

Mastercard activación optimizada no es compatible.

Para obtener acceso completo al SDK de D1, consulte referencia de la API.