Lookups

Result Codes
Code Description
1 Success / OK.
Approved - No Action.
-4 Invalid card number or reference.
-5 Operation not Allowed
-6 Operation not Supported
-7 Transaction Timeout
-8 Authentication failed
-9 Do not honor (general decline, no specific reason given)
  • The checksum that accompanies each request should be calculated as the HMAC-SHA1 hash of the method name concatenated with all the parameters in order. The terminal password should be used as the key for the hash:
hmac_sha1('TerminalPassword', 'MethodNameParam1Param2Param3')


  • Any argument that has the type ‘date’ needs to follow the XML-RPC specified ISO 8601 datetime format:

<dateTime.iso8601>YYYYMMDDTHH:mm:ss±HH:mm<dateTime.iso8601>

  • Any transaction amount is represented as its cent value; therefore an integer rather than a decimal.
    • R100.50 is therefore represented as 10050 rand cents.
    • $10.50 is therefore represented as 1050 dollar cents.
  • The field optionalData is mandatory but its contents are optional. It accepts an XML-RPC struct, for example:
    <struct/>

    or:

    <struct><member><name>postalCode</name><value><string>10260</string></value></member></struct>

Result Codes
Code Description
1 Success / OK.
Approved - No Action.
-4 Invalid card number or reference
-300 Error from Mastercard. See resultText for reference.

The checksum that accompanies each request should be calculated as the HMAC-SHA1 hash of the method name concatenated with all the parameters in order. The terminal password should be used as the key for the hash:

hmac_sha1('TerminalPassword', 'MethodNameParam1Param2Param3')

Any argument that has the type ‘date’ needs to follow the XML-RPC specified ISO 8601 datetime format:

<dateTime.iso8601>YYYYMMDDTHH:mm:ss±HH:mm<dateTime.iso8601>


Any transaction amount is represented as its cent value; therefore an integer rather than a decimal.
  • R100.50 is therefore represented as 10050 rand cents.
  • $10.50 is therefore represented as 1050 dollar cents.

 

The field optionalData is mandatory but its contents are optional. It accepts an XML-RPC struct, for example:

<struct/>

or:

<struct><member><name>recipientPostalCode</name><value><string>10260</string></value></member></struct>

Result Codes
Code Description
1 Success / OK
Approved - No Action
-4 Invalid card number or reference
-300 Error from Mastercard. See resultText for reference

The checksum that accompanies each request should be calculated as the HMAC-SHA1 hash of the method name concatenated with all the parameters in order. The terminal password should be used as the key for the hash:

hmac_sha1(`TerminalPassword`, `MethodNameParam1Param2Param3`)

Any argument that has the type “date” needs to follow the XML-RPC specified ISO 8601 datetime format:

<dateTime.iso8601>YYYYMMDDTHH:mm:ss±HH:mm<dateTime.iso8601>

 

Any transaction amount is represented as it’s cent value therefore an integer rather than a decimal.

  • R100.50 is therefore represented as 10050 rand cents.
  • $10.50 is therefore represented as 1050 dollar cents.

 


The field optionalData is mandatory but its contents are optional. It accepts an XML-RPC struct, for example:

<struct/>

or:

<struct><member><name>recipientPostalCode</name><value><string>10260</string></value></member></struct>

Was this page helpful?

Are you ready to use our APIs

If you are not yet registered with us.

Still have questions? Contact us.