WooCommerce Payment Plugin

Last Updated: Oct 24, 2022

Plugin overview

The Truevo WooCommerce Payment Plugin makes accepting ecommerce payments easy. Your customers will not only be able to make payments on your website but will also have the ability to securely save their card details for convenient repeat purchases. In addition, you will be able to perform full reversals and full or partial refunds from the WordPress backend system.

We’ve also included some important transactional information for you, meaning doing reconciliation between your WordPress backend and Truevo Portal just got easier.

Installation steps

Step 1

Download the plugin. Do not unzip or rename the file, doing this will cause the installation to fail.

Step 2

Let’s be careful. Sometimes complications can arise when you install third-party modules. We suggest that you make a backup of your shop. We also recommend first testing the integration on a test system, if you can.

Step 3

Log in to your WordPress Admin, navigate to Plugins > Add New and click on Upload Plugin.

Step 4

Click Choose File and select the downloaded Truevo Plugin zip, then select Install Now. Remember, it’s important that you do not unzip this file before you upload it. If you are struggling to find the plugin on your computer it is labelled: truevo-gateway-widget-woocommerce.

Step 5

Once the file has been uploaded it may give you the option to immediately activate the plugin, if not, navigate to Plugins > Installed Plugins > and Activate Truevo Payments. Check that the version installed is v1.7.4.

Configuration​

Step 1

Now that you have activated the Truevo Payments Plugin you will have the option to open the plugin settings. To access settings go to Plugins > Installed Plugins > locate Truevo Payments > and click on the Settings (widget) link under the plugin heading. Once you’ve opened settings the first thing you need to do is select Enable Truevo Payments.

Step 2

Next you will be asked to provide a Title, Description and Store Name.

The Title is what your customers will see when selecting a payment method. When choosing what to place here we suggest keeping it short, simple and clear, for example, use: Pay with a card.

The Description provides your customers with more information about how they are paying. Here it’s a good idea to mention what types of cards they can use, for example: Pay with a Visa, Mastercard or Maestro debit or credit card.

The Store Name is the business name you would like your customers to see when completing payment on your website, you can use your business name or trading name here.

Step 3

Next you will be asked if you want to show the Truevo seal of trust at the bottom of your Payment Plugin, please note that if you uncheck this it will continue to show - we are working on a fix for this.

In addition, the Widget Theme is currently only available as a card theme, a plain theme will be released at a later date.

Step 4

Add your Live Merchant ID (mid), Live Terminal ID (tid) and Token. These pieces of information would have been provided to you via email. What does each of these do?

The Merchant ID is a unique number that we’ve registered with the schemes and is what is used to identify your business. Each mid is also associated with a single currency.

The Terminal ID is linked to the mid and is used to identify the source of the transaction.

The Token is assigned to an account and makes it possible to perform transaction requests such as reversals and refunds. It also makes it possible for us to provide detailed transaction information to the WordPress backend, which makes reconciliation easier.

At this point, you can also enable test mode. Don’t worry, if you choose to enable test mode your live mid and tid will save and you will not have to input them again, however, you will need to replace the Token. We recommend doing a few tests before going live. You can find testing credentials below.

Step 5

You will now see the option to Enable Pre-Authorisation. By enabling this each payment made on your store will be a pre-authorised payment, in order to complete the transaction you will need to capture the payment. You can use the WordPress backend to capture the full pre-authorised amount, however, if you would like to capture a partial pre-authorisation you will need to do this from the Truevo Portal. Please note that this feature will only work if your account has been set up to accept pre-authorisations.

Step 6

Next you will be asked if you want to enable tokenisation. This feature allows your customers to securely save their card details, making repeat purchases easier and faster.

How does it work? If enabled, your customer will need to create a profile on your ecommerce store. When entering their card details for the first time they will need to select the checkbox that says: Save card. When your customer returns to make another purchase they will be shown a list of card details they have previously provided and can select an existing card, or add a new one. If they select an existing card they will simply enter their security code and go through the 3D Secure v2 flow. This significantly speeds up the checkout process.

Step 7

When designing the Truevo payment form we went for a very minimalistic design, with the aim of making it look like it belongs on your website. If you would like to personalise your form you are welcome to do so by adding some custom CSS. Please note that this will only let you make adjustments to the colour, font and general styling, you will not be able to change the placement of the form or the payment flow. For more information on how to customise your form with CSS please please review our styling capabilities documentation.

Step 8

The last configuration item is enabling the debug log. We encourage you to enable this as it will provide valuable information in the event that you are experiencing any issues with a payment.

Step 9

And last but not least, save your changes. If you close this configuration page without saving, all of your settings will be deleted and you will need to redo the configuration.

Test integration credentials

Please note that test credentials will not work in a live environment and that any transactions done in the test environment will not show up in your Truevo Portal. The credentials you use will also need to be in the same currency as your online store, below we have provided test credentials for EUR, GBP and USD, however, the token will be the same for all three currencies.
EUR GBP USD
Test Merchant ID (mid)
00000521
00000562
00000564
Test Terminal ID (tid)
00009645
00009903
00009912
Test Token

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVU0VSSUQiOiIyOTU1M0I2MC00RTYyLTRBOEMtQjdBMi1GNDkwMTZFODgyRTQiLCJpYXQiOjE2NDYzMTM5NTYsImV4cCI6MTk2MTg4OTk1Nn0.D19Ly4EqrHJpz7G6p2hivhlGcdcMHQcKwQw0yBpntzk

Test card details

Please note that test card details will only work with the test integration credentials and not with your live credentials. The test card details below will not include the 3DS flow, to test 3DS please use your live credentials and a real card.
Success Non-3DS
Card type
Mastercard Credit
Card number
5522000000000750
Expiry date
01/23
Cardholder name
Test
Security code
123

How to manage transactions from WooCommerce

How to capture a payment

Need to secure payment for a future purchase but don’t want to take a deposit? Pre-authorisation is the solution for you. Using pre-authorised payments lets you hold the desired amount and only capture the payment once the product or service has been delivered, this feature is particularly useful if you are in the hospitality industry, have an appointment-based business or make products to order.

Please take note

This feature will only work if you set up pre-authorisations during your application and onboarding process. If you did not set this up and would like to please contact our support team.

Step 1

Log into your WordPress Admin, from the left menu bar navigate to WooCommerce > Orders. Locate the transaction you wish to refund and click on it, the order status should be On Hold.

Step 2

You will now be able to see all the order details and have the ability to edit the order. WooCommerce separates your order information into containers. On the far right there is a container at the top of the page called Order Actions, open the dropdown list. Navigate to the last item in the dropdown called Capture the Payment, select it and then click on Update.

Step 3

The screen will refresh and a new Order Note will appear saying that the payment has been successfully captured. Your order status should now have been updated to Processing.

How to perform reversals and refunds

With our new Truevo Payment Plugins you are able to perform reversals and refunds from within the WordPress backend. To start out, we’re going to define the difference between a reversal and a refund. 

A reversal occurs when the funds from a transaction are returned to a customer before the payment has cleared. This means that the reversal request was performed the same day that the transaction took place (before 00:00 CET/CEST).  For this reason, reversals are also for the full transaction amount and it will be as if the transaction never occurred, i.e. there will be no record of the transaction in your customer’s bank account.

A refund occurs when the funds from a transaction are returned to a customer after the payment has cleared. Because the transaction has been completed and the refund is a new transaction, the transaction amount can be fully or partially refunded, and will show up as a separate transaction in your customer’s bank account.

Reversal

Step 1

Log into your WordPress Admin, from the left menu bar navigate to WooCommerce > Orders. Locate the transaction you wish to reverse and click on it. Please note that the transaction must have happened on the same day (before 00:00 CET/CEST) for it to be classified as a reversal.

Step 2

You will now be able to see all the order details and have the ability to edit the order. WooCommerce separates your order information into containers. The second container will list all of the items your customer has ordered. In the bottom left corner of this container, you will see a button that says Reverse, click on it.

Step 3

A popup window will appear asking if you are sure you want to proceed with the reversal, select Ok. The page will then refresh and your order items will now state Refunded with the amount in red.

Step 4

Double-check the Order notes on the right-hand side panel. This will confirm whether the reversal was successful or not. Your order status should also now say Cancelled.

Refund

Step 1

Log into your WordPress Admin, from the left menu bar navigate to WooCommerce > Orders. Locate the transaction you wish to refund and click on it. Please note that the transaction must be at least one day old before it can be classified as a refund.

Step 2

You will now be able to see all the order details and have the ability to edit the order. WooCommerce separates your order information into containers. The second container will list all of the items your customer has ordered. In the bottom left corner of this container, you will see a button that says Refund, click on it.

Step 3

The section will expand and you will be asked how much you want to refund and given the option to add a reason for the refund. We will let you know what the maximum refund amount is. Please note that you can do a partial or full refund.

Step 4

A popup window will appear asking if you are sure you want to proceed with the refund, select Ok. Once selected you will then be redirected back to the Edit order page and your order items will now state Refunded with the amount in red.

Step 5

Double-check the Order notes on the right-hand side panel, this will confirm whether the refund was successful or not. Your order status should also now say Cancelled.

Page Contents