Plugins de e-commerce
Gateway de WISECP
Instala y configura el gateway oficial de WISECP para checkout alojado MakePay en facturas de hosting y servicios.
Gateway MakePay para WISECP
El gateway oficial MakePay para WISECP permite que clientes paguen facturas mediante checkout cripto alojado. WISECP conserva el control de clientes, facturas, servicios, renovaciones y aprovisionamiento. MakePay crea el enlace de checkout y envía actualizaciones de pago de vuelta a WISECP.
Esto es útil para proveedores de hosting, equipos SaaS, agencias y negocios de servicios que ya facturan con WISECP.
Antes de empezar
Necesitas:
- WISECP 3.1.7 o superior
- Instalación WISECP HTTPS
- Acceso de administrador a ajustes de gateway de pago WISECP
- Liquidación y marca MakePay configuradas
Instalar el gateway
Descarga el paquete más reciente:
https://plugins.makecrypto.io/downloads/wisecp/latest.zip
Extrae el ZIP y sube la carpeta MakePay a:
WISECP/coremio/modules/Payment/MakePay
En WISECP, abre Settings > Billing > Payment Gateways, busca MakePay, habilítalo y guarda los ajustes del módulo.
Conectar MakePay
Abre los ajustes del gateway MakePay en WISECP y usa el enlace Connect MakePay mostrado en el campo de estado de conexión.
El flujo de conexión:
- Abre la página de conexión MakePay.
- Te permite elegir la empresa que recibirá los pagos.
- Te devuelve a WISECP tras la aprobación.
- Guarda la conexión del gateway para esta instalación WISECP.
Después de conectar, crea una factura pequeña de prueba y págala desde el área de cliente.
Alternativa con clave API manual
Connect MakePay es la configuración recomendada. La configuración con clave API manual está disponible para instalaciones que no pueden completar la conexión guiada.
Para configuración manual, establece el método de conexión en api_key e introduce:
- ID de empresa MakePay
- ID de clave API
- Secreto de clave API
- Secreto de firma de webhook
Mantén la URL de callback generada por WISECP accesible desde internet público.
Flujo de checkout
Cuando un cliente elige MakePay para una factura WISECP, el gateway:
- Lee el checkout ID, importe de factura y moneda desde WISECP.
- Crea un enlace de pago MakePay alojado.
- Muestra un botón Pay with MakePay.
- Envía el cliente al checkout alojado.
- Recibe un callback firmado cuando cambia el estado de pago.
El enlace de pago incluye metadata como:
| Campo | Propósito |
|---|---|
source=wisecp | Identifica la integración |
checkoutId | Mapea actividad MakePay de vuelta al checkout WISECP |
orderId | Usa el checkout ID de WISECP para lookup de callback |
Estados de factura
| Estado MakePay | Comportamiento de WISECP |
|---|---|
paid, completed, confirmed, succeeded | Marca el checkout como exitoso |
pending, waiting, confirming | Mantiene el checkout pendiente |
failed, expired, cancelled | Marca el checkout como error |
WISECP sigue siendo responsable de activación de servicios, renovaciones, numeración de facturas y notificaciones de clientes después de que la factura se pague.
Notas de seguridad
Usa HTTPS, limita el acceso administrador de WISECP y desconecta el gateway desde el dashboard MakePay si una cuenta administradora o backup del servidor queda expuesto. Vuelve a conectar después de cambiar el dominio WISECP para que callback y URLs de retorno coincidan con la instalación en vivo.
Solución de problemas
Si Connect MakePay no puede iniciar, confirma que el gateway esté instalado en coremio/modules/Payment/MakePay y que la URL de callback de WISECP sea pública.
Si las facturas no se actualizan, comprueba que el secreto de firma de webhook esté presente y que tu servidor pueda recibir callbacks HTTPS desde MakePay.
Si los clientes ven un error de checkout, confirma que MakePay esté conectado y que la moneda de factura seleccionada sea compatible con tu configuración MakePay.