# Accept crypto payments in HikaShop

> Install the Paymos plugin in Joomla, test a HikaShop payment, and check payment and refund status on the order.

The Paymos plugin adds a payment method to HikaShop on Joomla. Buyers choose it at checkout and pay on a hosted page.

## Before you install

Use Joomla 5.4 or 6.2, HikaShop 6.8.1 or a later 6.8 patch, and PHP 8.3 or later with cURL and OpenSSL. The store must be reachable over public HTTPS. Keep HikaShop's native order, order history, product, order product, discount, and user tables on InnoDB. In HikaShop, set **Order created status** to `created`. Keep the `confirmed` and `refunded` order statuses available.

## Install the ZIP and connect a project

1. Download the [free Joomla extension ZIP](https://github.com/Paymos-labs/hikashop/releases/latest). In Joomla, upload it under **System → Install → Extensions**.
2. Under **System → Manage → Plugins**, enable **Payment - Paymos for HikaShop**.
3. In HikaShop, open **System → Payment methods**. Create and save a Paymos method, choose **Connect Paymos**, then select your project in Paymos.
4. Save the method in **Sandbox** and publish it for your test audience. Place an order and check its status after paying. Switch the method to **Live** when you're ready to publish it for buyers.

Joomla's installation secret encrypts the connection keys. If your store's canonical address changes, reconnect the payment method.

## Read the order status after checkout

The plugin uses the amount and currency saved on the order. It checks the webhook signature and verifies through the API that the payment matches the order details. A verified payment confirms the order once if it covers the full amount, even if the buyer paid more. Underpaid orders stay unconfirmed; review late payments or mismatched details before fulfilling the order.

If you missed a notification, open the order in HikaShop and use **Check payment**. The plugin doesn't run a scheduled payment check.

The buyer's return doesn't confirm the order. To send the buyer to HikaShop after checkout, you can set the project's **Success URL** to your Joomla base URL followed by `/index.php?option=com_hikashop&ctrl=checkout&task=after_end`. That setting applies to the project.

## Refund a payment or an overpayment

Open the order to start an eligible refund if you've enabled refunds. The API calculates the amount; the refund goes to the recorded sender. Network fees may apply. Use **Check refund** to check a refund you've already started.

A pending refund leaves the order status unchanged. A completed full refund moves it to `refunded`; a completed overpayment refund keeps the current order status and adds an order history entry. See [how refunds work](/docs/support/refunds.md).

Resolve outstanding payments and refunds before you disconnect or uninstall. Either action clears the connection credentials. Your HikaShop orders and their history remain.

## License

The [extension license](https://github.com/Paymos-labs/hikashop/blob/main/LICENSE) is GPL-2.0-or-later. The bundled SDK is MIT-licensed.
