=== Scotiabank Payment Gateway for WooCommerce ===
Contributors: imanuelgittens, andrija, freemius
Donate link: https://wpcompanion.co/
Tags: scotiabank, woocommerce, payment gateway, caribbean, ecommerce
Requires at least: 6.1
Tested up to: 6.9.4
Stable tag: 2.3.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept Visa and Mastercard payments on your WooCommerce store with Scotiabank's eCom+ gateway. Zero transaction fees. Caribbean-built.

== Description ==

**The premier Scotiabank WooCommerce payment gateway plugin for Caribbean merchants.**

WP Companion's Scotiabank Payment Gateway plugin connects your WooCommerce store directly to Scotiabank's eCom+ service — no middlemen, no transaction fees, and funds deposited into your Scotiabank merchant account by the next business day.

Built specifically for Caribbean businesses, this plugin is trusted by merchants across Trinidad and Tobago, Jamaica, Barbados, and the wider Caribbean.

= Why Merchants Choose WP Companion =

* **Zero transaction fees** — pay a flat annual rate, no percentage taken from your sales
* **Direct bank connection** — funds settle into your Scotiabank account by the next business day
* **Embedded checkout** — customers complete payment on your site without being redirected

= Features =

* Accept Visa and Mastercard credit and debit card payments
* 3D Secure 2.0 authentication for strong customer verification
* Accept payments in both local Caribbean currency and USD
* Embedded hosted payment page — customers never leave your site
* Duplicate transaction protection — guards against double charges from page refreshes
* WooCommerce Block Checkout compatible
* Fully PCI compliant through Scotiabank's hosted payment platform
* Free sandbox mode for testing before going live

= Premium Features (Professional Plan) =

* **Live payment processing** — connect to Scotiabank's production environment
* **Admin refunds** — process refunds directly from your WooCommerce dashboard without logging into Scotiabank Merchant Admin (Scotia API activation required)
* **Pre-authorization** — authorize a card at checkout and capture the full or partial amount later 
* **Partial capture** — capture less than the authorized amount for split fulfillment or adjusted orders. Done directly from WooCommerce (Scotia API activation required)
* **Void transactions** — cancel pre-authorized transactions directly from WooCommerce (Scotia API activation required)
* **Multi-currency support** — accept both USD and local currency on a single store
* **Priority support** — direct access to the development team

[Learn more about the Professional plan](https://wpcompanion.co/scotia-bank-payment-gateway-for-woocommerce/)

= How It Works =

https://www.youtube.com/watch?v=n5JD0p2-_XI

1. Install the free plugin from WordPress.org
2. Enter your Scotiabank eCom+ credentials in WooCommerce settings
3. Test transactions in sandbox mode to confirm everything works
4. Upgrade to Professional to switch to live payment processing
5. Start accepting real payments — funds are in your bank account by the next business day

= Scotiabank eCom+ Availability =

Scotiabank eCom+ is available for merchants in:

* Trinidad and Tobago
* Jamaica
* Barbados
* Guyana
* Cayman Islands
* Turks and Caicos

**Important:** This plugin requires an active Scotiabank merchant account with eCom+ enabled. If you don't have one yet, [contact us](https://wpcompanion.co/contact/) and we can connect you to the right people at Scotiabank.

= Third-Party Service =

This plugin connects to Scotiabank's eCom+ hosted payment platform to process transactions. Customer payment information is transmitted to and stored on Scotiabank's PCI-compliant servers — your website never handles sensitive card data.

* [Scotiabank's Privacy Policy](https://tt.scotiabank.com/about-scotiabank/connect-with-scotiabank/privacy.html)

= Compare Your Options =

Not sure which Caribbean payment solution is right for your business? We've published an honest comparison of every WooCommerce payment option available in the Caribbean — including pricing, features, and total cost at different sales volumes.

[See the full comparison](https://wpcompanion.co/compare/)

== Installation ==

= Automatic Installation (Recommended) =

1. In your WordPress admin panel, navigate to **Plugins > Add New**
2. Search for **"Scotiabank"**
3. Click **Install Now** on "Scotiabank Payment Gateway for WooCommerce"
4. Click **Activate**
5. Go to **WooCommerce > Settings > Payments** and click on **Scotiabank eCom+** to configure

= Manual Installation =

1. Download the plugin from this page or from [wpcompanion.co](https://wpcompanion.co/scotia-bank-payment-gateway-for-woocommerce/)
2. In your WordPress admin panel, navigate to **Plugins > Add New > Upload Plugin**
3. Select the downloaded zip file and click **Install Now**
4. Activate the plugin and configure under **WooCommerce > Settings > Payments**

= Configuration =

1. Go to **WooCommerce > Settings > Payments > Scotiabank eCom+**
2. Enable the payment method
3. Enter your Store ID and Shared Secret (provided by Scotiabank when you activate eCom+)
4. Start in **Sandbox mode** to test with Scotiabank's test credentials
5. When ready, upgrade to the Professional plan and switch to **Production mode**

== Frequently Asked Questions ==

= Do I need a Scotiabank account to use this plugin? =

Yes. This plugin connects directly to Scotiabank's eCom+ payment gateway, which requires an active Scotiabank merchant account with eCom+ enabled. If you need help setting this up, [contact us](https://wpcompanion.co/contact/) and we'll connect oyu to the right people at Scotiabank.

= Can I test the plugin before purchasing? =

Absolutely. The free version allows you to connect to Scotiabank's sandbox environment and process test transactions. This lets you verify that the plugin works with your theme, page builder, and checkout flow before committing to the Professional plan.

= What's the difference between the Free and Professional plans? =

The free plan gives you full access to sandbox (test) mode so you can verify the integration works on your site. The Professional plan unlocks live payment processing, admin refunds, pre-authorization with partial capture, void transactions, and priority support.

= Are there any transaction fees? =

WP Companion charges zero transaction fees. You pay a flat annual subscription for the Professional plan. The only per-transaction costs are Scotiabank's own merchant processing fees, which are part of your merchant account agreement with the bank.

= Which currencies does the plugin support? =

The plugin supports both USD and your local Caribbean currency (TTD, JMD, BBD, etc.), depending on your Scotiabank eCom+ configuration. You can accept payments in either currency using a standard currency switcher plugin.

= Is the checkout secure? =

Yes. All payment processing happens on Scotiabank's PCI-compliant hosted payment platform. Your website never sees or stores credit card numbers. The plugin also supports 3D Secure 2.0, which adds an additional layer of authentication to protect against fraud.

= Does the payment form redirect customers away from my site? =

No. The Scotiabank hosted payment page is embedded directly on your checkout page using an iframe. Your customers enter their card details without ever leaving your website.

= Can I process refunds from WooCommerce? =

Yes, with the Professional plan. You can process full or partial refunds directly from the WooCommerce order screen (once you activate Scotia's API on your account) — no need to log into Scotiabank's Merchant Admin portal.

= What is pre-authorization and when would I use it? =

Pre-authorization allows you to authorize (hold) an amount on a customer's card at checkout without immediately capturing (charging) it. You can then capture the full amount, a partial amount, or void the authorization entirely — all from your WooCommerce dashboard (with Scotia's API active). This is useful for businesses that need to verify stock, adjust order amounts, or delay fulfillment.

= Does the plugin work with WooCommerce Block Checkout? =

Yes. The plugin is compatible with both the classic WooCommerce checkout and the newer Block Checkout introduced in WooCommerce 8.3.

= I'm a web developer or agency. Do you have a partner program? =

Yes! We offer an agency partner program with referral commissions, free development licenses, priority support, and early access to new features. [Contact us](https://wpcompanion.co/contact/) to learn more.

= Where can I get support? =

Free plan users can use the [WordPress.org support forum](https://wordpress.org/support/plugin/scotiabank-payment-gateway-for-woocommerce/). Professional plan users get priority support — contact us directly through [our website](https://wpcompanion.co/contact/).

== Screenshots ==

1. Plugin settings page — configure your Scotiabank eCom+ credentials, choose sandbox or production mode, and customize payment options.
2. Embedded payment form — customers enter their card details directly on your checkout page without being redirected.
3. WooCommerce order screen — process refunds, captures, and voids directly from the order details.

== Changelog ==

= 2.3.0 =
* Add admin refund processing directly from WooCommerce order screen
* Add void support for pre-authorized transactions
* Add partial capture for pre-authorized transactions
* Add Scotiabank Fiserv API integration for refund, capture, and void operations
* Improve error handling and transaction status reporting

= 2.2.0 =
* Add pre-authorization feature
* Add guards around transactions to reduce duplicate transaction submissions and empty responses from Scotiabank

= 2.1.6 =
* Fix bug that caused the payment form not to load when optional checkout fields had no value

= 2.1.5 =
* Update Freemius SDK, readme.txt and update payment form scroll to center of screen

= 2.1.4 =
* Sanitize code properly to meet WordPress repository standards

= 2.1.3 =
* Update 3D Secure validator value

= 2.0 =
* Updated code to account for new WooCommerce checkout blocks

= 1.0 =
* Initial release

== Upgrade Notice ==

= 2.3.0 =
Major update: Process refunds, captures, and voids directly from your WooCommerce dashboard — no need to log into Scotiabank Merchant Admin. Requires Professional plan for API features.