Enviar a los solicitantes de token (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 comerciantes de comercio electrónico y proveedores de billeteras.

Para la documentación del producto Mastercard, consulte Descripción general 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 envío 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 está autenticado en la aplicación del emisor.

• La aplicación del emisor ha inicializado el SDK D1 y completado el inicio de sesión.

• El consumidor y la tarjeta están registrados en D1.

Experiencia del usuario final

El diagrama a continuación 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

Recuperar los solicitantes de token elegibles para una tarjeta.

Enviar a un solicitante de token

Genere una URL de envío 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 utiliza el SDK 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 compatibles (por ejemplo, Android, iOS o web).

Ejemplo de interfaz de usuario de la aplicación del emisor para seleccionar un solicitante de token elegible.

Android

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

        override fun onSuccess(tkRequestorList: List<TokenRequestor>) {
            // Maneja el objeto tkRequestorList del servidor.
            // Ejemplo para mostrarlo en la interfaz de usuario como en la imagen de muestra 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 de gestión de errores de la integración del SDK D1.
        }
    }

    d1Task.getTokenRequestorList(cardID, callback)
}

iOS

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 una URL de envío llamando a addDigitalCardToScheme().

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

Ejemplo de interfaz de usuario de la aplicación del emisor para iniciar el flujo de envío de Token Connect.

Android

//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 a la que llama el solicitante de token al completar 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 de gestión de errores de la integración del SDK D1.
        }
    }

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

iOS

Qué sucede después

• El SDK D1 devuelve una URL de envío.

• La aplicación del emisor abre la URL de envío 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 el appURL.

• Para configurar appURL, implemente enlaces profundos 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 simplificada no es compatible.

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