3. Application manifest file

Configure AndroidManifest.xml so the NFC Wallet SDK can run correctly.

Android permissions

Declare the following permissions in AndroidManifest.xml:

Android permission	Requirement	Description
android.permission.INTERNET	Required	Enable network calls (for example, enrollment and payment key replenishment).
android.permission.NFC	Required	Enable NFC access for contactless payment.
android.permission.USE_BIOMETRIC	Conditional	Enable biometric authentication as CDCVM.
android.permission.USE_FINGERPRINT	Conditional	Support Android 9 and earlier when using biometrics as CDCVM.

Declare NFC features

For contactless payment, the device must support:

• android.hardware.nfc
• android.hardware.nfc.hce

Option A: Filter unsupported devices in Google Play

Declare both features as required:

<uses-feature android:name="android.hardware.nfc" android:required="true" />
<uses-feature android:name="android.hardware.nfc.hce" android:required="true" />

uses-feature declarations filter your application in Google Play to compatible devices only.

Option B: Allow install and check at runtime

If you cannot filter device compatibility in Google Play, check feature support using the Android APIs:

public static boolean doesDeviceSupportHCE(@NonNull final Context context) {
    final PackageManager pm = context.getPackageManager();
    final boolean hasNfc = pm.hasSystemFeature(PackageManager.FEATURE_NFC);
    final boolean supportsHce = pm.hasSystemFeature(PackageManager.FEATURE_NFC_HOST_CARD_EMULATION);
    
    if (!hasNfc || !supportsHce) {
        // The device does not support NFC or HCE.
        return false;    
    }
    return true;
}

Enable CPS communication service

Enable CPSCommService to process CPS message communication.

<!-- CPS communication service -->
<service
    android:name="com.gemalto.mfs.mwsdk.provisioning.push.CPSCommService"
    android:enabled="true"
    android:exported="false" />

Disable backup and restore

Disable Android application backup and restore.

<application
    android:allowBackup="false">

Example AndroidManifest.xml

This example shows the typical declarations you need. Adjust names and metadata to your digital wallet application.

<manifest xmlns:android="http://schemas.android.com/apk/res/android">

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.NFC" />
    <uses-permission android:name="android.permission.USE_BIOMETRIC" />
    <uses-permission android:name="android.permission.USE_FINGERPRINT" />

    <uses-feature android:name="android.hardware.nfc" android:required="true" />
    <uses-feature android:name="android.hardware.nfc.hce" android:required="true" />

    <application
        android:allowBackup="false">

        <service
            android:name="com.gemalto.mfs.mwsdk.provisioning.push.CPSCommService"
            android:enabled="true"
            android:exported="false" />

        <!-- Your HCE service (example) -->
        <service
            android:name=".payment.contactless.YourHostApduService"
            android:exported="true"
            android:permission="android.permission.BIND_NFC_SERVICE">
            <intent-filter>
                <action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE" />
                <category android:name="android.intent.category.DEFAULT" />
            </intent-filter>

            <meta-data
                android:name="android.nfc.cardemulation.host_apdu_service"
                android:resource="@xml/apduservice" />
        </service>

    </application>
</manifest>

Declaration of HCE service will be described in Implement HCE service