# Instalar Paymos en HikaShop

> Instala el plugin en Joomla, conecta tu proyecto Paymos y consulta pagos y reembolsos desde los pedidos de HikaShop.

El plugin añade un método de pago en criptomonedas a HikaShop. Los clientes pagan en la página de Paymos y tú sigues gestionando el pedido en Joomla.

## Antes de instalar

Necesitas Joomla 5.4 o 6.2, HikaShop 6.8.1 o posterior dentro de la rama 6.8 y PHP 8.3 o posterior con cURL y OpenSSL. La tienda debe estar accesible por HTTPS público. Usa InnoDB en las tablas de pedidos, historial de pedidos, productos, productos del pedido, descuentos y usuarios. En HikaShop, fija **Order created status** en `created` y comprueba que existan los estados `confirmed` y `refunded`.

## Del ZIP al primer cobro

1. Descarga el [ZIP gratuito para Joomla](https://github.com/Paymos-labs/hikashop/releases/latest). En Joomla, abre **System → Install → Extensions** y sube el archivo.
2. Ve a **System → Manage → Plugins** y activa **Payment - Paymos for HikaShop**.
3. En **System → Payment methods** de HikaShop, crea y guarda un método Paymos. Pulsa **Connect Paymos** y autoriza el proyecto que vas a usar.
4. Selecciona **Sandbox**, guarda el método y publícalo cuando vayas a probarlo. Sandbox no mueve fondos reales. Para cobrar a clientes, selecciona **Live**, guarda y publica el método.

El plugin cifra las credenciales con el secreto de tu instalación de Joomla. Si cambia la URL canónica de la tienda, vuelve a conectar el proyecto.

## Qué mirar antes de preparar un pedido

La página de pago usa el importe y la moneda guardados en el pedido. El plugin verifica la firma del aviso y coteja el pago con la API antes de confirmar el pedido. Si la comprobación acredita el importe total o un pago de más, el plugin confirma el pedido una sola vez. Si falta dinero, el pedido sigue sin confirmar. Revisa los pagos tardíos o con discrepancias. Si faltó el aviso, abre el pedido y pulsa **Check payment**. Tú inicias esta consulta desde el panel, sin configurar una tarea programada.

Puedes configurar **Success URL** en el proyecto Paymos para devolver al comprador a Joomla. Añade `/index.php?option=com_hikashop&ctrl=checkout&task=after_end` a la URL base de Joomla. El retorno indica que el comprador ha vuelto a la tienda. Para saber si puedes preparar el pedido, comprueba su estado en HikaShop.

## Reembolsos y desconexión

Con los reembolsos habilitados, abre un pedido que cumpla los requisitos y solicita la devolución completa o solo del exceso. El servidor calcula el importe y lo dirige a la dirección que envió el pago. Mientras la solicitud esté pendiente, el estado del pedido no cambia. Usa **Check refund** para consultar esa solicitud. Al verificarse el reembolso total, el pedido pasa a `refunded`. Si devuelves el exceso, el pedido conserva el estado que tenga, por ejemplo, enviado o entregado. El reembolso queda en el historial. La red puede cobrar una comisión. Consulta la [guía de reembolsos](/es/docs/support/refunds.md).

Resuelve las solicitudes pendientes antes de pulsar **Disconnect** o desinstalar el plugin. Se borran las credenciales locales. HikaShop conserva los pedidos y su historial.

## Licencia

El plugin usa [GPL-2.0-or-later](https://github.com/Paymos-labs/hikashop/blob/main/LICENSE) y el SDK usa MIT.
