Connect your E-commerce store to Teya to accept secure online payments directly through your WordPress site. This guide covers how to install the plugin, configure your settings, and troubleshoot common connection issues.
Before you start
Important: You need a few things ready before you can install the plugin:
A WordPress site running WordPress version 5.0 or higher, and PHP version 7.4 or higher.
WooCommerce installed on your site with admin access.
A Teya Business Account with the Online Payments subscription active.
A Teya ID with Owner or Admin access on your E-commerce store.
Install and connect the plugin
Follow these steps to add the plugin to your store and link it to your Teya Account. For a general overview of how the plugin works, see here.
Go to your WordPress admin dashboard, navigate to Plugins, and select Add Plugin.
Search for Teya, find Teya Payments for WooCommerce, and click Install Now.
Click Activate once the installation finishes.
Go to WooCommerce, select Settings, and click the Payments tab.
Find the Teya plugin and click Complete setup.
Click Connect to Teya and sign in using your Teya ID.
Select your E-commerce store from the list and confirm your selection.
Check the plugin settings page to ensure Enable Teya Payment is ticked.
Configure your checkout settings
You can adjust how the checkout behaves and looks for your customers. You can update these preferences in your Teya Portal Settings at any time.
Redirect behaviour: Choose to show the Teya confirmation page before sending the customer back to your store, or send them straight to your WooCommerce success page.
Email notifications: Add an email address to receive alerts when a successful Payment comes through.
Customise your checkout: Add your company logo, terms and conditions, privacy policy, and a merchant note.
Next step: Test your setup by making a small Payment of £0.01. Confirm the checkout works as expected, and then refund the test transaction.
How do I refund a Payment?
When you refund an order in WooCommerce, the funds automatically return to the customer through Teya.
Go to your WordPress admin dashboard, navigate to WooCommerce, and select Orders.
Click on the order you want to refund.
Click the Refund button.
Enter the amount to refund. You can choose a full or partial Settlement amount.
Click Refund via Credit/Debit Card Payment to confirm the action.
Important: Refunds usually reach the customer's account in five to ten Business Days, depending on their bank.
What does my customer see?
Your customers will shop on your WooCommerce store as they normally would. When they are ready to check out, they are redirected to Teya's secure payment page. They can pay using a consumer debit card, corporate card, Apple Pay, or Google Wallet. After paying, they see a confirmation and are sent back to your store's success page.
How do I fix connection issues?
If your website uses Cloudflare or another firewall, Teya's registration webhook might be blocked. This causes an error stating Registration webhook returned HTTP client error: status=403 FORBIDDEN and can leave orders stuck in a pending status.
To fix this, you must allow Teya's webhook traffic through your firewall.
Log in to your Cloudflare account or your firewall provider.
Navigate to Security, select WAF, and go to IP Access Rules.
-
Add Allow rules for HTTPS (port 443) for the following IP addresses:
63.35.101.16663.34.233.4534.252.138.105
Save your changes and test the plugin connection again.
Need more help?