VirtueMart Payment Plugin - Installation Guide

Install the PaymentHood payment gateway in your VirtueMart Joomla store in minutes. Download, install, connect - start accepting payments through 15+ providers instantly.

VirtueMart Integration

PaymentHood for VirtueMart

Accept payments through 15+ providers with a single plugin. Install it on your Joomla / VirtueMart store, connect your account, and start processing payments in minutes.

Download Plugin View on GitHub
Free Plugin Joomla 4.0+ / VirtueMart 4 5-Minute Setup

Installation Guide

Follow these steps to install PaymentHood in your VirtueMart store

1

Download the Plugin

Download the latest PaymentHood plugin for VirtueMart from our GitHub repository. It is a standard Joomla extension package (.zip) — no build steps or extra dependencies required.

Download Plugin
Tip: This link always serves the newest release, so you get the latest features and security updates every time.
2

Upload & Install in Joomla

Log in to your Joomla administrator and go to Extensions → Install. On the Upload Package File tab, drag & drop the ZIP you downloaded (or click Or browse for file). Joomla installs it in seconds and shows “Installation of the plugin was successful.”

Joomla Extensions Install — Upload Package File, installation successful
3

Confirm the Plugin is Installed

Go to Extensions → Manage and search for “VirtueMart - PaymentHood”. You should see it listed as a Site Plugin in the vmpayment folder, by Paymenthood, and enabled.

Joomla Extensions Manage — VirtueMart PaymentHood plugin enabled
4

Open the PaymentHood Plugin

Go to System → Plugins, search for “VM Payment - Paymenthood” (type vmpayment, element paymenthood), and click the plugin name to open its settings.

Joomla Plugins list — open VM Payment - Paymenthood
5

Configure & Connect Your Account

Set the Display name shown to customers at checkout (e.g. PaymentHood) and turn on Sandbox mode while you are testing. Then click Connect to Paymenthood to link your account.

VirtueMart PaymentHood settings — connect account and localhost webhook warning
Running on localhost? Webhooks can’t reach your machine. If your Joomla site runs on a localhost / private network URL, PaymentHood’s webhook notifications cannot be delivered to your computer, so payment status updates will not be received. To receive webhooks, deploy your store to a public domain, or expose your local site with a tunnel such as Cloudflare Tunnel or ngrok — the plugin links to our Cloudflare Tunnel guide right in this warning.
On a public domain you won’t see the warning above — the account panel goes straight to the Connect to Paymenthood action.
VirtueMart PaymentHood settings on a public domain — no webhook warning
6

Complete Your Sandbox & Live Setup

Once connected, the panel shows “PaymentHood is connected” with two environments — Sandbox (for trial transactions) and Live (for real payments). Click Complete Setup on an environment to be taken to the PaymentHood Console to configure it.

Our strong recommendation: set up your Sandbox environment and test the full checkout before switching to Live.
PaymentHood connected — complete Sandbox and Live setup
7

Add Your Payment Gateways

When an environment is configured it shows “Sandbox account is ready” (or Live). Use Manage Gateways to add and enable the providers you want — PayPal, Stripe, Authorize.net, Adyen, and more — all from your PaymentHood account.

PaymentHood — Sandbox ready, Manage Gateways
All set! Test thoroughly in Sandbox, then run the same Complete Setup for your Live environment to start accepting real payments.
8

Define a Payment Method in VirtueMart

For PaymentHood to appear at checkout, define a payment method in the VirtueMart component. Go to VirtueMart → Shop → Payment Methods and click New. Give it a Payment Name (e.g. PaymentHood), set Published to Yes, then choose Payment Method → plg_vmpayment_paymenthood and Save.

VirtueMart — define a PaymentHood payment method
Tip: Pick your store's Currency and assign a Shopper Group if needed — once saved, PaymentHood shows up as an option on the VirtueMart checkout.
9

What Your Customers See at Checkout

At checkout, shoppers select PaymentHood and confirm their purchase. They're securely redirected to PaymentHood to pay, then returned to a clear confirmation — the Sandbox badge shows you're still in test mode.

VirtueMart checkout — select PaymentHood and confirm purchase
VirtueMart — payment successful confirmation

Ready to Get Started?

Download the PaymentHood VirtueMart plugin and start accepting payments in minutes.

Download Plugin GitHub