Appendix

Lookups

Receiving Institution

Result Codes

CodeDescription
1Success / OK.
0Approved - No Action.
-4Invalid card number or reference.
-5Operation not Allowed
-6Operation not Supported
-7Transaction Timeout
-8Authentication failed
-9Do 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:

    or:

    postalCode10260


Originating Institution

CodeDescription
1Success / OK.
0Approved - No Action.
-4Invalid card number or reference.
-300Error 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:

or:

recipientPostalCode10260


Receiving Institution (Remote)

Result Codes

CodeDescription
1Success / OK.
0Approved - No Action.
-4Invalid card number or reference.
-300Error from Mastercard. See resultText for reference.

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

or:

recipientPostalCode10260