Connecting Trust Payments

Connecting to Trust Payments uses API credentials. Shuttle uses a combination of
the Trust Payments Web Services API and JavaScript, so you will create a Web
Services user and obtain JavaScript credentials in the Trust Payments dashboard,
then enter those details in Shuttle.

Setup

1. On your Trust Payments dashboard, open Sites and confirm the site you want
   to connect is listed. Note down its sitereference — you will enter this in
   Shuttle as Site Reference.

   

2. Open Users and select Add user to create a Web Services user.

   

3. Complete the Web Services user details:

   • Username: ws_shuttle

   • Display name: Shuttle

   • Email: your email

   • Password: choose a password

   • Role: Webservices

   • Valid IP: 52.51.86.26, 54.229.12.118, 54.76.31.104, 34.252.246.134

   • Role if invalid IP: Prevent Login

   • Allocated sites: make sure your site is listed here

   📘

   Tip

   If you cannot select your site under Allocated sites, ask Trust Payments to configure this for you.

   Note down:

   • username as WebServices API Username
   • password as WebServices API User Password

   

4. Ask Trust Payments to create your JavaScript credentials — these are required
   for ecommerce payments. Note down:

   • username as JS API Username
   • password as JS API Secret

Configuring Shuttle

5. Using the details above, create the Trust Payments connection in Shuttle. Enter
   the Site Reference, WebServices API Username and Password, and the JS API
   Username and Secret.

   

6. When you save, a number of extra fields appear:

   • Require address (AVS): require the customer to enter their billing address.
   • Tokenisation Currency: your primary currency, used when tokenising cards
     outside of a transaction.

   

Enabling webhooks

To ensure the integration operates correctly you need to set up webhooks — the way
Trust Payments notifies Shuttle of updates. Using the Webhook Url shown in the
Shuttle gateway settings, configure Trust Payments as follows.

1. Open the Trust Payments dashboard, select Sites and your site, then open
   Rule manager.

   

2. Where it says "To get started, select an action type:", select URL
   notification.

   

3. Select Add new action.

   

4. Configure the action:

   • Name: Send notification to Shuttle
   • Use Site Security Details: No
   • Security Algorithm: sha256
   • Notification Password: choose a password
   • Pipe notification to browser: No
   • Process Notification: Online
   • Website address: the Webhook Url shown in Shuttle — typically
     https://app.shuttleglobal.com/b/TRUST/webhook
   • Method: POST
   • Fields: sitereference, transactionreference, errorcode, requesttypedescription

   Note down the Notification Password as Webhook Password.

   

5. Complete creating the rule and make sure it is Active:

   • If: a completed request matched "All Requests"
   • Then: Send notification to Shuttle

6. Enter the Notification Password as Webhook Password in Shuttle. We test the
   webhook — this takes about two minutes and shows one of the following statuses:

   • UNVERIFIED: we have not received anything. Double check your Trust Payments
     setup, especially the Web Services user (role and IP addresses) and the webhook
     notification settings.
   • UNSIGNED: we received a webhook but the Webhook Password was missing or
     incorrect.
   • VERIFIED: it is set up correctly.