WooCommerce (Payment Pages) Installation Guide

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.

Settings

To configure the WooCommerce Trust Payments Gateway plugin, navigate to WooCommerce > Settings > Payments > Trust Payments.

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):

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.