The getConfig method is used to retrieve the current terminal configuration. It returns a complete configuration object with various system settings, such as printer usage, supported transaction types, and UI behavior.

This method is often used with setConfig to read and update the terminal configuration.

Request

📘

JSON-RPC 2.0

All methods in TweezerComm follow a JSON-RPC 2.0 structure. See Get Startedfor more details on how the requests are structured and sent.

In the request, the method field needs to be set to getConfig, and the params must include the fixed value device as shown in the example request below:

{
    "jsonrpc": "2.0",
    "method": "getConfig",
    "id": "123454352",
    "params": [
        "device"
    ]
}

Request Parameters

The table below describes the request parameters for this method:

NameTypeDescription
paramsarrayMust contain the value device

Response

A successful request will return a response similar to the one in the code block below:

{
    "jsonrpc": "2.0",
    "id": "123454352",
    "result": {
        "configApplied": true,
        "autoPeriodic": true,
        "usePrinter": true,
        "wakeOnTransaction": false,
        "amountDialog": false,
        "ashraitServer": "SHVA",
        "posType": "TC_HTTP",
        "ecr": "1",
        "allowCreditCardTrack2": false,
        "ackTransaction": false,
        "balanceAtLoyalty": false,
        "tmsRetailer": "0883012",
        "manualInterface": true,
        "fullPANonReceipt": true,
        "code3": "HANDLE_ON_PINPAD",
        "slaveMode": false,
        "startOnBoot": true,
        "customDataScreen": false,
        "keypadAlwaysOn": false,
        "transactionTypesAllowed": [1, 8, 6, 4, 5, 7, 3, 2],
        "creditTermsAllowed": [1, 8, 3, 6, 2],
        "limitedAccessReports": false,
        "limitedAccessSpecialTransactions": false,
        "moduSMS": false,
        "ravMutav": false,
        "ravMutavMain": "",
        "ravMutavAmex": "",
        "ravMutavDiners": "",
        "paymentAggregator": "NONE",
        "paUser": "",
        "configVersion": "manual",
        "remoteAppPackageName": "",
        "remoteAppActivityName": "",
        "bonjourReusableSocket": false,
        "protectInfoPopup": false,
        "fastCredit": false,
        "visaSensoryBranding": false,
        "tcSecondaryPort": false,
        "processorIP": "",
        "autoRebootTime": "",
        "agamentoModel": "EMV",
        "enforceCardEjection": false,
        "printTransactionMode": "DEFAULT",
        "printPreAuthTransactionMode": "DEFAULT",
        "connectionEnhancement": false,
        "forcePeriodicBatch": false,
        "receiptHeaderTitle": "",
        "receiptHeaderSubtitle1": "",
        "receiptHeaderSubtitle2": ""
    }
}

Response Parameters

Below is a table with all the possible response parameters and their description:

NameTypeDescription
configAppliedboolIndicates whether the configuration is applied
autoPeriodicboolEnables automatic end-of-day batch
usePrinterboolEnables internal printer usage
wakeOnTransactionboolWake terminal from screen saver
amountDialogboolShow amount dialog before transaction
ashraitServerstringDeposit gateway provider (e.g., SHVA)
posTypestringIntegration method (e.g., TC_HTTP)
ecrstringPOS identifier
allowCreditCardTrack2boolEnable track2 data collection on swipe
ackTransactionboolEnable transaction acknowledgment mechanism
balanceAtLoyaltyboolUse merchant ID for loyalty lookup
tmsRetailerstringTMS retailer ID
manualInterfaceboolEnable manual entry interface
fullPANonReceiptboolPrint full PAN on merchant receipt
code3stringCode 3 handling method
slaveModeboolSet terminal as slave mode
startOnBootboolStart Agamento on device boot
customDataScreenboolShow custom data screen before transaction
keypadAlwaysOnboolKeep keypad active on screen
transactionTypesAllowedarrayList of allowed transaction types
creditTermsAllowedarrayList of allowed credit terms