=== Tamara Checkout ===
Contributors: tamarasolution, npbtrac, kimloile
Tags: e-commerce, bnpl, pay in 3, pay by installments
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.3.0
Stable tag: 1.9.9.20
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

With Tamara Buy Now Pay Later, you can split your payments – totally interest-free. Accepts payments from Mada, Apple Pay, or Credit Cards.

== Tamara for WooCommerce ==

Attract customers, boost sales, and increase conversions with Tamara's flexible payment solutions!

Upgrade your WooCommerce store with Tamara's seamless Buy Now Pay Later (BNPL) solutions. With Tamara, you can offer your customers the flexibility to split their purchases in up to 4 easy payments – no late fees and Sharia-compliant.

Our WooCommerce payment gateway integration is designed to optimize your ecommerce checkout solution, helping you reduce payment risks, improving your cash flow by receiving full payment upfront, and accessing millions of Tamara users across the GCC region.

### Features:
_Flexible payments for your customers. Full up-front payments for you._
* **Flexible Payment Optionn:** Allow your customers to split payments with our BNPL solutions, supported by a reliable WooCommerce payment gateway. Customers can split payments into 2, 3 and 4 instalments or pay in full.
* **Seamless Payment Gateway Integration:** Quick and easy WooCommerce payment gateway setup with a user-friendly experience.
* **Risk-Free Transactions:** Tamara assumes full fraud and credit risks.

### Benefits to Merchants:
_Increase your sales and improve customer satisfaction all with one smart and seamless shopping solution._
* **Boost Conversions and Average Order Value:** Make checkout smoother and drive bigger purchases with a trusted ecommerce checkout solution.
* **Receive Full Payments Upfront:** Improve your cash flow while giving customers the flexibility to pay over time.
* **Reduce Costs and COD Issues:** Cut customer acquisition costs, minimize refunds, and eliminate cash-on-delivery risks.
* **Access a Wider Customer Base:** Tap into Tamara’s growing network of users.

Tamara is more than just a payment gateway - it's the ecommerce checkout solution to elevate your business.
### How to Get Started?
* Installation Guide: [Tamara WooCommerce Installation](https://docs.tamara.co/docs/woo-installation)
* Configuration Guide: [Tamara WooCommerce Configuration](https://docs.tamara.co/docs/woo-configuration)


== Installation ==

= Minimum Requirements =

* PHP 7.3 or greater
* Wordpress 5.2 or greater is recommended
* Woocommerce 4.0 or greater is recommended

### Install and Enable/Disable the plugin
* The Tamara Checkout plugin is now available for WordPress. After installing it, simply click on **Activate** the plugin.
* Please note that the plugin can only be activated when Woocommerce is active.
* After the plugin is activated, there is an option to Enable/Disable the plugin in **Woocommerce => Settings => Payments => Tamara Gateway Settings**

You can find out more how to install and use the plugin with our user guides documentation.
* Installation Guide: [Tamara WooCommerce Installation](https://docs.tamara.co/docs/woo-installation)
* Configuration Guide: [Tamara WooCommerce Configuration](https://docs.tamara.co/docs/woo-configuration)

== Changelog ==

= 1.9.9.20 - 2026-06-20 =

Enhancements:

* Adjust the translation
* Change the default widget position to before cart form
* Fix some UI bugs

= 1.9.9.10 - 2025-08-11 =

Enhancements:

* Fix some minor bugs

= 1.9.9.6 - 2025-03-12 =

Enhancements:

* Update the single checkout widget

= 1.9.9.5 - 2025-01-30 =

Enhancements:

* Fix the security concerns
* Fix the issue on 'order-pay' for excluded product and category ids
* Fix some bugs

= 1.9.9 - 2024-10-22 =

Enhancements:

* Update the dependencies to remove warnings for PHP 8.1+

= 1.9.8 - 2024-10-21 =

Bugfixes:

* Fix the cron issues

= 1.9.7 - 2024-07-18 =

Bugfixes:

* Fix duplicated payment options bug
* Fix payment error when buying unavailable products

= 1.9.6 - 2023-11-18 =

Bugfixes:

* Fix public key related bugs

= 1.9.4 - 2023-07-10 =

Enhancements:

* Add customer risk assessment data to Tamara checkout session.

= 1.9.2 - 2023-02-22 =

Bugfixes:

* Fix errors while adjusting payment types on checkout.
* Add method to fetch payment types from supported countries only.

= 1.9.1 - 2023-02-21 =

Enhancements:

* Remove api url as readonly field and update default value.
* Update Tamara payment methods offset on checkout.

= 1.9.0 - 2023-01-07 =

Enhancements:

* Fetch payment options avalibility and show on checkout.
* Remove manual select payment options in admin screens.
* Update widgets and enhance admin settings screen.

= 1.8.10 - 2022-11-4 =

Bugfixes:

* Remove old dependencies packages in vendor directory.

= 1.8.9 - 2022-11-3 =

Bugfixes:

* Fix package dependencies namespace conflicts.

= 1.8.8 - 2022-10-12 =

Enhancements:

* Revert detect Single Checkout option.
* Add Pay In 2 payment method.

= 1.8.7 - 2022-09-13 =

Enhancements:

* Add Single Checkout admin option field to enable/disable it manually.
* Add Popup widet on cart page option.

= 1.8.6 - 2022-08-25 =

Enhancements:

* Update Pay Now title and description on checkout.
* Enhance Tamara help text in Admin settings.

== Changelog ==

= 1.8.5 - 2022-08-12 =

Enhancements:

* Add Pay Now payment method.

= 1.8.4 - 2022-07-29 =

Bugfixes:

* Fix PDP widget not showing when script is cached.

= 1.8.3 - 2022-07-29 =

Enhancements:

* Update new scripts url to checkout widget.

= 1.8.2 - 2022-07-20 =

Enhancements:

* Remove unused scripts.

= 1.8.1 - 2022-07-16 =

Enhancements:

* Update PHP Minimum Requirements to 7.1+.
* Remove unused scripts.

= 1.8.0 - 2022-07-12 =

Enhancements:

* Add Tamara Single Checkout Feature which redirect customer to Tamara page directly instead of selecting Tamara payment options at checkout step.
* Enhance creating Tamara order via RestAPI.

= 1.7.7 - 2022-07-03 =

Enhancements:

* Add Public key field to Widgets.

Bugfixes:

* Fix error on Default Billing Country field on init.

= 1.7.6 - 2022-06-10 =

Enhancements:

* Use default title and description for payment types on checkout.
* Update Discount name when creating Tamara order for checkout session.
* Add new option field "Public Key" used for Popup widget.

= 1.7.5 - 2022-05-11 =

Enhancements:

* Update available amount to display popup widget on single product page.

= 1.7.4 - 2022-04-23 =

Enhancements:

* Update new Tamara logo on payment success page.
* Enhance Tamara setting option fields in Admin.

= 1.7.3 - 2022-04-02 =

Enhancements:

* Update new Tamara logo and PDP badge.
* Add BHD currency options.

= 1.7.2 - 2022-03-08 =

Enhancements:

* Only display the PDP widget and Tamara payment options on supported currency.

= 1.7 - 2021-12-30 =

Bugfixes:

* Add Credit Precheck feature option on checkout.
* Update default Arabic title for Pay In Xs on checkout.

= 1.6.18 - 2021-12-25 =

Bugfixes:

* Fix conflicts with WooCommerce multiple currencies.
* Update PDP Widget price when product's price is out of all limits.
* Turn all instalment plans settings off when it's unavailable.

= 1.6.17 - 2021-12-16 =

Enhancements:

* Keep cart items for orders with cancelled/failed payments from Tamara.
* Update PDP Widget price according to selected variation product price.
* Enhance Default Billing Country and Allowed Shipping Country field options in settings.

= 1.6.16 - 2021-12-02 =

Enhancements:

* Adjust priority payment methods displayed on popup widget.
* Adjust description country text on checkout box.

= 1.6.15 - 2021-11-09 =

Enhancements:

* Add Disable Tamara popup widget option on single product page.

= 1.6.14 - 2021-10-20 =

Enhancements:

* Raise admin error if allowed shipping country codes setting is empty.
* Add help text for allowed shipping country codes setting.

Bugfixes:

* Fix conflicts when making a refund for orders paid via other payments.

= 1.6.13 - 2021-10-14 =

Enhancements:

* Add always show Tamara popup widget on single product page option.

= 1.6.12 - 2021-10-07 =

Enhancements:

* Add payment type options for Kuwait and KWD currency.

= 1.6.11 - 2021-09-27 =

Bugfixes:

* Fix Tamara icon's height issue on checkout.

= 1.6.10 - 2021-09-22 =

Enhancements:

* Add enable Pay Later popup widget option on single product page.
* For re-capture event, update capture id to order meta data if it's already captured.
* Update status to successful if a re-capture event happens.
* Update new checkout icon.

= 1.6.9 - 2021-09-17 =

Enhancements:

* Fix refund event issue when auto capture is enabled.
* Update helptext description for refund event.

= 1.6.8 - 2021-09-11 =

Enhancements:

* Add excluded products and product categories options.
* Update error message when duplicated capture payment occurs.

= 1.6.7 - 2021-09-08 =

Enhancements:

* Move all inline scripts to js files.

= 1.6.6 - 2021-09-06 =

Bugfixes:

* Fix duplicate instalment plan widget on updated checkout.

= 1.6.5 - 2021-09-05 =

Bugfixes:

* Fix Pay In X titles error on completed order.
* Add more payment method ids on trigger Tamara events.
* Update Tamara success url to default WooCommerce order received page.

= 1.6.4 - 2021-08-24 =

Enhancements:

* Update help texts description.
* Update default titles for Pay In X.

Bugfixes:

* Hide Pay Later options if none is set from Tamara remote.
* Update new limits to options after being pulled from Tamara remote.
* Fix raise admin error if credential information is not correct or empty.

= 1.6.3 - 2021-08-19 =

Bugfixes:

* Fix description text styles on checkout.
* Fix styles dir attribtute for rtl.
* Update button color in Admin settings.
* Fix redirect url text translation on Tamara success page.

= 1.6.2 - 2021-08-18 =

Bugfixes:

* Fix redirect url on Tamara success page.

= 1.6.1 - 2021-08-17 =

Enhancements:

* Show help texts description by default.
* Shorten Tamara custom debug log displayed in Admin Settings.
* Add download link for Tamara custom debug log in Admin Settings.

Bugfixes:

* Fix Tamara widget call errors all checkout and product page.
* Remove Pay Later settings if none is set from Tamara remote.

= 1.6.0 - 2021-08-10 =

Enhancements:

* Remove Pay By Instalments and add Tamara Pay In X (from 3 to 12 instalments).
* Add Tamara redirect url to meta tag on payment success page.
* Update payment types descriptions on checkout.
* Add help texts description within settings fields.
* Add Pay In X Options fields in settings.
* Update Pay In X settings for order created via RESTAPI.
* Re-organize all settings fields.
* Update Tamara product widgets and checkout widgets for Pay In X.

Bugfixes:

* Fix pulling payment types min/max error on first settings saved.
* Fix payment methods order on checkout.

= 1.5.5 - 2021-07-15 =

Enhancements:

* Add Tamara success content shortcode [tamara_success_html].
* Add After Tamara success action hook `after_tamara_success`.
* Add Tamara authorise order shortcode [tamara_authorise_order].
* Add Tamara after payment cancelled filter hook `after_tamara_cancel`.
* Add Tamara after payment failed filter hook `after_tamara_failure`.

Bugfixes:

* Update default Authorised Done order status.

= 1.5.1 - 2021-06-15 =

Enhancements:

* Update Pay in 3 description on checkout.
* Add shortcode attributes for [tamara_shop_popup] widget.
* Add shortcode to print out Tamara success content.
* Add custom page option for Tamara success content.
* Update default status for Tamara Authorised success.

Bugfixes:

* Fix WC default country location on checkout.
* Fix Tamara success page layout.

= 1.5.0 - 2021-04-19 =

Enhancements:

* Split payment types into 2 different methods on checkout screen.
* Add before add to cart form position to display popup.
* Add custom title fields for payment types on both languages EN & AR.
* Add default titles for payment types on both languages EN & AR.
* Update descriptions on checkout screen for payment types.
* Update translation files for new strings.

= 1.4.31 - 2021-04-07 =

Bugfixes:

* Fix response for order created failed through Rest API.
* Update payment type param format for request body.

= 1.4.30 - 2021-04-07 =

Bugfixes:

* Fix limit amounts for each country payment types on checkout.


= 1.4.29 - 2021-03-18 =

Enhancements:

* Add Tamara Cancel Id to order meta data.
* Disable Iframe checkout on mobile.
* Add Tamara checkout data to order meta data created through RESTAPI.
 * Create WC Order Endpoint `wp-json/wc/v3/orders/`:
  - "meta_data": [
            {
                "key": "tamara_checkout_session_id",
                "value": "18f6efe9-6cac-48a2-bc79-28b3317a8b96"
            },
            {
                "key": "tamara_checkout_url",
                "value": "https://checkout-sandbox.tamara.co/checkout/18f6efe9-6cac-48a2-bc79-28b3317a8b96?locale=en_US&orderId=9dde35e1-259f-423b-9149-c259e393ea35"
            }
        ]
 * Get Order details Endpoint `wp-json/wc/v3/orders/{order-id}`:
  - "meta_data": [
            {
                "key": "tamara_checkout_session_id",
                "value": "8944639c-e762-4939-a230-7ceca309c561"
            },
            {
                "key": "tamara_checkout_url",
                "value": "https://checkout-sandbox.tamara.co/checkout/8944639c-e762-4939-a230-7ceca309c561?locale=en_US&orderId=8f893a5f-ca3a-4691-a9cf-036758234d08"
            }
        ]

= 1.4.26 - 2021-03-02 =

Bugfixes:

* Add limit amount for Pay By Later popup widget to display on frontend.
* Add force pull from remote param for get payment types through Tamara API.

Enhancements:

* Update translation files for new error codes.

= 1.4.25 - 2021-02-25 =

Enhancements:

* Edit instalment plans amount to display on frontend.
* Add default country code to verify Tamara API.

= 1.4.22 - 2021-01-30 =

Bugfixes:

* Get correct product price to display on instalment popup.
* Fix Tamara widget call repeat on checkout.
* Add redirect url on order pay page.

= 1.4.6 - 2020-12-30 =

Enhancements:

* Improve Tamara popups to have better view.
* Use custom scripts to call Tamara widgets.
* Remove Capture ID in condition when creating a Refund request.

= 1.4.4 - 2020-12-09 =

Enhancements:

* Improve Tamara popups to have better view.
* Edit get Woocommerce checkout/cart methods.
* Update translation for Arabic language.

= 1.4.1 - 2020-12-03 =

Enhancements:

* Improve Tamara Checkout fields to have better view.
* Edit options for Pay By Later and Pay By Instalments on checkout.

= 1.4.0 - 2020-11-30 =

Bugfixes:

* Fix errors and not loading services when unused.
* Move some methods to Tamara Checkout class.

Enhancements:

* Add Tamara Pay By Instalments service.
* Add Update status and add order note wrapper.
* Add options for Pay By Later and Pay By Instalments.

= 1.3.4 - 2020-11-12 =

Bugfixes:

* Fix errors on duplicate Jquery modal script.
* Enhance get payment types method.
* Fix payment icon layout displays on checkout.

Enhancements:

* Add allowed shipping country codes option.
* Hide Tamara Payment method on checkout if the total order is under/over limit.
* Polish Tamara Success page returned.

= 1.3.3 - 2020-11-12 =

Bugfixes:

* Fix errors on check Woocommerce existence.

Enhancements:

* Add allow message log option.

= 1.2.8 - 2020-11-03 =

Bugfixes:

* Fix errors display on Iframe checkout.
* Add some error codes for error displaying on checkout.
* Fix errors when webhook id value displays on Admin settings page.

Enhancements:

* Not run the webhook events on authorised orders.

= 1.2.3 - 2020-09-25 =

Bugfixes:

* Fix errors display on Iframe checkout.
* Edit the parse request to fix conflicts with other plugins.

= 1.2.2 - 2020-09-20 =

Enhancements:

* Add Iframe for Tamara Checkout.

= 1.2.1 - 2020-09-19 =

Enhancements:

* Add specific endpoints for merchant urls.

= 1.2.0 - 2020-09-18 =

Enhancements:

* Add Custom Tamara status for Capturing Payment.

= 1.1.9 - 2020-09-13 =

Bugfixes:

* Fix automatic disabling issue.
* Repair to have better readme file.

= 1.1.8 - 2020-09-06 =

Bugfixes:

* Fixes errors displayed on Checkout page.

Enhancements:

* Add webhook to handle Order declined and Order expired from Tamara.
* Update the Arabic translation.

= 1.0 - 2020-08-28 =

Release version
