Himalayan Bank Payment Gateway Integration Plugin for WooCommerce

If you’re running a WooCommerce store in Nepal and want to accept payments through Himalayan Bank, this guide will show you how to integrate their payment gateway into your site. It will help you set up secure transactions for your customers, making payments easier and more reliable. With this setup, your store can handle payments smoothly and provide a better experience for both you and your customers.

Himalayan Bank’s payment gateway supports credit card payments, making it convenient for customers to pay using their international credit cards. This feature is essential for businesses looking to reach customers beyond Nepal, allowing for smooth, secure transactions directly on your WooCommerce site. Whether you’re a travel and trek business owner, or you just want to integrate payment method in your WooCommerce site, this plugin is for you.

Requirements

To successfully integrate Himalayan Bank payments with your WooCommerce site, you’ll need to meet the following technical requirements:

👉 Himalayan Bank Merchant Account

👉 Website built with WordPress and products with WooCommerce. If you haven’t got the domain and hosting yet, I recommend getting it from Babal Host.

👉 PHP 8.1 or higher.

👉 PHP Sodium Extension.

👉 PHP GMP Extension – Optional but strongly recommended. Learn More.

If you’re unsure about meeting these requirements, feel free to contact me or your web host for assistance.

Pricing

* Support is limited to the plugin’s territory. E.g. plugin installation, licenses, bug fixes etc. Configuration and issues with the Bank Merchant are not the plugin’s territory.

* 100% refund when the product had a bug/problem I couldn’t resolve.

* Checkout and Payment are processed from Freemius – the reseller of the plugin.

Have pre-sale questions? Contact Me or send a message on Whatsapp.

Installation

1. Log into your WordPress site: https://example.com/wp-admin
2. Go to Plugins > Add New > Upload Plugin
3. Upload the plugin’s zip file which will be sent to your email when you purchase.
4. Install and activate the plugin.

If you’re new to WordPress, here’s a beginner’s guide on how to install a WordPress plugin.

Once you activate the plugin, you’ll have to enter the license key which you’ll receive in your email.

If you don’t see this popup window, go to Plugins > Add Himalayan Bank In WooCommerce and then click on Activate License.

Setup

Once you install and activate the Himalayan Bank Payment For WooCommerce plugin, you’ll see new payment settings in WooCommerce.So, Navigate to WooCommerce > Settings > Payments, there will be a new option, Himalayan Bank.

Click on the “Manage” button to set up the payments and settings.

As you can see in the screenshot, you’ll need Merchant ID and API key to accept the payment on your Merchant account. For the Himalayan Bank to set up your Merchant account, you’ll need to provide the Public Signing Key and Public Encryption Key to Himalayan Bank.

You should generate the keys by yourself. Use this tool to generate the keys.

Steps:

1) Select 4096 bit RSA key size from the drop-down.

2) Click on Generate RSA Key Pair, it will generate the Public Key and Private Key (call them the Signing Keys)

3) Go back to your site’s settings and paste the Public Key and Private Key in the fields: “Public Signing Key” and “Private Signing Key”.

4) Once again, click on Generate RSA Key Pair, it will generate a new Public Key and Private Key (call them the Encryption Keys)

5) Go back to your site’s settings and paste the Public Key and Private Key in the fields: “Public Encryption Key” and “Private Encryption Key”.

Once you fill the keys, the settings will look something like this:

Provide the Public Signing Key and Public Encryption key to Himalayan Bank, they’ll set up your live Merchant. You should not share the Private Keys with anyone.

We’re done with the setup. now the pay with Himalayan Bank option will appear in the checkout where customers can pay directly via their credit card. They will be redirected to the HBL payment to securely pay with Credit Cards.

Or, If you’re using On-Site Checkout, the credit card form will appear on your site. This feature however requires you to be a PCI complaint. Read more.

Got issues?

Please carefully follow the setup instructions above especially the generation and sharing of signing/encryption keys. Most issues are probably due to incorrect Merchant Setup or configuration. However, technical errors do occur sometimes. If you face any issues, please turn on debugging from WooCommerce > Settings > Payments > Himalayan Bank Payment.

Then, check out again to log the error.

After that, you can get the log details in WooCommerce > Status > Logs.

These details might tell you what went wrong or you can share the details with the bank support.

FAQ

ERROR: Unable to load or decrypt token

Issue with keys. The keys bank used to create the Merchant doesn’t match the keys you’ve set in the plugin settings. Consult with bank support to check your keys.

ERROR: The JWT can not be used yet

Claim failed. You’re possibly ahead of time, : ) or used a nulled plugin. Send me the details of the logs and I’ll help to check.

Payment authentication service error.
Payment not success. Do not honour.

Probably credit card’s issue.

Technical details. Do not honour.
Call to aquirer failed.

An error by the customer’s card acquirer (bank), not because of Himalayan Bank or the plugin. The used credit card issuer can’t process transactions at the time. Try using another card.

Error: Payment type not support

In most cases, the Merchant account has been made inactive. Contact bank support with your Merchant details.

Error: Unsupported Media Type

Possible issue with your custom codes, nulled plugin. Make sure you’re using the genuine plugin with the license key.

Don’t just hear my words!

I am using this plugin to accept payments from cross border countries as well as in Nepal. The amazing feature is that it supports 2 currencies and i love using it.

Dipshan Sharma

Exceptionally easy to set up and flawlessly functional, this HBL wordpress plugin is a game-changer for seamless integration. Kudos to Sanzeeb 🙂

frensrazer

Thank you so much Mr. Sanjeeb Aryal for the Himalayan Bank WooCommerce Plugin for WordPress. We are a startup Travel Agent based in Kathmandu and were really worried about setting up our website and implementing WooCommerce on it. But Mr. Aryal really helped us a lot with every step while setting the plugin. It really meant a lot. Thank You so much WordPress, Mr. Aryal, WooCommerce and Himalayan Bank. We highly recommend the plugin. Regards Biraj Sharma Adhikari IT Officer Cordial Trek Pvt. Ltd. Kathmandu, Nepal

Biraj Sharma Adhikari

and many others..

Hey! Do you have a Nabil Bank Merchant instead? You can set up a Nabil Bank Payment Gateway For WooCommerce.