Skip to main content

Veritran Docs

Load Card Parameters

This function loads the parameters required to use a card reader. This function only needs to be executed once, when starting the app, for the reader to work.

Parameter Configuration

This function requires you to complete register 390 with the configuration of the payment parameters in JSON format. Refer to the Input Registers section to learn more.

Function ID

Register

Value

110

13

Input Registers

Register

Description

Mandatory

Value

390

JSON with payment parameters configuration.

Yes

The JSON should be structured as in the following example:

{
  "terminalParameters":{
    "additionalTerminalCapabilites":"F000F0A001",
    "terminalCapabilites":"E0F8C8",
    "terminalType":"38F0C0",
    "transactionCurrencyExponent":"02",
    "terminalCountryCode":"032",
    "acquirerIdentifier":"TERM0001",
    "additionalConfiguration":"DF020101DF030101"
  },
  "contactCard":[
    {
      "aid":"A0000000041010",
      "appVersion":"0002",
      "terminalFloorLimit":"00000000",
      "tacDefault":"D84000A800",
      "tacDenial":"0000000000",
      "tacOnline":"DC4004F800",
      "defaultDDOL":"9F3704",
      "defaultTDOL":"9F0206",
      "thresholdValue":"000000002000",
      "targetPercentage":"00",
      "maxTargetPercentage":"00",
      "appSelIndicator":"00",
      "terminalAppPriority":"00"
    }
  ],
  "contactlessCard":[
    {
      "aid":"A0000000041010",
      "appVersion":"0002",
      "offlineAmountLimit":"000000000000",
      "cvmAmountLimit":"000000050000",
      "contactlessAmountLimit":"000000099999",
      "defaultUDOL":"9F6A04",
      "tacDefault":"D84000A800",
      "tacDenial":"0000000000",
      "tacOnline":"DC4004F800",
      "terminalRiskManagementData":"2C7A000000000000",
      "kernelConfiguration":"20",
      "CardDataInputCapability":"60",
      "MagStripeCVMCapabilityCVMRequired":"10",
      "SecurityCapability":"08",
      "MagStripeCVMCapabilityPerNoCVMRequired":"00",
      "LimitSwitch":"FE00",
      "TerminalTransactionQualifiers":"DCE00003"
    }
  ],
  "capk":[
    {
      "rid":"A000000003",
      "index":"08",
      "exponent":"03",
      "modulus":"D9FD6ED75D51D0E30664BD157023EAA1FFA871E4DA65672B863D255E81E137A51DE4F72BCC9E44ACE12127F87E263D3AF9DD9CF35CA4A7B01E907000BA85D24954C2FCA3074825DDD4C0C8F186CB020F683E02F2DEAD3969133F06F7845166ACEB57CA0FC2603445469811D293BFEFBAFAB57631B3DD91E796BF850A25012F1AE38F05AA5C4D6D03B1DC2E568612785938BBC9B3CD3A910C1DA55A5A9218ACE0F7A21287752682F15832A678D6E1ED0B",
      "checksum":"A960F58BE9B0266B6A6DADBA7C6C92724B58ADDE"
    }
  ]
}
Output Registers

Register

Description

Value

112

Call result

000

NO_ERROR

001

PARSING_JSON_ERROR

002

LOADING_TERMINAL_PARAMETERS_JSON

003

LOADING_CAPK_ERROR

004

EMPTY_AID_LIST_ERROR

005

LOADING_CONTACTLESS_AID_ERROR

006

LOADING_CONTACT_AID_ERROR

008

EMPTY_JSON_ERROR