Load auth

post

https://example.com/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`	string10 charactersrequired	Our partner issued terminal ID of the terminal requesting the transaction
`reference`	string1-255 charactersrequired	The reference of the wallet to load
`requestAmount`	integerrequired	The amount to be loaded in cents
`narrative`	string1-255 charactersrequired	A description of the terminal where the card was used
`transactionType`	string2 charactersrequired	2 character string identifying the type of transaction: `20` = Refund `26` = OCT (Visa) `28` = MoneySend/Payment
`transactionData`	string0-2048 charactersrequired	Extra information about the transaction in a KLV Format
`transactionID`	string1-255 charactersrequired	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`	daterequired	Transaction date generated by the calling client
`checksum`	stringrequired	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>

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

200

Successful authorization

400

Invalid request parameters

401

Authorization failed

403

Forbidden (invalid checksum)

422

Invalid transaction type