LoadAuth

Sends the request to preload in case of a refund request or a request to load a card.

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 load

requestAmount

integer, required

The amount to be loaded in cents

narrative

string, 1-255 characters, required

A description of the terminal where the card was used

transactionType

string, 2 characters, required

2 character string identifying the type of transaction:

20 = Refund
26 = OCT (Visa)
28 = MoneySend/Payment

transactionData

string, 0-2048 characters, required

Extra information about the transaction in a KLV format

transactionID

string, 1-255 characters, required

Transaction ID number generated by the calling client.

Note. The transactionID is not a unique value and may be duplicated over time. The value of the transactionID is not expected or guaranteed to tie up to an original deduct message.

transactionDate

date, required

Transaction date generated by the calling client

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>LoadAuth</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>20</string>
            </value>
        </param>
        <param>
            <value>
                <string>002151375691000000230041200000001000002604601103712164514763140041000420512345048000490384008500250033DS25110MasterCard2520102530447792540025500</string>
            </value>
        </param>
        <param>
            <value>
                <string>192316</string>
            </value>
        </param>
        <param>
            <value>
                <dateTime.iso8601>20200709T06:45:40</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>

Back to Remote API menu

Request

Path parameters

Response

STATUS200 OK

Schema

Are you ready to use our APIs