Skip to main content

API Reference & Changelog

API Reference​

MPP SDK Android API Reference: API Reference

Changelog​

1.11.3​

2024-10-29

Modified​

  • Exposing tapAndPayStatusCode as MppError.getWalletApiErrorCode() for errors from Google TapAndPay library.

1.11.2​

2024-08-23

Fixed​

  • Fixed MeaPushProvisioning.SamsungPay.activate(tokenUniqueReference, paymentNetwork) method.

Modified​

  • Updated targetSdkVersion to API 34.

1.11.1​

2024-07-03

Added​

  • Added MppError.getWalletApiExtraErrorCode() method.

1.11.0​

2024-06-17

Fixed​

  • Fixed a crash when an empty payload is received from the server.

Added​

In-App Verification with server-side activation:

  • Added MeaPushProvisioning.getTokenUniqueReference(Intent) method.
  • Added MeaPushProvisioning.GooglePay.getTokenInfo(Intent, listener) method.
  • Added MeaPushProvisioning.GooglePay.activate(TokenInfo, Activity, listener) method.
  • Added MeaPushProvisioning.GooglePay.activate(tokenUniqueReference, paymentNetwork) method.
  • Added MeaPushProvisioning.GooglePay.activate(Activity) method.
  • Added MeaPushProvisioning.SamsungPay.getCard(Intent, listener) method.
  • Added MeaPushProvisioning.SamsungPay.activate(Card, Activity, listener) method.
  • Added MeaPushProvisioning.SamsungPay.activate(tokenUniqueReference, paymentNetwork) method.
  • Added MeaPushProvisioning.SamsungPay.activate(Activity) method.

1.10.2​

2024-04-15

Fixed​

  • Fixed MppPaymentNetwork.getPaymentNetwork(...) method when missing Samsung Pay SDK dependency.

Added​

  • Added MppError.getWalletApiErrorCode() method.

Deprecated​

  • Deprecated MppError.getGoogleApiErrorCode() method.

1.10.1​

2024-03-13

Fixed​

  • Fixed MeaPushProvisioning.GooglePay.ActivationResult, MeaPushProvisioning.SamsungPay.ActivationResult values for declined IDV response.
  • Fixed MeaPushProvisioning.SamsungPay.activate(...) to send a correct response.

1.10.0​

2024-03-09

Removed​

  • Breaking change: Removed transitive com.samsung.android.sdk:samsungpay dependency. See Samsung Pay Library.

1.9.0​

2024-02-29

Fixed​

  • Fixed Samsung Pay SAMSUNG_PAY_TOKEN_NOT_FOUND error code.

Added​

  • Added MeaPushProvisioning.GooglePay.isWalletAvailable(...) method.
  • Added MeaPushProvisioning.SamsungPay.isWalletAvailable(...) method.
  • Added MeaPushProvisioning.SamsungPay.sendUserToSamsungPay(...) method.

1.8.2​

2024-01-30

Fixed​

  • Fixed MeaPushProvisioning.SamsungPay.checkWalletForCardToken(...) not calling onSuccess or onFailure.

1.8.1​

2023-12-13

Modified​

  • Increased cardId length limit to 128.

1.8.0​

2023-12-06

Modified​

  • Updated TapAndPay from 18.3.2 to 18.3.3.
  • Deprecated MeaPushProvisioning.SamsungPay.activate() method and renamed to MeaPushProvisioning.SamsungPay.activatePay().

Added​

  • Added MeaPushProvisioning.GooglePay.activate(activity, activationCode) method.
  • Added MeaPushProvisioning.GooglePay.declineActivation(...) method.
  • Added MeaPushProvisioning.SamsungPay.setServiceId(String) method.
  • Added MeaPushProvisioning.SamsungPay.getWalletInfo() method.
  • Added MeaPushProvisioning.SamsungPay.verifyCardIdv(...) method.
  • Added MeaPushProvisioning.SamsungPay.activate(activity, activationCode) method.
  • Added MeaPushProvisioning.SamsungPay.declineActivation(...) method.

1.7.0​

2023-04-21

Modified​

  • Improved cardId and cardSecret format validation.
  • Updated TapAndPay library from 18.1.0 to 18.3.2.
  • Updated compileSdkVersion/targetSdkVersion to API 33(Android 13).

Added​

  • Added MeaPushProvisioning.GooglePay.getActivationCode(MppCardDataParameters, String, String, Context, MppActivationCodeListener) method.
  • Added MeaPushProvisioning.GooglePay.getActivationCode(MppCardDataParameters, String, String, Context) method.
  • Added MeaPushProvisioning.SamsungPay.getActivationCode(MppCardDataParameters, String, String, Context, MppActivationCodeListener) method.
  • Added MeaPushProvisioning.SamsungPay.getActivationCode(MppCardDataParameters, String, String, Context) method.

1.6.0​

2022-09-27

Added​

  • Added MeaPushProvisioning.GooglePay.getActivationCode(MppCardDataParameters, Activity, GooglePayActivationCodeListener) method to get activation code for app-to-app verification.

1.5.2​

2022-08-24

Modified​

  • Configuration file now loads during MeaPushProvisioning.initialize(Context).

1.5.1​

2022-06-29

Added​

  • Added MeaPushProvisioning.initialize(Context, String configFileName) method to initialize SDK with custom custom configuration file.
  • Added MeaPushProvisioning.SamsungPay.checkWalletForCardSuffix(...) method to check if the Samsung Pay token with provided PAN suffix is available in Samsung Pay Wallet.

1.5.0​

2022-06-09

Added​

  • Added MeaPushProvisioning.GooglePay.checkWalletForCardSuffix(...) method to check if the Google Pay token with provided PAN suffix is available in Google Pay Wallet.
  • Added methods to simplify Issuer Pay Push Provisioning:
    • MeaPushProvisioning.IssuerPay.pushCard(Activity, String, String, String) to push card with secret.
    • MeaPushProvisioning.IssuerPay.pushCard(Activity, String, String, String, String, String) to push card with encrypted card data.
    • MeaPushProvisioning.IssuerPay.isPushAvailable(Context) checks if there are any Issuer Pay apps available on device.
    • MeaPushProvisioning.IssuerPay.getPushApps(Context) retrieves list of Issuer Pay apps available on device.
    • MeaPushProvisioning.IssuerPay.getPushAppsCount(Context) returns Issuer Pay app count.

Modified​

  • Deprecated and renamed methods:
    • MeaPushProvisioning.getGooglePayTokens(...) deprecated and renamed to MeaPushProvisioning.GooglePay.getTokens(...).
    • MeaPushProvisioning.getGooglePayTokenizationData(...) deprecated and renamed to MeaPushProvisioning.GooglePay.getTokenizationData(...).
    • MeaPushProvisioning.getSamsungPayTokens(...) deprecated and renamed to MeaPushProvisioning.SamsungPay.getTokens(...).
    • MeaPushProvisioning.getSamsungPayTokenizationData(...) deprecated and renamed to MeaPushProvisioning.SamsungPay.getTokenizationData(...).

1.4.0​

2022-05-12

Modified​

  • Updated Google TapAndPay library from 17.1.2 to 18.1.0.

Added​

  • Added MeaPushProvisioning.Configuration.hash() method to retrieve hash of the loaded configuration file.
  • Added MppPaymentNetwork.MIR payment network.
  • Added MeaPushProvisioning.getTokenRequestorsWithEncryptedPan(String, String, String, String).
  • Added MeaPushProvisioning.getTokenRequestorsWithEncryptedPan(String, String, String, String, MppGetTokenRequestorsListener).
  • Added MeaPushProvisioning.SamsungPay helper.
  • Added MeaPushProvisioning.IssuerPay helper.

1.3.2​

2022-05-10

Fixed​

  • Fixed MeaPushProvisioning.Configuration.loadConfig(String) custom configuration loading from Application's raw folder.

1.3.1​

2021-12-08

Modified​

  • Changed GooglePayTokenState.getTokenState(int googlePayTokenState) to public.
  • Changed MppPaymentNetwork.getPaymentNetwork(int googlePayCardNetwork) to public.

1.3.0​

2021-11-23

Modified​

Added​

  • Added MeaPushProvisioning.Configuration.loadConfig(String) method.

1.2.4​

2021-12-08

Modified​

  • Changed GooglePayTokenState.getTokenState(int googlePayTokenState) to public.
  • Changed MppPaymentNetwork.getPaymentNetwork(int googlePayCardNetwork) to public.

1.2.3​

2021-08-12

Modified​

  • Changed GooglePayTokenInfo constructor to public.

1.2.2​

2021-08-02

Added​

  • Added listener interfaces:

    • GooglePayRegisteredTokensListener
    • GooglePayTokenizeListener

  • Added methods:

    • MeaPushProvisioning.GooglePay.getRegisteredTokens(GooglePayRegisteredTokensListener)
    • MeaPushProvisioning.GooglePay.tokenize(GooglePayTokenInfo, String, Activity, GooglePayTokenizeListener)

1.2.1​

2021-04-19

Modified​

  • Updated Google TapAndPay library from 17.0.1 to 17.1.0.

1.2.0​

2021-02-15

Added​

  • Added GooglePayDataChangedListener listener interface.
  • Added methods:
    • MeaPushProvisioning.GooglePay.registerDataChangedListener(GooglePayDataChangedListener)
    • MeaPushProvisioning.GooglePay.removeDataChangedListener(GooglePayDataChangedListener)
    • MeaPushProvisioning.getGooglePayTokens(MppCardDataParameters, String, String, Context)
    • MeaPushProvisioning.getGooglePayTokens(MppCardDataParameters, String, String, Context, MppGetTokensListener)
    • MeaPushProvisioning.getSamsungPayTokens(MppCardDataParameters, String, String, Context)
    • MeaPushProvisioning.getSamsungPayTokens(MppCardDataParameters, String, String, Context, MppGetTokensListener)

1.1.0​

2020-10-20

Added​

  • Added classes:

    • MppBillingAddress
    • GooglePayTokenInfo
    • GooglePayTokenState

  • Added listener interfaces:

    • GooglePayTokenListener
    • GooglePayTokenDeleteListener
    • GooglePayTokenSelectListener

  • Added methods:

    • MppError.getGooglePayErrorCode()
    • MeaPushProvisioning.GooglePay.handleOnActivityResult(int, int, Intent, Activity)
    • MeaPushProvisioning.GooglePay.checkWalletForCardToken(MppCardDataParameters, GooglePayTokenListener)
    • MeaPushProvisioning.GooglePay.checkWalletForToken(MppPaymentNetwork, String, GooglePayTokenListener)
    • MeaPushProvisioning.GooglePay.requestTokenDeleteDialog(Activity, GooglePayTokenInfo, GooglePayTokenDeleteListener)
    • MeaPushProvisioning.GooglePay.requestTokenSelectDialog(Activity, GooglePayTokenInfo, GooglePayTokenSelectListener)
    • MppBillingAddress getBillingAddress() and List<String> getTokensIdList() in MppGetOemTokenizationDataResponseData

  • Added parameters:

    • @Nullable MppBillingAddress billingAddress and @Nullable List<String> tokensIdList to MppGetOemTokenizationDataListener.onSuccess()

  • Added errors:

    • GOOGLE_PAY_ERROR (701)
    • GOOGLE_PAY_TOKEN_NOT_FOUND (702)
    • GOOGLE_PAY_TOKEN_ALREADY_EXISTS (703)

Modified​

  • Updated compileSdkVersion / targetSdkVersion to API 30 (Android 11).
  • Updated minSdkVersion to API 21 (Android 5.0).
  • Deprecated methods MeaPushProvisioning.GooglePay.isPushCardRequestCode() and MeaPushProvisioning.GooglePay.handlePushCardOnActivityResult().
  • MppException can be thrown for all methods where MppInitializationFailedException or MppNotInitializedException was thrown before.
  • MeaPushProvisioning.isDefaultPaymentApplication() method now can throw MppException.
  • Nullability Annotation improvements.

Removed​

  • Removed MppInitializationFailedException class.
  • Removed MppNotInitializedException class.
  • Removed second parameter Integer tapAndPayStatusCode in MppPushCardToGooglePayListener.onFailure(...). tapAndPayStatusCode value now can be accessed using MppError.getGooglePayErrorCode() method.

1.0.1​

2020-03-17

Added​

  • Added deviceId parameter for MeaPushProvisioning.getGooglePayTokenizationData().
  • Added deviceId parameter for MeaPushProvisioning.getSamsungPayTokenizationData().

1.0.0​

2020-01-30

Modified​

  • Updated Android compileSdkVersion and targetSdkVersion to API 29.
  • Updated Google TapAndPay library version to 17.0.1: Migration checklist from Google
  • Updated GSON library version to 2.8.6.
  • Migrated from Android Support Annotations 28.0.0 library to AndroidX Annotation 1.0.0 library.
  • MeaPushProvisioning.GooglePay.isPushCardRequestCode() method now throws MppNotInitializedException.

Removed​

  • Removed MeaPushProvisioning.getPaymentAppInstanceId(Context) method.
  • Removed GoogleApiClient googleApiClient parameter from MeaPushProvisioning.GooglePay.pushCard().
  • Removed GoogleApiClient googleApiClient parameter from MeaPushProvisioning.GooglePay.handlePushCardOnActivityResult().

0.4.0​

2019-07-11

Public stable version of MPP SDK Android.