This document provides the technical details required to integrate an ePOS/PMS system with TRU Link, a cloud-based API developed by Trust Payments.
The service accepts HTTPS POST requests only. The HTTPS POST requests will have the following requirement:
| Request Type | Request Method | Request Body | Request Header |
| HTTPS | POST | JSON String | Content-type: application/json |
Prerequisites
Test credentials can be used to test transactions and payment flows. For integrator testing please use the test credentials as shown below:
- Service URL - https://link.trustpayments.com/trustpayments/rest/
(Same URL is used in test and production environments) - Site ID - 1502
- Site Password - YK8HDC3N
Once testing is complete, you will need to contact your Account Manager for the live Site ID and Password.
(The Service URL remains the same)
The token to be sent in the HTTP header of each transaction is a SHA256 hash built as follows:
siteid:txndate:refid:sitepassword
For example,
123456:2020-03-01:10:20:05:7876547:tv%61w%5
Produces the following token (please ensure the token is input in lowercase):
990bc7bb7efee9e383a96f6f929fd00c90f4ec94f4344270c1552e4d5d4d80c5
Testing
At Trust Payments, we highly recommend that you test the integration using a physical terminal that we have issued. Please contact your Account Manager to obtain a physical test terminal. In the meantime, you can use the below details for a terminal simulator that will allow you to test:
Terminal Simulator Serial Number: 6789654678
While using this terminal simulator’s Serial Number, only even amounts will be approved (e.g. £2, £4, £6, etc.). Odd amounts (e.g. £1, £3, £5, etc.) will be declined. This allows you to use differing amounts to test both approved and declined transactions.
