PayHere Payment Gateway Plugin for WooCommerce

July 23, 2024

PayHere Payment Gateway Plugin for WooCommerce Plugin

PayHere Payment Gateway Plugin for WooCommerce

PayHere is a Sri Lankan Payment Gateway Service that enables you to accept payments online from your customers via Visa, MasterCard, Amex, eZcash, mCash & Internet Banking services. You can install this plugin to list PayHere as a payment method in your WooCommerce store.

Installation

Upload the plugin files to the /wp-content/plugins/plugin-name directory, or install the plugin through the WordPress plugins screen directly.
Activate the plugin through the ‘Plugins’ screen in WordPress
Use the WooCommerce->Settings->Checkout->PayHere screen to configure the plugin with your PayHere Merchant Account
Make sure you tick the Sandbox Mode checkbox if you want to test the plugin with your PayHere Sandbox account

Screenshots

PayHere configuration on WooCommerce admin area
PayHere subscription settings
PayHere Checkout page
PayHere Tokenized Customers list
PayHere Saved Cards Menu for Customers
Pay with saved card options
PayHere Hold on Card Capture

FAQ

How to sign up for a PayHere Merchant Account?

Go to PayHere website & apply for a Merchant Account.
https://www.payhere.lk

How to enable On-site checkout?

Go to WooCommerce Settings > Payments > PayHere > Manage and tick “Enable On-site checkout”

Does the plugin support WooCommerce Subscriptions?

Yes. Supported Subscription products can be checked out with the gateway.

What are the limitations in support for WooCommerce Subscriptions?

Only one subscription can be checked out at one time
An order cannot contain normal and subscription products
Trial and billing periods must be equal
The trial length cannot be larger than one billing period
Synchronized subscriptions are not supported
Free trials cannot be processed

How do customers use the Save Card Feature?

You should be a PayHere PREMIUM plan subscriber or using a PayHere Sandbox account to use this feature. After enabling the feature as explained in the “How do I use Use PayHere Tokenized Cards?”, customers will automatically see a “Save Card” tick mark when paying.

On their next visits, customers will be offered the option of paying with their saved card.

Can customers remove their Saved Card?

Yes. Customers should to navigate to My Account > Saved Cards. This menu will only appear for customers with saved cards.

Once in the menu, click “Remove Card”.

How do I integrate PayHere Tokenized Cards?

You should be a PayHere PREMIUM plan subscriber or using a PayHere Sandbox account to use this feature
Login to your PayHere Merchant Account
Navigate to Settings > Business Apps > Create App
Generate an App ID and App Secret
Go to WooCommerce Settings > Payments > PayHere > Manage
Click “Enable Tokenizer”
Copy and paste the App ID and App Secret generated in Step 4
Click Save

Can I view the list of customers with Pre-approved (saved) cards?

Yes. Navigate to WooCommerce > Cards on files

The plugin gets de-activated after updating to version 2.0.*

Go to WP-Admin > Plugins, and re-activated the PayHere plugin.

Changelog

1.0.0

Initial public release

1.0.1

Fixed PayHere logo not showing issue

1.0.2

Fixed redirecting issue

1.0.3

Fixed Return URL issue in latest WP versions

1.0.4

Added support for On-site checkout

1.0.5

Fixed issue with On-site checkout in live mode

1.0.6

Fixed various issues

1.0.7

Fixed various issues

1.0.8

Bug fixes
WooCommerce Subscription Support

1.0.9

Bug fixes

1.0.10

Added support for Tokenized Payments

1.0.11

Added support for delete tokenized card payments

1.0.12

Added option to show/hide save card in frontend.

1.0.13

Fixed not Empty cart issue.

1.0.14

Fixed not auto redirecting issue on checkout page.

1.0.15

Fixed if woocommerce not active error plugin breaks and cannot login to the site.

1.0.16

Fixes bug caused by WordPress optimization, where Payment starts before PayHere.js is loaded.

1.0.17

Added better support for orders with many items.

1.0.18

Added in-code order blacklisting capabilities.

1.0.19

Small bug fix for Tokenize payments.

1.0.20

Remove Auto Trigger authorize payment if Card is already tokenized.

2.0.0

Hold on card support with small bug fixes.

2.0.1

Small bug fix for invalid amount format.

2.0.2

Small bug fix and add notice for hold on card support.

2.0.3

Small bug fix for authorization payment activated by default.

2.0.4

Fix a bug for some themes giving an error when editing a Post or a Page.

2.0.5

Added support for daily recurring payments.

2.1.0

Added input sanitizing for form fields to fix vulnerability issues.

2.1.1

Code standardize to PSR12 and WordPress

2.2.3

Code standardize to PSR12 and WordPress

2.2.4

Fix the issue with “Something went wrong” after the latest update (2.2.3)

2.2.5

Fix the issue with the Order complete message

2.2.6

Fix the issue with the Merchant ID not set in the backend and the frontend

2.2.7

Fix the issue with the redirect page not found.

2.2.8

Fix the issue with the redirect page not found and issue with plugin error when de-activate and activate.

2.2.9

Remove the line item name list from the “items” parameter and replace with the order id.

2.2.10

Fix the “order_key was called incorrectly” issue in thankyou page.

2.2.11

Fix the vulnerability with payhere logs.

2.2.12

Fix the vulnerability with payhere logs and disabled the loggin function.

2.2.13

Fix the issue with the Chackout page show deprecated warning/error.

2.3.0

Added support for WordPress blocks and resolved issues on the redirect page.

2.3.1

Fixed the issue occurring during plugin activation and update.

2.3.2

Fixed the issues occurring during plugin activation and update.

2.3.4

Enabled support for changing the gateway icon, resolved the issues with WordPress Blocks, and fixed the gateway viewing issue.

2.3.5

Fixed the issue with the text message when redirecting to the order-received page while the payment is pending.

2.3.6

Fixed the issue of the pay button duplication.