LoadAuthReversal

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. If KLV data is needed please lookup KLV from the reference data included.

Request

Path parameters

terminalID

string,  10 characters,  required

The Paymentology issued terminal ID of the terminal requesting the transaction

reference

string,  1-255 characters,  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 characters,  required

A description of the terminal where the card was used

transactionData

string,  0-2048 characters,  required

Extra information about the transaction in a KLV format

referenceID

string,  1-255 characters,  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 characters,  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 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

STATUS200 OK

Schema

resultCode

integer

Status code indicating transaction result

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

 

Was this page helpful?

Are you ready to use our APIs

If you are not yet registered with us.

Still have questions? Contact us.