Usar correlationID

Obtener y establecer un ID de correlación para el seguimiento de la tokenización.

Descripción general

Cada proceso de tokenización tiene un correlationID asociado que puedes compartir con Thales para ayudar con la resolución de problemas.

Este identificador se puede obtener de dos maneras:

• A partir de una comprobación de elegibilidad exitosa o de un error de tokenización.
• También puedes asignar tu propio correlationID al llamar a checkEligibility() .

Disponible desde: 6.15.0

Integración del SDK

Obtener correlationID de checkEligibility()

• Después de una comprobación exitosa checkEligibility()

  • Después de una comprobación de elegibilidad exitosa, lee acceptanceData.correlationID.
  • Guarda este valor si necesitas rastrear el mismo proceso de tokenización más adelante.
• Después del error en checkEligibility()

  • Lee o guarda correlationID en cuanto se capture el error.

El siguiente ejemplo explica cómo obtener correlationID checkEligibility() :

mgCardEnrollmentService.checkEligibility(
    eligibilityData,
    instrumentData,
    object : CardEligibilityListener {
        override fun onSuccess(
            termsAndConditions: TermsAndConditions,
            issuerData: IssuerData
        ) {
            val correlationId = termsAndConditions.correlationId
            Log.d(TAG, "Correlation ID: $correlationId")
        }

        override fun onError(error: MobileGatewayError) {
            val correlationId = error.correlationId
            Log.e(TAG, "La digitalización falló. Correlation ID: $correlationId")
        }
    }
)

ProvisioningServiceError también proporciona getCorrelationId().

Establecer un correlationID personalizado

Puedes establecer correlationID solo en checkEligibility().

Las siguientes checkEligibility() variantes admiten este parámetro.

Usa un valor personalizado cuando quieras rastrear un proceso de tokenización a través del backend del emisor, la aplicación de cartera digital y los registros de Thales.

También puedes usar tu propio formato de identificador, por ejemplo:

ORDER-12345-SESSION-67890

Establecer un correlationID personalizado con datos del instrumento

val correlationId = UUID.randomUUID().toString()

mgCardEnrollmentService.checkEligibility(
    eligibilityData,
    instrumentData,
    correlationId,
    object : CardEligibilityListener {
        override fun onSuccess(
            termsAndConditions: TermsAndConditions,
            issuerData: IssuerData
        ) {
            val returnedCorrelationId = termsAndConditions.correlationId
            Log.d(TAG, "ID de correlación de digitalización: $returnedCorrelationId")
        }

        override fun onError(error: MobileGatewayError) {
            val returnedCorrelationId = error.correlationId
            Log.e(TAG, "La digitalización falló. Correlation ID: $returnedCorrelationId")
        }
    }
)

Establecer un correlationID personalizado con un pushSessionID

mgCardEnrollmentService.checkEligibility(
    eligibilityData,
    pushSessionId,
    correlationId,
    object : CardEligibilityListener {
        override fun onSuccess(
            termsAndConditions: TermsAndConditions,
            issuerData: IssuerData
        ) {
            val trackingId = termsAndConditions.correlationId
            Log.d(TAG, "ID de correlación del registro push: $trackingId")
        }

        override fun onError(error: MobileGatewayError) {
            val trackingId = error.correlationId
            Log.e(TAG, "Falló el registro push. Correlation ID: $trackingId")
        }
    }
)

Páginas relacionadas

• Comprobar la elegibilidad de la tarjeta
• Digitalización del flujo verde
• Digitalización del flujo amarillo
• Digitalización de una tarjeta