correlationIDを使用する

Tokenization追跡用のcorrelation IDを取得および設定します。

概要

各トークナイゼーション処理には関連する correlationID があり、トラブルシューティングのためにThalesと共有できます。

この識別子は2つの方法で取得できます:

• 有効性チェックの成功、またはトークナイゼーションエラーから取得します。
• 独自のカスタム correlationID を呼び出すときに check有効性() .

利用可能開始: 6.15.0

SDK統合

取得 correlationID から check有効性()

• 成功後 check有効性()

  • 有効性チェックが成功した後、 acceptanceData.correlationID.
  • 後で同じトークナイゼーション処理を追跡する必要がある場合は、この値を保存してください。
• でエラー発生後 check有効性()

  • 読み取るか保存する correlationID エラーが捕捉されたらすぐに。

次の例では、 correlationID check有効性() :

mgCardEnrollmentService.check有効性(
    eligibilityData,
    instrumentData,
    object : CardEligibilityListener {
        override fun onSuccess(
            termsAndConditions: TermsAndConditions,
            issuerData: イシュアData
        ) {
            val correlationId = termsAndConditions.correlationId
            Log.d(TAG, "Correlation ID: $correlationId")
        }

        override fun onError(error: MobileGatewayError) {
            val correlationId = error.correlationId
            Log.e(TAG, "デジタル化に失敗しました。Correlation ID: $correlationId")
        }
    }
)

ProvisioningServiceError も提供します getCorrelationId().

カスタムcorrelationIDを設定

設定できます correlationID のみ check有効性().

次の check有効性() バリアントがこのパラメータをサポートしています。

イシュアのバックエンド、デジタルウォレットアプリケーション、Thalesのログをまたいでトークナイゼーション処理を追跡したい場合は、カスタム値を使用します。

独自の識別子形式を使うこともできます。たとえば:

ORDER-12345-SESSION-67890

instrument dataを使ってカスタムcorrelationIDを設定

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

mgCardEnrollmentService.check有効性(
    eligibilityData,
    instrumentData,
    correlationId,
    object : CardEligibilityListener {
        override fun onSuccess(
            termsAndConditions: TermsAndConditions,
            issuerData: イシュアData
        ) {
            val returnedCorrelationId = termsAndConditions.correlationId
            Log.d(TAG, "デジタル化のCorrelation ID: $returnedCorrelationId")
        }

        override fun onError(error: MobileGatewayError) {
            val returnedCorrelationId = error.correlationId
            Log.e(TAG, "デジタル化に失敗しました。Correlation ID: $returnedCorrelationId")
        }
    }
)

pushSessionIDを使ってカスタムcorrelationIDを設定

mgCardEnrollmentService.check有効性(
    eligibilityData,
    pushSessionId,
    correlationId,
    object : CardEligibilityListener {
        override fun onSuccess(
            termsAndConditions: TermsAndConditions,
            issuerData: イシュアData
        ) {
            val trackingId = termsAndConditions.correlationId
            Log.d(TAG, "プッシュ登録のCorrelation ID: $trackingId")
        }

        override fun onError(error: MobileGatewayError) {
            val trackingId = error.correlationId
            Log.e(TAG, "プッシュ登録に失敗しました。Correlation ID: $trackingId")
        }
    }
)

関連ページ

• カードの有効性を確認
• Green flow のデジタル化
• Yellow flow のデジタル化
• カードをデジタル化する