Tagada Pay Gateway for WooCommerce

A premium, production-ready WooCommerce payment gateway that lets your store accept payments through Tagada Pay on both classic checkout and WooCommerce block checkout.

Why this plugin exists

This plugin connects your WooCommerce store to Tagada Pay so your customers can complete purchases through a secure Tagada checkout flow.

It is built for modern stores that want:

• a reliable payment method in WooCommerce
• support for both classic and block checkout
• a clean admin experience
• webhook-based order completion
• optional debug logging and staging mode

---

What this plugin does

Tagada Pay Gateway adds a new payment method to WooCommerce called Tagada Pay.

When a customer chooses this payment method:

1. WooCommerce creates an order.
2. The plugin starts a Tagada checkout session.
3. The customer is redirected to Tagada’s secure payment experience.
4. Tagada sends webhook events back to your store.
5. Your WooCommerce order is updated to paid, failed, cancelled, or refunded depending on the payment result.

This approach keeps checkout secure and gives you full control over order status updates.

---

Key features

• Support for classic WooCommerce checkout
• Support for WooCommerce block checkout
• Admin settings for Store ID, Account ID, Funnel ID, Step ID, API URL, and Browser App URL
• Browser tracker injection for Tagada integrations
• Secure checkout redirect flow
• Webhook endpoint for real payment status updates
• Optional signature verification for webhook requests
• WooCommerce debug logging
• Draft/staging mode support for testing
• HPOS-compatible for modern WooCommerce installations

---

Requirements

Before installing, make sure you have:

• WordPress 6.3 or newer
• WooCommerce 7.8 or newer
• PHP 7.4 or newer
• A valid Tagada Pay account
• Your Tagada credentials and funnel configuration

---

Installation

Option 1: Upload the plugin

1. Download the plugin zip file.
2. In your WordPress admin panel, go to Plugins > Add New > Upload Plugin.
3. Choose the zip file and click Install Now.
4. Activate the plugin.

Option 2: Manual install

1. Upload the plugin folder to your WordPress installation under wp-content/plugins/.
2. Activate it from the Plugins page.

---

Configuration

After activation:

1. Go to WooCommerce > Settings > Payments.
2. Find Tagada Pay in the payment methods list.
3. Click Manage.
4. Enable the gateway.
5. Enter your Tagada configuration details.

Required settings

You will need to fill in:

• Store ID
• Account ID
• Funnel ID
• Step ID
• Server API URL
• Browser App URL

Recommended settings

• Use descriptive checkout labels and descriptions
• Enable debug logging only while troubleshooting
• Leave the testing fallback disabled in production
• Keep webhook signature verification enabled for security

---

How to use it

Standard checkout flow

Once configured, customers will see Tagada Pay as a payment option during checkout.

When they choose it:

• the order is created in WooCommerce
• the plugin starts the Tagada checkout flow
• the customer is redirected to Tagada
• payment result comes back through webhook processing

Block checkout flow

The plugin also works with WooCommerce’s block-based checkout experience. No extra setup is required beyond enabling the gateway and configuring your Tagada credentials.

---

Webhook setup

Webhook support is one of the most important parts of this integration.

In your Tagada dashboard, configure the webhook URL below:

/wp-json/tagada-pay/v1/webhook

If your Tagada account supports webhook signatures, copy your webhook secret into the plugin settings and keep signature verification enabled.

For production stores, it is strongly recommended to complete orders only from verified webhook events rather than relying on return URL fallback behavior.

---

Draft and staging mode

If you want to test Tagada flows safely, you can enable draft/staging mode.

This can be turned on from the plugin settings, or temporarily enabled in the URL with:

?draft=true

This is useful for testing checkout behavior without affecting production workflows.

---

Debugging and troubleshooting

If something is not working as expected:

1. Enable debug logging in the plugin settings.
2. Check WooCommerce > Status > Logs.
3. Verify that all required Tagada IDs and URLs are filled correctly.
4. Confirm that the webhook URL is configured in Tagada.
5. Make sure the gateway is enabled and available for the current checkout context.

Common issues

• Missing credentials: the gateway will not be available until all required settings are filled.
• Webhook not processing: confirm the webhook URL and secret are correct.
• Checkout does not start: verify API URLs and funnel configuration.
• Orders remain pending: check whether the webhook was received and processed successfully.

---

Security recommendations

To keep your store safe and reliable:

• never expose your webhook secret
• use webhook signature verification whenever possible
• keep the testing fallback disabled in production
• monitor webhook activity and WooCommerce logs

---

Developer notes

This plugin is structured to be compatible with modern WooCommerce architecture and includes:

• WordPress REST API webhook support
• WooCommerce payment gateway integration
• block checkout integration support
• order metadata storage for Tagada-related tracking

---

Support

For product and integration support, please contact your Tagada Pay representative or visit the official Tagada Pay website.

---

License

This plugin is distributed under the GPLv2 or later license.