POST updateDCC

This operation is very similar to DCC Activation, except that it is generally used by an already-activated terminal/device to update the DCC Parameters.

In order to ensure the front-end client/terminal receives the update in timely basis, it is recommended to perform this operation in trigger/scheduled basis, e.g.:
• Upon terminal start-up
• On daily basis at specific time
• By manual trigger

This operation may not be relevant for a host-to-host setup, due to the same reason explained in “Activation” section.

Request Information

URI Parameters

None.

Body Parameters

UpdateRequest

Name	Description	Type	Additional information
deviceId	Device ID - unique ID representing front-end device/terminal. If this field is absent,acquirer/merchant/terminal ID must be provided	string	None.
acquirerId	Acquirer ID If Device ID is provided, this field is ignored.	string	Range: inclusive between 1 and 99999999999
merchantId	Merchant ID If Device ID is provided, this field is ignored.	string	String length: inclusive between 0 and 35
terminalId	Terminal ID If Device ID is provided, this field is ignored.	string	String length: inclusive between 0 and 16
deviceInfo	Device Info	DeviceInfo	Required

Request Formats

application/json, text/json

Sample:

{
  "deviceId": "sample string 1",
  "acquirerId": "sample string 2",
  "merchantId": "sample string 3",
  "terminalId": "sample string 4",
  "deviceInfo": {
    "summary": "sample string 1",
    "model": "sample string 2",
    "software": "sample string 3",
    "vendor": "sample string 4",
    "additionalInfo": "sample string 5"
  }
}

Response Information

Resource Description

UpdateResponse

Name	Description	Type	Additional information
result	Possible codes: "0000", "6999", "6000", "6001", "6002", "6003"	Result	None.
deviceId	Device ID This ID uniquely identify a front-end device/terminal.	string	None.
acquirerId	Acquirer ID	string	None.
merchantId	Merchant ID	string	None.
terminalId	Terminal ID	string	None.
baseCountry	Base Country	string	None.
baseCurrency	Base Currency	Currency	None.
supportedCurrencies	Array of acquirer supported currency codes	Collection of string	None.

Response Formats

application/json, text/json

Sample:

{
  "result": {
    "code": "sample string 1",
    "description": "sample string 2"
  },
  "deviceId": "sample string 1",
  "acquirerId": "sample string 2",
  "merchantId": "sample string 3",
  "terminalId": "sample string 4",
  "baseCountry": "sample string 5",
  "baseCurrency": {
    "code": "sample string 1",
    "numericCode": "sample string 2",
    "symbol": "sample string 3",
    "minorUnit": 4,
    "displayUnit": 5
  },
  "supportedCurrencies": [
    "sample string 1",
    "sample string 2"
  ]
}