Forcing a TMS Update (Mandatory Feature) – NMI

Overview
How to force a TMS update

Overview

It is important for the end user to have an easy way of forcing a TMS Update. Although the Payment Device SDK requires that the integrator performs a partial TMS update regularly, at times the user may need to carry out a forced update in order to download recently changed TMS properties when an update is not yet required by the SDK.

For example, if something has changed on the TMS, such as enablement of tipping, or change of maximum transaction limit, the end user then needs to force a TMS Update in order to download these new properties immediately, rather than waiting until the next required update time.

For more information on Terminal Managment System (TMS), please see our website.

*We mandate integrators add a "Force TMS Update" button in their application's settings page to provide the end user with an easy way to update their terminal when needed.

How to force a TMS update

Android:

To force a TMS Update, you will need to create a Parameters object, and add the ForceTmsUpdate key, and set it to true with ParameterValues.TRUE. Optionally, you can also enforce a full TMS Update by setting the FullTmsUpdate key to true.

Parameters tmsParams = new Parameters();
tmsParams.add(ParameterKeys.ForceTmsUpdate, ParameterValues.TRUE);
tmsParams.add(ParameterKeys.FullTmsUpdate, ParameterValues.TRUE);
ChipDnaMobile.getInstance().requestTmsUpdate(tmsParams);

Calling this method with these parameters will force a TMS update immediately and download any new properties/settings.

*A full update will download all settings from the TMS server, including the settings which did not change since the previous update, and it is a more time-consuming update.

iOS:

To force a TMS Update, you will need to create a Parameters object, and add the CCParamForceTmsUpdate key, and set it to true with CCValueTrue. Optionally, you can also enforce a full TMS Update by setting the CCParamFullTmsUpdate key to true.

CCParameters *tmsParams = [[CCParameters alloc] init];
[tmsParams setValue:CCValueTrue forKey:CCParamForceTmsUpdate];
[tmsParams setValue:CCValueTrue forKey:CCParamFullTmsUpdate];
[[ChipDnaMobile sharedInstance] requestTmsUpdate:tmsParams];