カードのメタデータを表示する

概要

このセクションでは、イシュアアプリケーションにおける機密性の低いカードデータの表示方法について説明します。

ユーザーエクスペリエンス

シーケンス図

前提条件：

• エンドユーザーとカードがD1バックエンドに登録されていること。

• D1 SDKが適切に初期化されていること。

• イシュアアプリケーションがD1 SDKのログインAPIを呼び出していること。

基づいて、 cardID 値により、イシュアアプリケーションは最後の4桁のPAN、有効期限、カードの画像背景など、カードの基本情報をエンドユーザーに表示できます。

D1 SDKは公開の getCardMetaData() APIを公開してカード情報を取得します。 CardMetadata.cardAssetArray() iOS向けのAPIと、 CardMetadata.getAssetList() Android向けのAPIがカードアセットを取得するために提供されています。

D1が発行したカードについては、“State Reason”や“Ongoing Operation”などの追加のカード情報をCardMetadata.getStateReason()およびCardMetadata.getOngoingOperation()のAPIで取得できます。

カードの一覧は getCardList() 操作で取得できます。

Android

String cardID = ""; // バックエンドから受け取ったカードID
D1Task.Callback<CardMetadata> callback = new D1Task.Callback<CardMetadata>() {
    @Override
    public void onSuccess(CardMetadata cardMetadata) {
        // PANの下4桁
        String last4Pan = cardMetadata.getLast4Pan();

        StateReason reason = cardMetadata.getStateReason();
        OngoingOperation ongoingOperation = cardMetadata.getOngoingOperation();

        // CardAssetはカードデザインを表示するために使用されます
        cardMetadata.getAssetList(new D1Task.Callback<List<CardAsset>>() {
            @Override
            public void onSuccess(List<CardAsset> cardAssets) {
                // アプリケーションロジックを続行します                                    
            }
            @Override
            public void onError(@NonNull D1Exception e) {
                // エラーを処理します。例えば、ログに記録したり表示したりします。 
            }
        });
    }

    @Override
    public void onError(D1Exception exception) {
        // D1 SDK 統合 – エラー管理セクションを参照してください。
    }
};

d1Task.getCardMetadata(cardID, callback);

iOS