=== STRABL - A Payment & Checkout System ===
Contributors: strablengineering
Donate link: https://strabl.io/
Tags: ecommerce, payments, checkout, woocommerce, strabl
Requires at least: 6.4
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 4.8.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A supercharged Checkout & Payment provider for WooCommerce stores

== Description ==
STRABL delivers a complete hosted checkout that combines Payment processing, One-click Express Checkout, Apple Pay and Multiple Payment Methods in a single WooCommerce extension. The gateway keeps the native checkout intact while adding configurable purchase buttons, frictionless biometric authentication and automated fulfilment updates.

= Highlights =
* Customizable checkout with Payment Processing, Express 1-Click Checkout and Zero Pay purchase flows.
* Built-in support for Apple Pay, Google Pay, Samsung Pay, e-wallets and bank instalments.
* Access to Recurring Payments (subscriptions), Payment Links & QR Codes
* Passkey and biometric authentication using device Face ID or fingerprints.
* Merchant dashboard controls for branding, deferral windows and payment methods.
* Customer dashboard for managing saved payment details and outstanding Zero Pay balances.

= Compatibility =
The plugin is compatible with the classic WooCommerce checkout, WordPress block themes and WooCommerce High-Performance Order Storage (HPOS).

== Installation ==

= Minimum Requirements =

* WordPress 6.4 or greater
* WooCommerce 8.0 or greater
* PHP 7.4 or greater
* A STRABL merchant account — [sign up at strabl.io](https://strabl.io/)

= Automatic installation =

Automatic installation is the easiest option — WordPress handles the file transfer itself so you never need to leave your browser.

1. Log in to your WordPress admin panel and go to **Plugins → Add New**.
2. In the search field type **STRABL Checkout** and press Enter.
3. Click **Install Now** next to the STRABL plugin.
4. Once installation is complete, click **Activate**.
5. Navigate to **WooCommerce → Settings → Payments** and click on **STRABL Checkout**.
6. Enter your **Merchant ID** (found in your STRABL dashboard), choose the gateway mode (Production or Development), then click **Verify** to confirm your account.
7. Click **Save changes**.

= Manual installation =

Manual installation is required if your hosting provider does not allow automatic plugin installation via WordPress.

1. Download the plugin `.zip` file from your STRABL account or from the WordPress plugin directory.
2. Unzip the archive on your computer.
3. Upload the `strabl-checkout-woo` folder to the `/wp-content/plugins/` directory on your web server using an FTP client (such as FileZilla) or your hosting control panel's file manager.
4. Log in to your WordPress admin panel and go to **Plugins → Installed Plugins**.
5. Find **STRABL - A Payment & Checkout System** in the list and click **Activate**.
6. Navigate to **WooCommerce → Settings → Payments → STRABL Checkout** and complete the configuration as described in the Automatic installation steps above.

= Updating =

Automatic updates should work seamlessly. Before updating, always back up your site and confirm that your hosting provider allows write access to the `/wp-content/plugins/` directory.

If you experience issues after an update, deactivate the plugin and reactivate it to flush any cached configuration. No database migration is required — existing Merchant ID, gateway mode and redirect URL settings are preserved across updates.

== Frequently Asked Questions ==
= Does STRABL process the payments? =
Yes. STRABL handles payment processing through it's acquirers for all supported payment methods. No additional payment gateway is required.

= How can we issue payment links or set-up subscription style payments? =
Once your merchant account is activated on STRABL, you can log-in and start using those features as well alongside the integrated STRABL Checkout.

= Are there any extra charges to use STRABL? =
There are no extra charges to use or customize STRABL Checkout or it's 'Recurring Payments' or even issuing Payment Links. The standard transaction fees covers all the features.

= When does the customer get charged for Zero Pay orders? =
Merchants can set the delay window from the STRABL dashboard. Charges are created automatically once the chosen interval after fulfilment elapses.

= Will STRABL override the default WooCommerce checkout? =
No. STRABL adds new checkout buttons and flows. Your existing checkout continues to operate unless the customer chooses to click on the payment button provided by STRABL.

= How quickly can I go live? =
Most stores complete the configuration within a day, while advanced customisations can take up to two days.

= Do merchants and customers receive dashboards? =
Yes. Merchants gain full control over branding, payment methods and can view detailed transaction reports. Customers can review orders, manage saved payment options and settle balances from their own dashboard.

== Screenshots ==
1. Desktop checkout dialog (`assets/screenshot-1.png`)
2. Mobile checkout dialog (`assets/screenshot-2.png`)

== External services ==
This plugin communicates with STRABL-operated services to provide the hosted checkout, payment authorisation and merchant configuration workflows. Both sandbox (`https://sandbox.api.strabl.com`) and production (`https://api.strabl.com`) environments are available; the same data handling practices apply to each.

= STRABL API – `https://api.strabl.com` =
* Purpose: retrieves merchant configuration, initiates checkout sessions, stores STRABL customer references and processes webhook updates required to complete orders.
* Data sent: store identifier, order totals, customer contact details and STRABL customer references are transmitted when a checkout is initiated or webhooks are processed.
* Terms of Service: https://strabl.io/terms
* Privacy Policy: https://strabl.io/privacy

= STRABL Checkout – `https://checkout.strabl.io` =
* Purpose: presents the hosted checkout dialog, collects payment details and performs device-level biometric authentication when enabled.
* Data sent: the hosted dialog receives checkout tokens generated by the STRABL API along with customer contact details needed to finalise the order.
* Terms of Service: https://strabl.io/terms
* Privacy Policy: https://strabl.io/privacy

= STRABL CDN – `https://cdn.strabl.com` =
* Purpose: delivers static assets (JavaScript, CSS, fonts and images) used by the checkout dialog and Express Checkout button.
* Data sent: only standard HTTP request metadata (such as IP address and user agent) required to serve static assets is transmitted; no customer payment data is sent to the CDN.
* Terms of Service: https://strabl.io/terms
* Privacy Policy: https://strabl.io/privacy

Customer data submitted through STRABL is processed under the STRABL privacy policy. The plugin stores a STRABL customer identifier in WooCommerce customer meta to enable returning shopper recognition.

== Changelog ==
= 4.8.2 =
* Fixed settings panel alignment: table rows now render correctly in a two-column grid across all browsers by overriding the native table display model.
* Fixed tab switching causing the custom success URL field to reappear even when "WooCommerce order received page" was selected.

= 4.8.1 =
* Added "Success redirect URL" type option to the gateway settings: choose between the native WooCommerce order received page or a custom HTTPS URL.
* Success URL is forced to HTTPS before being sent to STRABL, ensuring compatibility with localhost and staging environments.
* Existing installations with a custom success URL set will automatically default to the custom mode on upgrade; stores without one default to the native WooCommerce page.
* Order status is set to Processing upon payment confirmation; fulfilment status references removed from the payment banner.

= 4.5 =
* Improved compatibility with WordPress 6.8 and WooCommerce HPOS.
* Added enhanced shipping configuration support and promo code handling.
* General fixes and stability improvements.

== Upgrade Notice ==
= 4.8.2 =
Minor UI fix for the payment settings panel. No configuration changes required.

= 4.8.1 =
Adds native WooCommerce success redirect support. Existing stores with a custom success URL will continue to use it automatically — no action needed unless you want to switch to the WooCommerce order received page.

= 4.5 =
This release improves compatibility with the latest WordPress and WooCommerce versions. Update to keep checkout flows operating smoothly.

== Credits ==
Developed and maintained by the STRABL engineering team with contributions from the WordPress community.

== License ==
This plugin is distributed under the GPLv2 (or later). See http://www.gnu.org/licenses/gpl-2.0.html for the full licence text.
