Android

Push Provisioning SDK は、Google Pay と Samsung Pay 用にカードをトークン化するために使用されます。この SDK は、Google Pay および Samsung Pay SDK との通信を処理します。また、イシュアアプリケーション向けのトークン化フローも簡素化します。

このセクションは、Push Provisioning SDK をアプリケーションに統合したい Android のイシュアアプリケーション開発者向けです。

利用可能なサービス

Thales Push Provisioning SDK は、以下のサービスを提供します。

イシュアアプリケーションを Push Provisioning SDK API と統合できるようにします。たとえば、 isCardDigitized および addCard （Google Pay と Samsung Pay）。
Google Pay および Samsung Pay SDK を理解する必要性を減らします。
既存のプロジェクトで Push Provisioning SDK のサービスを再利用できます。
FPAN を Google Pay または Samsung Pay に登録します。
TSH サーバー API にアクセスします。

前提条件

Java バージョン: 11
Android Studio バージョン: Chipmunk 以降。
Google Play Services を搭載したデバイス（Google Pay 用）。

Google Pay の全機能を利用するには、モバイルデバイスで実行することを推奨します。

イシュアアプリとの統合

という名前のフォルダを作成します libs を、次の図に示すようにモジュール（通常は「app」）ディレクトリ内に作成します。

Push Provisioning SDK の AAR ファイルを libs フォルダにコピーします。
Push Provisioning SDK v1.12.2 以降では、Samsung Pay SDK の JAR ファイルを libs フォルダにコピーします。
アプリの build.gradle または build.gradle.kts を開き、次の依存関係を追加します。

android {
  defaultConfig {
    ndk {
      abiFilters 'arm64-v8a', 'x86_64', 'armeabi-v7a', 'x86'
    }
  }
  buildTypes {
        debug {
            // Samsung Pay 用
            manifestPlaceholders = [DEBUG_MODE: 'Y', SPAY_API_LEVEL: 2.22]
        }
        release {
            // Samsung Pay 用
            manifestPlaceholders = [DEBUG_MODE: 'N' , SPAY_API_LEVEL: 2.22]
        }
    }
}

dependencies {
    debugImplementation 'com.squareup.okhttp3:logging-interceptor:4.9.1' // デバッグには logger が含まれます
    releaseImplementation 'com.squareup.okhttp3:okhttp:4.9.1'
    implementation "com.google.android.gms:play-services-base:18.5.0"
    implementation "com.google.android.gms:play-services-basement:18.5.0"
    implementation files('libs/tpcsdk.aar') // 最新の Push Provisioning SDK のファイル名を使用します 
    implementation files('lib/samsungpay_2.22.00.jar') // SDK v1.12.2 以降
    implementation 'net.java.dev.jna:jna:5.17.0@aar'
}

android {
  defaultConfig {
    ndk {
      abiFilters += listOf("arm64-v8a", "x86_64", "armeabi-v7a", "x86")
    }
  }
}

dependencies {
    debugImplementation ("com.squareup.okhttp3:logging-interceptor:4.9.1") // デバッグには logger が含まれます
    releaseImplementation ("com.squareup.okhttp3:okhttp:4.9.1")
    implementation ("com.google.android.gms:play-services-base:18.2.0")
    implementation (files("libs/tpcsdk.aar")) // 最新の Push Provisioning SDK のファイル名を使用します 
    implementation ("net.java.dev.jna:jna:5.17.0@aar")
}

注意
Push Provisioning SDK V1.7.0 以降では、JNA ライブラリが依存関係として使用されます。Push Provisioning SDK で他のバージョンが動作する保証はないため、JNA V5.5.0 の使用を推奨します。
Push Provisioning SDK V1.12.0 以降では、16 KB ページサイズをサポートするために JNA V5.17.0 の使用が必須です。

file-tree 依存関係を Gradle ビルドに取り込むには、アプリの build.gradle または build.gradle.kts を開き、次の依存関係を追加します。

dependencies {
    implementation fileTree(dir: "libs", include: ["*.jar", "*.aar"])
}

Push Provisioning SDK API の使用方法については、サンプルアプリと Java ドキュメントを参照してください。

16 KB ページサイズのサポート
2025 年 11 月 1 日以降、Google Play に提出される新規開発アプリおよび既存アプリの更新で、Android 15 以降のデバイスを対象とするものは、16 KB ページサイズをサポートする必要があります。このサポートは Push Provisioning SDK V1.12.0 以降で利用できます。
16 KB ページサイズをサポートする APK をビルドする場合:
Push Provisioning SDK V1.12.0 以降にアップグレードします。
JNA 依存関係を 5.17.0 以降にアップグレードします。JNA 5.17.0 では、必要な Android Gradle Plugin (AGP) バージョンは 8.0.2 以降です。8.0.2 より前の AGP を使用している場合、コンパイルの問題が発生する可能性があります。
AGP のバージョンが 8.5.1 以降の場合、アプリは自動的に 16 KB ページサイズに合わせて調整されます。8.5.1 より前の場合は、レガシーのパッケージングオプションをで build.gradle ファイルに設定します。

構成

次のスニペットを使用して、モバイルアプリケーションで Push Provisioning SDK を構成します。

注意
Push Provisioning SDK V1.9.0 以降では、アプリケーションはアプリケーション Context の代わりに Activity を設定できます。これは Google Pay と Samsung Pay 用の Push Provisioning SDK を構成する場合です。 Activity 新しい API でのみ必要です。 addCard(Activity activity, CardInfo cardInfo, TPCSDKListener<T> listener)。Google Pay のプッシュプロビジョニング用です。

protected static final int HTTP_TIMEOUT = 60;

protected CountDownLatch mCountDownLatch;

protected void awaitCountDownLatch() {
    try {
        mCountDownLatch.await(HTTP_TIMEOUT, TimeUnit.SECONDS);
    } catch (Exception e) { // 無視します。
    }
}

protected void resetCountDownLatch() {
    mCountDownLatch = new CountDownLatch(1);
}

@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState); 
    Config config = new Config();
    config.setIssuerId("ISSUERID");
    config.setUrl("URL"); // 対応する URL
    
    // リストは必要に応じて更新できます。たとえば、OEMPayType を 1 種類だけにするだけでよい場合があります。
    List<OEMPayType> oemPayTypes = Arrays.asList(
        OEMPayType.NONE,
        OEMPayType.GOOGLE_PAY,
        OEMPayType.SAMSUNG_PAY,
        OEMPayType.HUAWEI_PAY);

    for (OEMPayType oemPayType:oemPayTypes) {
        if (oemPayType == OEMPayType.SAMSUNG_PAY) {
            config.setContext(getApplicationContext());
            config.setServiceId("SERVICEID");
            config.setVisaClientAppId("VisaClientAppID");
        } else if (oemPayType == OEMPayType.HUAWEI_PAY) {
            String callbackUrl = "tpcsdk://com.thalesgroup.tpc.demo/tokenRequestorsPage";
            config.setCallbackUrl(callbackUrl);
            config.setActivity(getActivity());
        } else if (oemPayType == OEMPayType.GOOGLE_PAY) {
            //Push Provisioning SDK V1.9.0 以降、Google Pay 用の Push Provisioning SDK 構成時に、アプリケーションは `Activity` の代わりに `Context` を設定できます
            config.setContext(getApplicationContext());
        } else if (oemPayType == OEMPayType.NONE) {
            //Push Provisioning SDK V1.9.0 以降、Scheme Provisioning 用の Push Provisioning SDK 構成時に、アプリケーションは `Activity` の代わりに `Context` を設定できます
            config.setContext(getApplicationContext());
        }
        configSdk(oemPayType, config);
    }
}

public void configSdk(OEMPayType oemPayType, Config configs) throws InterruptedException {
    // シェームへのプッシュ用
    configs.setOemPayType(oemPayType);
    resetCountDownLatch();
    TPCManager.getInstance().config(configs, new TPCSDKListener<Boolean>() {
        @Override
        public void onStart() {
        }

        @Override
        public void onSuccess(TPCResult<Boolean> result) {
            Log.d("CONFIG_SDK", "Configuration successful..." + oemPayType.getOemType());
            mCountDownLatch.countDown();
        }

        @Override
        public void onError(TPCSDKException exception) {
            Log.e("CONFIG_SDK", "Configuration setup failed with error: " + exception.getMessage());
            mCountDownLatch.countDown();
        }
    });
    awaitCountDownLatch();
}

class MainViewModel : ViewModel() {
    fun configureMultipleOEM(activity: Activity){
        viewModelScope.launch {
            val config = Config()
            config.issuerId = "ISSUERID"
            config.url = "URL" // 対応する URL

            // リストは必要に応じて更新できます。たとえば、OEMPayType を 1 種類だけにするだけでよい場合があります。
            val oemPayTypes: List<OEMPayType> = listOf(
                OEMPayType.NONE,
                OEMPayType.GOOGLE_PAY,
                OEMPayType.SAMSUNG_PAY,
                OEMPayType.HUAWEI_PAY
            )
            for (oemPayType in oemPayTypes) {
                when (oemPayType) {
                    OEMPayType.SAMSUNG_PAY -> {
                        config.serviceId = "SERVICEID"
                        config.context = applicationContext
                        config.visaClientAppId = "VisaClientAppID";
                    }
                    OEMPayType.HUAWEI_PAY -> {
                        val callbackUrl = "tpcsdk://com.thalesgroup.tpc.demo/tokenRequestorsPage"
                        config.callbackUrl = callbackUrl
                        config.activity = activity
                    }
                    OEMPayType.GOOGLE_PAY -> {
                        //Push Provisioning SDK V1.9.0 以降、Google Pay 用の Push Provisioning SDK 構成時に、アプリケーションは `Activity` の代わりに `Context` を設定できます
                        config.context = applicationContext
                    }
                    OEMPayType.NONE -> {
                        //Push Provisioning SDK V1.9.0 以降、Scheme Provisioning 用の Push Provisioning SDK 構成時に、アプリケーションは `Activity` の代わりに `Context` を設定できます
                        config.context = applicationContext
                    }
                }
                configSdk(oemPayType, config).collect{
                    println(it)
                }
            }
        }
    }

    private fun configSdk(oemPayType: OEMPayType, configs: Config): Flow<TPCResult<Boolean>> =  callbackFlow {
        val callBack = object : TPCSDKListener<Boolean?> {
            override fun onStart() {}
            override fun onSuccess(result: TPCResult<Boolean?>) {
                Log.d("CONFIG_SDK", "Configuration successful..." + oemPayType.oemType)
                channel.close()
            }

            override fun onError(exception: TPCSDKException) {
                Log.e("CONFIG_SDK", "Configuration setup failed with error: " + exception.message)
                channel.close()

            }
        }
        TPCManager.getInstance().config(configs, callBack)
        
    }
}

Samsung Pay の構成

Android R（target SDK 30）以降では、 <queries> を Android マニフェストファイルに宣言する必要があります。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools" 
  package="xxx.xxx.xxx.xxx">
  
  <application>
    <!-- Samsung Pay 用 -->
    <meta-data
      android:name="debug_mode"
      android:value="${DEBUG_MODE}" />
    <!-- Samsung Pay 用 -->
    <meta-data
      android:name="spay_sdk_api_level"
      android:value="${SPAY_API_LEVEL}" />
  </application>
  
  <queries>
    <package android:name="com.samsung.android.spay" />
    <package android:name="com.samsung.android.samsungpay.gear" />
  </queries>

難読化

アプリで Samsung Pay に関する ProGuard の問題がある場合は、次のルールを使用してください。

# Samsung Pay
-keep class com.samsung.android.sdk.** { *; }
-keep interface com.samsung.android.sdk.** { *; }

前へエンドポイントの設定次へiOS

最終更新 28 日前

役に立ちましたか？