iOS

Ansa's iOS SDK supports Ansa Anywhere, but you must get explicit approval from Apple to add the In-App Provisioning entitlement to your app.

To get the entitlement enabled, send an email to your implementation manager with the following information:

Country [Country Code]:
Issuer Name: First Internet Bank of Indiana
Team ID: Your Developer Account Team ID
ADAM ID: Your App ID
App Name: Your App name on AppStore

Ansa will submit this information to Apple on your behalf. Please note that Apple does not provide specific timelines for entitlement request responses, but based on our experience, it typically takes about a week. We recommend budgeting 1-2 weeks to receive a response.

Once you're approved, be sure to add the entitlement to your applications target under "Signing & Capabilities". Once completed, the Ansa SDK will recognize the entitlement, and display the Ansa Anywhere UI.

Troubleshooting

If the In-App Provisioning entitlement is not set, or if it's set without approval from Apple, the Add to Apple Wallet flow will crash.

To test push provisioning, you must be test on a TestFlight or production build. Testing on a debug build will result in push provisioning failure!

Android

Ansa relies on the Google TapToPay APIs under the hood to setup Ansa Anywhere, however, it's not automatically included as a dependency because you must get explicit permission from Google to setup card provisioning. If you're using the Ansa SDK, please contact your implementation manager to request an NDA. Once the NDA is submitted, you'll have access to the private SDK supplement from Google, and will need to add it as a dependency in your application. This allows Ansa to access the APIs and setup Ansa Anywhere.

In order for the SDK to work, you'll need to provide your app package name to your implementation manager. For internal testing builds, you'll also need to provide your app fingerprint in SHA-256.

Note: You will not be able to view any of the links on this page until you are granted access. If you do not currently have access you can request this via Google’s request form.

Integrating the Android TapToPay SDK

Setting up your environment

To access the Android Push Provisioning API, you must add a private SDK supplement to your app's dependencies. This supplement is separate from publicly available Google Play Services dependencies that your app might also rely upon.

To integrate the Push Provisioning libraries, you need to perform a few basic tasks to prepare your Android Studio project:

Unzip the SDK
Edit your project Gradle file
Edit your module Gradle file

Unzip the SDK

The private supplementary SDK can be found here on google’s releases page. Download it locally and unzip the archive.

Follow Google's instructions on how to integrate the google-tap-and-pay SDK into your Android application.

As an example, we showcase how we've integrated it below:

Create a directory in your project called google-tap-and-pay at the root level.

Move the entire contents of the archive into that directory you created above so you end up with a directory structure as follows:

Edit your project Gradle file

Once the SDK maven files are in place, you need to update the project gradle file to allow gradle to resolve the local maven artifact.

In your root/project level gradle file add the following lines:

 buildscript {
    repositories {
      google()
      mavenCentral()
+     maven("file:${project.rootDir}/google-tap-and-pay/")
    }

    [...]
 }
 
 [...]
 
 allprojects {
    repositories {
      google()
      mavenCentral()
+     maven("file:${project.rootDir}/google-tap-and-pay/")
    }
 }

Edit your module Gradle file

Once the repository is in place you can add the tap and pay SDK to your dependencies of your app's gradle module.

 dependencies {
+    implementation("com.google.android.gms:play-services-tapandpay:18.3.3") {
+         isTransitive = true
+    }
 }

Syncing gradle now will resolve and download the supplementary SDK for Push Provisioning, giving Ansa access to the necessary APIs.

The Ansa SDK will automatically show the "Add to GPay" button in the balance screen if the following requirements are met:

You've successfully added the google-tap-and-pay SDK as a dependency to your application
The "isTapToPayEnabled" flag is enabled for in your Ansa merchant configuration, or the "isTapToPayEnabled" is enabled for your Ansa user.