Tamara Checkout

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
• Configuration Guide: Tamara WooCommerce Configuration

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