STEP 1 Setup your development environment

Before you begin developing your branded mobile wallet app, you must obtain the SDK and configure a development environment supporting its use.


  1. Install development tools
  2. Configure the SDK instance

1. Install development tools

  1. Download and install Java 8.

  2. Download and install Android Studio as your Integrated Development Environment (IDE) from Android Studio.

  3. Add the following third-party dependencies to your build.gradle file:


2. Configure the SDK instance

1. Define the environment variables for your development environment

  • HOST_IP - The host name or IP address where the mobile gateway resides, for example, ""

  • HOST_URL - The mobile gateway path relative to the host. The URL suffix should always be /mobile appended to the HOST_IP value. For example,

  • PROTOCOL - The protocol to be used when calling the mobile gateway (for this version it is "https")

  • appSignature - A unique identifier of the app used to generate the HMAC during signing.

  • apiKey - The unique identifier of the application instance.

      private static final String HOST_IP =  hostname";
      private static final String HOST_URL = HOST_IP + "<URL Suffix>";
      private static final String PROTOCOL =  protocol";
      private ContextWrapper androidContextInstance;
      private byte[] appSignature = new byte[]
      private byte[] apiKey = new byte[]
          1 a7c, 1 x6d, 0x4 p, 1 x31, 1 x5z, 1 x69
          .setupPaydiantApplicationConfig(HOST_URL, PROTOCOL, androidContextInstance,
              appSignature, apiKey);

Note: AppSignature and apiKey values must be in byte format, not string.

2. Overload the application context method to set optional configuration values


Configure encryption and case-sensitivity settings for login password/passcode (PIN)/secret question responses (MFA) to match the corresponding Issuer onboarding settings if encryption will be handled by the SDK:"") Default = FALSE"") Default = FALSE"") Defautlt = FALSE"") Default = FALSE

Note: Typically, encryption is handled by the server rather than the SDK, so the default value of FALSE is applicable in most cases and explicit configuration is not necessary.

sdkConfigProperties.put(, false, false, false, false);


Set an alternative application version to override Paydiant’s default a.b.c.d.e versioning format. This custom value will supersede the default setting in the AndroidManifest.

private String customAppVersionName = "5.10"

3. Enable system logging

Paydiant's default logging utility is automatically initialized by the SDK, but it does need to be explicitly added as a service to the AndroidManifest file in order for the SDK to invoke the initialization.


Refer to Paydiant's Android SDK Guide for instructions on implementing a custom logging utility, should your business objectives necessitate it.

NEXT STEP 2: Provide wallet access