ToggleVoucherFeature

Toggles a voucher feature on or off

Request Path Parameters

ParametertypeLimitsrequiredDescription
terminalIDString10 characters✓The Paymentology issued terminal ID of the terminal requesting the transaction
profileNumberString1-20 characters✓Profile number linked with this card
cardIdentifierString1-20 characters✓The card number, sequence number or tracking number of the specified card.
featureNameString1-255 characters✓Name of the feature to be enabled/disabled.; ; Possible values:; ; ENABLE_INTERNATIONAL; ; OPT_IN_VAU; ; OPT_OUT_ABU; ; OPT_OUT_VAU; ; ATM_ENABLED; ; NFC_ENABLED; ; POS_ENABLED; ; ECOM_ENABLED
featureStatusBoolean✓Status to be applied.(True/False)
transactionIDString1-255 characters✓A unique identifier generated by the client, which must not be duplicated over time.
transactionDateDate✓Transaction date generated by the calling client
checksumString1-255 characters✓HMAC-SHA256 hashed signature of the concatenated method name with all argument values using the terminal password as private key.
<?xml version="1.0" encoding="UTF-8"?>
<methodCall>
  <methodName>ToggleVoucherFeature</methodName>
  <params>
    <param>
      <value>
        <string>123456789</string>
      </value>
    </param>
    <param>
      <value>
        <string>12345</string>
      </value>
    </param>
    <param>
      <value>
        <string>5165641045432078</string>
      </value>
    </param>
    <param>
      <value>
        <string>NFC_ENABLED</string>
      </value>
    </param>
    <param>
      <value>
        <int>1</int>
      </value>
    </param>
    <param>
      <value>
        <string>4f012b3a3d456d2ba789b8dcadf2ccf9</string>
      </value>
    </param>
    <param>
      <value>
        <dateTime.iso8601>20240724T23:54:28</dateTime.iso8601>
      </value>
    </param>
    <param>
      <value>
        <string>12345678930</string>
      </value>
    </param>
  </params>
</methodCall>

Response Parameters

ParametertypeDescription
cardIdentifierStringEcho of incoming value.
resultCodeIntegerStatus code indicating transaction result.
terminalIDStringEcho of incoming value.
profileNumberStringEcho of incoming value.
featureNameString
resultTextStringStatus text indicating transaction result.
transactionDateStringEcho of incoming value.
transactionIDStringEcho of incoming value.
featureStatusBoolean
<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
  <params>
    <param>
      <value>
        <struct>
          <member>
            <name>cardIdentifier</name>
            <value>
              <string>5165641045432078</string>
            </value>
          </member>
          <member>
            <name>resultCode</name>
            <value>
              <int>1</int>
            </value>
          </member>
          <member>
            <name>terminalID</name>
            <value>
              <string>123456789</string>
            </value>
          </member>
          <member>
            <name>profileNumber</name>
            <value>
              <string>12345</string>
            </value>
          </member>
          <member>
            <name>featureName</name>
            <value>
              <string>NFC_ENABLED</string>
            </value>
          </member>
          <member>
            <name>resultText</name>
            <value>
              <string>NFC_ENABLED was turned on</string>
            </value>
          </member>
          <member>
            <name>transactionDate</name>
            <value>
              <dateTime.iso8601>20240724T23:54:28</dateTime.iso8601>
            </value>
          </member>
          <member>
            <name>transactionID</name>
            <value>
              <string>4f012b3a3d456d2ba789b8dcadf2ccf9</string>
            </value>
          </member>
          <member>
            <name>featureStatus</name>
            <value>
              <boolean>1</boolean>
            </value>
          </member>
        </struct>
      </value>
    </param>
  </params>
</methodResponse>