Response Codes - Local API
| Code | Description |
|---|---|
| 1 | Approved |
| Approved - No Action | |
| -3 | Duplicate Transaction ID |
| -4 | Validation error. Please verify the values you provided are correct |
| -5 | Operation not Allowed |
| -6 | Operation not Supported |
| -7 | Transaction Timeout |
| -8 | Authentication Failed |
| -9 | Do not honor (general decline, no specific reason given) |
| -29 | There are invalid characters in either the pin block or one of these fields: title, initials, surname, address1, address2, address3, address4, address5, additionalData |
| -34 | Card already active |
| -35 | Card not active |
| -36 | Expired card |
| -38 | Lost card |
| -39 | Stolen card |
| -244 | Invalid last name |
| -246 | Invalid first name |
| -247 | Invalid ID number |
| -248 | Invalid MSISDN |
| -295 | Invalid expiry date |
| -333 | sessionKey not present in header and "Companion API Require Session Key" is enabled |
| -334 | sessionKey present and not decryptable/parsable |
| -778 | Reference has no linked cards |
| -779 | Card already linked to a different reference |
Important
The checksum that accompanies each request should be calculated as the HMAC-SHA256 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_sha256(‘TerminalPassword’, ‘MethodNameParam1Param2Param3’)
Any method with both the reference and cardIdentifier parameters will accept an empty reference parameter if the campaign is set to use the card number as reference and the cardIdentifier parameter is supplied.
The cardIdentifier parameter can be empty for most calls if the reference only refers to a single card
Any argument that has the type ‘date’ needs to follow the XML-RPC specified ISO 8601 datetime format:
<dateTime.iso8601>YYYYMMDDTHH:mm:ss<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.
Was this page helpful?