Setup Guide

Welcome to the setup guide.

To get this plugin setup will only take around 20 mins; this guide will be broken down into steps. You must first do a test transaction using the Tyl By NatWest test account. You must have a test account; the Tyl By NatWest team will send you two emails when you sign up, one with the Store ID and another with a Shared Secret.

Once you have done several test orders, you can apply for the live Tyl By NatWest account and set this up. It is always best practice when setting up a payment gateway to do this in test mode first and run several orders before switching to live mode.

Step 1 – Plugin settings.

Install the plugin & activate the license key; once this is done, you want to navigate to the plugin settings page; this can be found in the WooCommerce settings:

WooCommerce > Settings > Payments > AG Tyl By Natwest

The essential items here for the setup are Store ID & Shared Secret.

These details are supplied by the Tyl By Natwest team when you sign up for an account.

Step 2 – Login to the Tyl By NatWest back office.

The next set of items are done in the Tyl By NatWest back office; you can log in to the test account here.

If you are having issues with signing in to the above link, you will need to email the Tyl By NatWest support team to get access. You can email them here:


Once logged in, you need to navigate to the Customization area.

From here, you want to edit Define the URLs for the integration with your online store


For the Confirmation Page(“Thank You”) field,

you need to enter your website domain followed by /checkout/order-pay/


Note: Transaction Notification needs to be the same as Failure Page.

For the  Failure Page (“Sorry”) and Transaction Notification (URL to receive a notification when a transaction is complete) fields, you will need to enter your website domain followed by /wc-api/ag_tyl_checkout


Note: The URL for the Failure Page is used as a fallback.

As you set these up, please ensure that all the checkboxes for the Confirmation and Failure pages are checked as seen above. This will guarantee that the redirections after the payment process will occur, the customer will be redirected back to the website and the website will be able to fetch the correct data (Confirmed/Failed).

Once this is done, you must wait for around 30 minutes for this to take place.

Please remember that if your site uses “www” within the URL, you will need to add them as well in the mentioned fields above – as an example, if your site’s URL structure is, then you will need to add “www” to all the URL definitions above.

Step 3 – Setting the operation mode for the payment gateway

In this section, you will need to decide which operation mode you want to run the payment gateway. You will be able to set this option from the WordPress dashboard >> WooCommerce >> Payments >> AG Tyl By NatWest Checkout Settings.

Based on these two steps, you can choose between two default operation codes:

Pre-authorization: our system will only ask for authorization to have the authorization and data capture (payment request) steps performed separately at different times (the money remains in the customer’s account until a data capture (payment request) has been performed).
Sale: our system automatically requests the payment (transfer of the amount) immediately after a successful authorization. This procedure is often used for goods/services delivered online.

If you are unsure what to enable, ask your client what they have been using, most users enable the sale method, but it is down to how the business operates.

Step 4 – Test, Test & test.

Well done, you have now finished the setup of the plugin! Now the important thing to do is test the payment gateway a few times before going live. If you have any errors/issues, you first want to check the error log.

In the UK the clocks go forward 1 hour at 1 am on the last Sunday in March. The period when the clocks are 1 hour ahead is called British Summer Time (BST). There’s more daylight in the evenings and less in the mornings (sometimes called Daylight Saving Time). Please ensure that your timezone is set correctly to be prepared for such period, please follow our troubleshooting guide regarding this to do so: Unknown Error Due to Timezone issue


What if there is an error?

That’s a bit unfortunate, but all problems in this world can eventually be fixed. Please do take a look at our Troubleshooting guide end; hopefully, this would resolve the issue for you, or better yet, you could also contact our support and one of our friendly support team members will sort out these issues for you.

Was this helpful?

Tyl by NatWest

Don't already have the plugin? Get access now.

Still need help?

Our team are on hand to provide fast, helpful and professional support.

Support request