API Reference

Load auth

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

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 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

STATUS 200 OK

SCHEMA

Field Type Description
resultCode integer Status code indicating transaction result

  <methodResponse>
    <params>
      <param>
        <value>
          <struct>
            <member>
              <name>resultCode</name>
              <value><int>1</int></value>
            </member>
          </struct>
        </value>
      </param>
    </params>
  </methodResponse>
Language
Click Try It! to start a request and see the response here!