WooCommerce (Payment Pages) Installation Guide


WooCommerce Trust Payments Gateway is a hosted e-commerce solution that can be easily integrated into your website to provide a comprehensive checkout experience.


  • 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.



  This plugin requires a working version of WooCommerce. Please install WooCommerce before proceeding.

  1. Navigate to Plugins > Add New Plugin > Upload Plugin.
  2. Select the WooCommerce Trust Payments Gateway plugin file from your computer.
  3. Upload the file.
  4. Click the “Activate” button, or navigate to Plugins > Installed Plugins > Activate the Trust Payments gateway plugin.



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:

  • 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.





If you have problems redirecting the customer's browser back to your store following checkout using our hosted Payment Pages, follow the steps below:

  1. 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.
  2. Click "Edit" for page "TRU//ST Payments". (You can search for this page if you are unable to see it immediately).
  3. On the right, expand "Template" and ensure "Default template" is selected.
  4. When done, click "Update" in the top-right.
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request