D1 SDK 4.4.0 の非同期 API

D1 SDK 4.4.0 の非同期 API

概要

D1 SDK 4.4.0 では、Android と iOS 向けに非同期 API の更新が導入されます。

Android では、更新された API はコルーチンベースの統合をサポートします。iOS では、更新された API は Swift concurrency をサポートします。これらの変更は Secure Card Display と Push Provisioning API に適用されます。

このガイドを使用して、影響を受ける API を確認し、イシュアアプリケーションを更新してください。

変更点

D1 SDK 4.4.0 では、以前の API サーフェスは非推奨になります。非推奨の API は、現在、関連する製品の下で提供されます:

• カード表示フローには Secure Card Display を使用します。
• ウォレットのデジタル化フローには Push Provisioning を使用します。

イシュアアプリケーションが非同期呼び出しを使用している場合は、移行中にそれらの呼び出しを更新してください:

• Android では、Kotlin のコルーチンベース API を使用します。
• iOS では、Swift concurrency ベース API を使用します。

このページには、4.4.0 で変更された API が一覧表示されています。

製品固有の API に移行する

1

現在の統合を確認する

イシュアアプリケーションで使用されている非推奨の D1 SDK API を特定します。

Secure Card Display と Push Provisioning のフローで使用される API に焦点を当てます。

2

製品固有の API に移行する

• 各非推奨 API を、対応する製品固有の API に置き換えます。
• カード表示機能には Secure Card Display API を使用します。
• ウォレットのデジタル化機能には Push Provisioning API を使用します。

3

非同期呼び出しを更新する

• Android では、既存の非同期呼び出しを Kotlin のコルーチンベース API に置き換えます。
• iOS では、既存の非同期呼び出しを Swift concurrency API に置き換えます。

4

移行後のフローを検証する

• 移行後にイシュアアプリケーションをビルドしてテストします。
• Secure Card Display と Push Provisioning のフローを検証します。

非同期処理を更新する

Android

イシュアアプリケーションが Kotlin コルーチンを使用している場合は、Kotlin のコルーチンベース API を使用します。

これにより、非同期コードが簡潔になり、コールバック処理が減ります。

Secure Card Display と Push Provisioning の呼び出しは現在、 Task<T> の代わりに Callback.

使用 await() コルーチンベースの統合では

をインポートします await 拡張を明示的に:

import com.thalesgroup.gemalto.d1.await

コルーチンベースの例:

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

           // PAN の下4桁
           val last4Pan = cardMetadata.last4Pan

           // CardAsset はカードデザインの表示に使用されます
           val cardAssets = cardMetadata.getAssetList().await()
           // アプリケーションロジックを続行します
       } catch (exception: D1Exception) {
           // D1 SDK Integration – Error Management セクションを参照してください
       }
   }
}

使用 execute(callback) コルーチンを使用しない統合では

public void getCardMetaData(@NonNull D1Task d1Task, @NonNull String cardID) {
   D1Task.Callback<CardMetadata> callback = new D1Task.Callback<CardMetadata>() {
       @Override
       public void onSuccess(CardMetadata cardMetadata) {
           // PAN の下4桁
           String last4Pan = cardMetadata.getLast4Pan();

           // 注: アセット一覧の取得は getAssetList() メソッドで別途処理されます
           // アプリケーションロジックを続行します
       }

       @Override
       public void onError(D1Exception exception) {
           // D1 SDK Integration – Error Management セクションを参照してください
       }
   };

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

iOS

4.4.0 の API 変更

このセクションで D1 SDK 4.4.0 で変更された API を確認してください。

各製品サービスを初期化します d1Task 製品 API を呼び出す前に。

Android

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

iOS

Secure Card Display

Android

getCardMetadata

前:

getCardMetadata(String cardID, Callback<CardMetadata> callback)

現在:

Task<CardMetadata> getCardMetadata(String cardID)

getCardDetails

前:

getCardDetails(String cardID, Callback<CardDetails> callback)

現在:

Task<CardDetails> getCardDetails(String cardID)

displayCardDetails

前:

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

現在:

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

iOS

Push Provisioning

Android

addDigitalCardToScheme

前:

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

現在:

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

addDigitalCardToOEM

前:

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

現在:

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

getTokenRequestorList

前:

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

現在:

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

getCardDigitizationState

前:

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

現在:

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

4.4.0 の新機能:

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

iOS