Connecting your WooCommerce store to Teya

This guide explains how to integrate Teya payments into your WooCommerce online store using our official plugin. By connecting your store, you can accept customer payments online and view all transactions in real-time through your Teya App and the Business Portal.

Before you start

Ensure you have the following ready:

• Administrator access to your WooCommerce dashboard.
• Your Teya Account login details (email and password).

Install the Teya plugin

You can install the plugin directly through your WordPress dashboard.

1. Log in to your WooCommerce admin dashboard.
2. Navigate to Plugins in the sidebar and select Add New.
3. Type Teya into the search bar to locate the official extension.
4. Click Install Now next to the Teya plugin.
5. Once the installation is complete, click Activate.
6. To confirm the installation was successful, go to Plugins > Installed Plugins and ensure Teya Payments is listed.

Connect your Teya store

Once the plugin is active, you must link it to your Teya Account to start processing payments.

1. In your WooCommerce dashboard, go to Settings and select the Payments tab.
2. Locate Teya Payments in the list of available providers. You may see a status flag saying Action needed.
3. Click the Complete setup button. This will redirect you to the Teya login page.
4. Enter your Teya email address and password to log in.
5. If you have multiple businesses, select the specific Teya store you wish to connect to this WooCommerce site.
6. Confirm the connection when prompted.

Once your store is successfully connected, you can begin accepting payments immediately, allowing customers to select Teya at checkout while monitoring all incoming transactions in real time through the Teya App or Business Portal.

Troubleshooting Cloudflare and firewall issues with WooCommerce

This guide applies if you experience the following:

• You use the official Teya Payments plugin for WooCommerce.
• Your site uses Cloudflare, Sucuri, Wordfence, or another hosting firewall.
• You see a "403 Forbidden" error when accessing: https://yourdomain.com/wc-api/teya_oauth_callback/
• The setup process fails with: Registration webhook returned HTTP client error: status=403 FORBIDDEN

Step 1: Allow Teya IP addresses

The most common cause of failure is a firewall blocking Teya's notification servers. You must create an allow rule for our IP addresses on HTTPS (port 443).

Teya webhook IP addresses:

• 63.35.101.166
• 63.34.233.45
• 34.252.138.105

To add these in Cloudflare:

1. Go to Security > WAF > Tools (or IP Access Rules).
2. Add an Allow rule for each IP address listed above.
3. If you have other firewalls (such as on your server or hosting provider), add these IPs to their allowlists as well.

Step 2: Configure firewall and bot rules

Even with allowed IPs, "Bot Fight Mode" or strict WAF rules may challenge the webhook request. You must relax these checks for the Teya plugin paths.

Target these URL paths:

• /wc-api/teya_oauth_callback/
• /wc-api/teya_payments/
• Or the wildcard: /wc-api/*

Update WAF and Bot settings:

1. In Cloudflare, go to Security > WAF > Rules.
2. Create a rule where URI path contains /wc-api/.
3. Set the action to Skip or Allow.
4. Ensure you skip WAF, Bot Fight Mode, and JS Challenges.
5. Check that Rate Limiting is not blocking repeated calls to these paths.

Bypass caching: Caching can cause the webhook to fail or return old data.

1. In Cloudflare, go to Rules > Page Rules or Cache Rules.
2. Create a rule for the paths listed above.
3. Set Cache Level to Bypass.
4. Set Edge Cache TTL to 0 (or Disabled).

Step 3: Check SSL configuration

The Teya plugin requires a secure HTTPS connection. Invalid SSL settings will prevent the plugin from communicating with Teya.

1. Open your store URL in a browser and ensure there are no security warnings.
2. In Cloudflare, go to SSL/TLS.
3. Set the encryption mode to Full or Full (Strict).
4. Do not use Flexible mode, as this often breaks API connections.

Step 4: Verify the connection

Before you try the plugin setup again, verify that your firewall is no longer blocking the URL.

Test in your browser:

1. Open an incognito or private browser window.
2. Visit: https://yourdomain.com/wc-api/teya_oauth_callback/
3. Success: You see a blank page, a simple code response (HTTP 200/204), or a white screen.
4. Failure: You see a "403 Forbidden", a captcha, a "Checking your browser" screen, or a branded firewall error page.

Retest the plugin: If the browser test is successful, complete the setup in WooCommerce:

1. Log in to your WordPress admin panel.
2. Go to WooCommerce > Settings > Payments.
3. Find Teya Payments and select Complete setup (or Manage).
4. Follow the prompts to log in with your Teya credentials and select your store.
5. Look for the "Successfully connected to Teya" message.