Plugin MakePay para VirtueMart

Resumen

El plugin MakePay para VirtueMart agrega un método de pago cripto alojado a tiendas Joomla que usan VirtueMart. Los clientes eligen MakePay en checkout, pagan en la página de checkout MakePay y vuelven a la tienda mientras VirtueMart conserva el registro del pedido.

Las notificaciones de pago firmadas actualizan el pedido de VirtueMart después del pago, por lo que el equipo de la tienda puede seguir gestionando pedidos dentro de VirtueMart.

Antes de empezar

• Joomla con VirtueMart instalado
• PHP 7.4 o superior con OpenSSL y cURL habilitados
• URL pública HTTPS de storefront
• Acceso a instalación de extensiones Joomla y métodos de pago VirtueMart
• Una empresa MakePay con liquidación y marca configuradas

Instalar el plugin

Descarga el ZIP más reciente:

https://plugins.makecrypto.io/downloads/virtuemart/latest.zip

En Joomla, abre System > Extensions, sube el ZIP y luego habilita VM Payment - MakePay Crypto Payment Gateway desde el gestor de plugins.

En VirtueMart, abre Payment Methods, crea un método de pago, elige el plugin de pago MakePay y guárdalo una vez para que VirtueMart asigne un ID de método de pago.

Conectar MakePay

Después de guardar el método de pago, abre la URL de conexión desde el storefront. Sustituye PAYMENT_METHOD_ID por el ID de método de pago VirtueMart:

https://store.example.com/index.php?option=com_virtuemart&view=pluginresponse&task=pluginnotification&tmpl=component&makepay_oauth=connect&pm=PAYMENT_METHOD_ID

MakePay te pide iniciar sesión, elegir la empresa que recibirá los pagos y aprobar la conexión. Tras aprobar, el plugin guarda la conexión en ese método de pago VirtueMart y configura la URL de callback MakePay.

Configuración del gateway

Revisa estos campos antes de habilitar públicamente el método de pago:

Ajuste	Propósito
Método de conexión	Usa Connect MakePay para configuración normal, o claves API manuales como fallback
ID de empresa MakePay	Rellenado tras la conexión o introducido manualmente para fallback
Moneda de liquidación	Activo de liquidación preferido, como USDT
Expiración de pago	Cuánto tiempo permanece pagable el enlace de checkout alojado
Secreto de webhook	Usado para verificar notificaciones de pago MakePay
Estados de pedido	Estados VirtueMart para pagos pendientes, pagados, fallidos, expirados, cancelados y reembolsados

Flujo de checkout

Cuando un comprador selecciona MakePay, el plugin crea un enlace de pago MakePay con:

Campo	Propósito
source=virtuemart	Identifica la integración
orderId=virtuemart_order_<id>	Mapea actividad MakePay de vuelta a VirtueMart
orderNumber	Número de pedido VirtueMart mostrado al merchant
pluginVersion	Versión instalada del plugin MakePay
virtuemartVersion	Versión runtime de VirtueMart cuando está disponible

El comprador es redirigido al checkout alojado. MakePay envía luego una notificación firmada al endpoint de notificaciones del plugin de VirtueMart.

Estados del pedido

Estado MakePay	Comportamiento de VirtueMart
paid, completed, confirmed, succeeded	Mueve el pedido al estado pagado configurado
expired	Mueve el pedido al estado expirado configurado
failed	Mueve el pedido al estado fallido configurado
cancelled, canceled	Mueve el pedido al estado cancelado configurado
refunded	Mueve el pedido al estado reembolsado configurado
Otros estados	Se ignoran hasta que llegue un estado final de pago

Cada actualización escribe un comentario privado de pedido con la transacción MakePay, importe, activo y URL de pago cuando esos campos están presentes.

Alternativa con clave API manual

Si no se puede usar el flujo de conexión, establece Connection method en Manual API key fallback e introduce:

• ID de empresa MakePay
• ID de clave API
• Secreto de clave API
• Secreto de webhook

Úsalo solo cuando sea necesario y limita el acceso administrador de Joomla a operadores confiables.

Solución de problemas

Si el checkout no puede iniciar, confirma que el método de pago tenga una conexión de empresa o ajustes manuales de clave API. Si la URL de conexión falla, confirma que el storefront sea HTTPS público y que el valor pm apunte al método de pago MakePay guardado.

Si los pedidos no se actualizan, compara la URL de callback MakePay con la URL de notificación del plugin VirtueMart y rota el secreto de webhook desde los ajustes del método de pago.