Load Auth Reversal

Reverse a previously authorized load transaction.

This method can only return the result codes of 1 (success) or -9 (an error occurred while queuing the reversal).
KLV will not be sent for reversals. Only reference data will be included if there is any.

REQUEST

Path Parameters

Parameter	Type	Constraints	Description
`terminalID`	string	10 characters, required	Our partner issued terminal ID of the terminal requesting the transaction
`reference`	string	1–255 chars, required	The reference of the wallet to reverse a previous load
`requestAmount`	integer	required	The amount of the original load to be reversed
`narrative`	string	1–255 chars, required	A description of the terminal where the card was used
`transactionData`	string	0–2048 chars, required	Extra information about the transaction in KLV format
`referenceID`	string	1–255 chars, required	Transaction ID of the original load to be reversed
`referenceDate`	date	required	Transaction date of the original load to be reversed
`transactionID`	string	1–255 chars, required	Transaction ID to identify the reversal message. Note that the Transaction ID is not a unique value and may be duplicated over time.
`transactionDate`	date	required	Transaction date to identify the reversal message
`checksum`	string	required	HMAC-SHA256 hashed signature of the concatenated method name with all argument values using the terminal password as private key

XML Request Example

<?xml version="1.0"?>
<methodCall>
  <methodName>LoadAuthReversal</methodName>
  <params>
    <param><value><string>0014682067</string></value></param>
    <param><value><string>IMPLTest</string></value></param>
    <param><value><int>10000</int></value></param>
    <param>
      <value><string>Tutuka Test Pretoria ZAF</string></value>
    </param>
    <param><value><string></string></value></param>
    <param><value><string>192316</string></value></param>
    <param>
      <value>
        <dateTime.iso8601>20240313T11:20:00</dateTime.iso8601>
      </value>
    </param>
    <param><value><string>192325</string></value></param>
    <param>
      <value>
        <dateTime.iso8601>20240313T11:20:00</dateTime.iso8601>
      </value>
    </param>
    <param>
      <value>
        <string>47D4F5C6E263FA295D492A925DF607773D3F1B9B</string>
      </value>
    </param>
  </params>
</methodCall>

RESPONSE

STATUS 200 OK

SCHEMA

Response

Fields

Field	Type	Description
`resultCode`	integer	Status code indicating transaction result

XML Response Example

<?xml version="1.0"?>
<methodResponse>
  <params>
    <param>
      <value>
        <struct>
          <member>
            <name>resultCode</name>
            <value>
              <int>1</int>
            </value>
          </member>
        </struct>
      </value>
    </param>
  </params>
</methodResponse>