FAQs and Troubleshooting

Here we describe a number of common problems and solutions.

FAQs

I cannot connect to TRU Link

Make sure that TRU Link is available by browsing to https://link.trustpayments.com/trustpayments/rest/sale The following should be displayed in your browser:

HTTP GET Not Supported – Content-Type application/json POST only

If you do not see this then TRU Link is either unavailable (contact TrustPayments support) or your internet connection is down (contact your ISP).

I get an ‘Invalid token’ error

The token in your HTTP header is calculated incorrectly. Please refer to the section above on how to build your token.

I get an ‘Invalid siteid’ error

The siteid you are sending in your POST Body is incorrect. Please use the siteid provided by Trust Payments.

I get an “Error pairing Terminal”

Make sure the Terminal you are using has been registered by Trust Payments using the Terminal Serial Number.

I get an “Invalid topuptoken”

Make sure the topuptoken used is one that was received in a previous PreAuth.

I get a ‘Terminal is Offline’ error

Make sure that the Terminal is switched on, online and in integrated mode. To turn on integrated mode, choose ‘Pair with POS’ in the Administration menu.

Error Handling

If an error has occurred during processing the response will be as follows:

Example

{
"error": "<errortext>", "errorcode": <errorcode>
}

For example:

Example

{"error":"Transaction Error:Terminal is offline.","errorcode":2000}

The following lists the error texts and associated codes:

{“Invalid siteid”, “1001”}
{“Invalid token”, “1002”}
{“Invalid txndate”, “1003”}
{“Invalid terminalserialnumber”, “1004”}
{“Invalid type”, “1005”}
{“Invalid amount”, “1006”}
{“Invalid Refid”, “1007”}
{“Duplicate Transaction”, “1008”}
{“Invalid Request”, “1009”}
{“Invalid topuptoken”, “1010”}
{“Duplicate Refid”, “1011”}

{“refid must match an existing preauth”, “1012”}
{“Unable to find PreAuth”, “1013”}
{“Capture amount is greater than PreAuth amount”, “1014”}
{“Transaction already Voided”, “1015”}
{“Transaction already Captured”, “1016”}
{“Unable to find original transaction”, “1017”}
{“Refund amount larger than original transaction”, “1018”}
{“Total of partial refunds cannot exceed original transaction”, “1019”}
{“Cannot Void Refund”, “1020”}

{“Error pairing Terminal”, “1100”}
{“Error parsing PairTerminalResponse”, “1101”}
{“Error mapping pairTerminal”,”1102″}
{“IO Error pairTerminal”,”1103″}
{“Error parsing pairTerminal null”,”1104″}
{“pairTerminal eConduit error”,”1105″}
{“Error saving Terminal”,”1106″}

{“Transaction Error”,”2000″}
{“Terminal is Offline”,”2001″}
{“Terminal busy”,”2002″}
{“Response not received”,”2003″}

In the case of error 2000 additional error information will be provided in the text.