Introduction
WooCommerce Trust Payments Gateway is a hosted e-commerce solution that can be easily integrated into your website to provide a comprehensive checkout experience.
Features
- Integrate your Trust Payments account with the WooCommerce store.
- Allow customers to checkout using credit and debit cards.
- Support of Saved Card functionality, using Tokenisation for security.
- Allows admin to easily track the transaction history.
- Allows logged in customers to pay using credit/debit cards saved on their account.
- Allows logged in customers to manage their saved payment card(s) on the My Account page.
- Allows admin to perform payments from the WooCommerce admin interface (MOTO).
- PayPal, Apple Pay and Visa Checkout are supported.
Installation
This plugin requires a working version of WooCommerce. Please install WooCommerce before proceeding.
- Navigate to Plugins > Add New Plugin > Upload Plugin.
- Select the WooCommerce Trust Payments Gateway plugin file from your computer.
- Upload the file.
- Click the “Activate” button, or navigate to Plugins > Installed Plugins > Activate the Trust Payments gateway plugin.
Settings
To configure the WooCommerce Trust Payments Gateway plugin, navigate to WooCommerce > Settings > Payments > Trust Payments.
Ensure you save your changes when done by clicking “Save Settings” at the bottom of the page.
The following settings can be modified:
- Enable/Disable
Enable or disable the plugin. - Title
Enter a title for the Gateway to be displayed on the checkout page. - Description
Enter a description of the Gateway to be displayed on the checkout page. - Site reference
This is a unique reference provided by Trust Payments that identifies your account on their system. - Platform
This is used to configure the plugin to connect to the appropriate platform for your account with Trust Payments. Select either EU or US. - Payment Choice Page
If enabled, the customer is prompted to select their preferred method of payment prior to entering their payment credentials. If disabled, the customer is immediately prompted for their card details. - Use iframe
If enabled, the payment form is displayed in an iframe from within your WooCommerce store. If disabled, the customer is redirected to Trust Payments to complete the payment. - Iframe height/width
The width and height of the iframe (if enabled), in px or %. - Perform Back-Office Operations
Enabling this option will allow WooCommerce to directly interact with the Trust Payments API. This allows you to update orders and perform refunds from within the WooCommerce admin interface. - Webservices Username
This will be your Webservices username, registered with Trust Payments. - Webservices Password
This will be your Webservices password. - Site Security Password
Site security is a Trust Payments feature that protects payments from modification from unauthorised third parties. In the interest of security, this feature is required. To enable, you will need to enter the password previously agreed with the Trust Payments Support Team.
The Trust Payments Support team may ask for confirmation of the site security fields. These are as follows:
sitereference,currencyiso3a,mainamount,orderreference,billingemail,settleduedate,settlestatus,accounttypedescription,isusediframe - Stprofile
When applying bespoke mark-up to customise the appearance and layout of your checkout, specify the profile here. The default stprofile options:- default – standard layout
- st_paymentcard – dynamic card preview (shows address)
- st_paymentcardonly – dynamic card preview (hides address)
- st_cardonly – static card image (hides address)
- st_iframe_cardonly – no card image (hides address)
- 3D Secure
3-D Secure is a standard designed to reduce fraud and chargebacks during e-commerce transactions. Before enabling in the WooCommerce plugin, you will need to check with the Trust Payments Support Team that 3-D Secure has been enabled with Enhanced Post on your Trust Payments account. - Saved Cards
This allows your customers to save credit/debit cards to their account for future purchases. Before this can be enabled, you will need to enable Perform Back-Office Operations in the plugin, and then contact the Trust Payments Support Team to request Account Checks are enabled using Enhanced Post. - Webservice JWT Secret
This is used to sign the JWT (JSON Web Token) for processing requests to the Trust Payments gateway. - Maximum Saved Cards
The maximum number of credit/debit cards the customer can save to their account. - MOTO Payment
Enable or disable Mail Order/Telephone Orders. - Settle Due Date
The date on which funds are to be transferred to your bank account following authorisation from the issuing bank. Can be delayed for up to seven days.
Checkout page
To streamline the checkout process for your customers, this plugin supports the ability for the customer to store their payment card credentials for future purchases. Returning customers who registered an account on your site can choose to complete the payment with a card they used for a previous purchase, without the need to re-enter.
When the customer is ready to purchase the product(s) in their cart, they are presented with the Trust Payments option on the checkout:
After the customer clicks the “Place order” button, they will be shown the below (if iframe is enabled):
If the iframe is disabled, a full redirect to the Trust Payments Payment Pages is performed instead.
Manage Saved Cards
Customers can view their saved cards in My Account > Payment Methods:
Order Status
Once the customer has navigated to the checkout to begin their purchase, the order status is set to “Pending payment”.
If the payment is authorised, the order status is set to “Processing” to indicate the order was placed successfully. However, if the customer fails to complete the process, or the issuing bank declines the transaction, the order status will remain in “Pending payment”.
Once the customer has processed their order, you have the option to manually change the order status to “Complete” from within the WooCommerce admin interface. The order will not be modified in any way - this functionality is instead used to provide a visual indicator to administrators that the order has been completed.
When the order is completed, merchants can track customers’ orders by clicking WooCommerce > Orders. The order details will be displayed as follows:
To cancel a payment on the Trust Payments gateway, when viewing an order go to “Order actions” in the top right, and select “Cancel payment via TRU//ST Payments”. Click the update button to confirm the action:
Refund via Trust Payments
On the order details page, you can perform a refund via Trust Payments:
Manage Transactions
You can track the status of transactions by clicking "ST Transactions" in the menu:
Making a payment via the admin interface (MOTO)
You can manually create a new order on behalf of customers who purchase an item by email/telephone using the WooCommerce admin interface. Add a new order, then in the Billing details section, select “Credit Card (Trust Payments)" as the payment method (this will change depending on the title you chose for the module). The payment form will be displayed for you to fill in the customer’s card information.
Troubleshooting
If you have problems redirecting the customer's browser back to your store following checkout using our hosted Payment Pages, follow the steps below:
- Following installation, the plugin should create a page that you will need to check. Start by clicking "Pages" from the navigation panel on the left.
- Click "Edit" for page "TRU//ST Payments". (You can search for this page if you are unable to see it immediately).
- On the right, expand "Template" and ensure "Default template" is selected.
- When done, click "Update" in the top-right.