Plugins de e-commerce
Gateway de Blesta
Instala y configura el gateway oficial de Blesta para checkout alojado MakePay en facturas de clientes.
Gateway MakePay para Blesta
El gateway oficial MakePay para Blesta permite que clientes paguen facturas de Blesta mediante checkout cripto alojado. Blesta crea y controla la factura. MakePay crea el enlace de checkout y envía actualizaciones de pago de vuelta a Blesta.
La facturación recurrente permanece dentro de Blesta. Cuando Blesta crea una factura de renovación, el gateway la gestiona como cualquier otro pago de factura.
Antes de empezar
Necesitas:
- Blesta 5.x o superior
- Instalación Blesta HTTPS
- Acceso de administrador a gateways de pago de Blesta
- Liquidación y marca MakePay configuradas
Instalar el gateway
Descarga el paquete más reciente:
https://plugins.makecrypto.io/downloads/blesta/latest.zip
Extrae el ZIP y sube la carpeta makepay a:
Blesta/components/gateways/nonmerchant/makepay
En Blesta, abre Settings > Payment Gateways, elige Available, busca MakePay e instálalo como gateway non-merchant.
Conectar MakePay
Abre los ajustes del gateway MakePay en Blesta y haz clic en Connect MakePay.
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 Blesta tras la aprobación.
- Guarda la conexión del gateway para esta instalación Blesta.
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 tiendas que no pueden completar la conexión guiada.
Para configuración manual, establece el método de conexión en Manual 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 mostrada en Blesta accesible desde internet público.
Flujo de checkout
Cuando un cliente elige MakePay para una factura Blesta, el gateway:
- Lee el importe, moneda, ID de cliente y metadata de factura.
- 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=blesta | Identifica la integración |
orderId=blesta_invoice_<invoiceId> | Mapea actividad MakePay de vuelta a Blesta |
invoiceId | ID principal de factura Blesta |
clientId | ID de cliente Blesta cuando está disponible |
Estados de factura
| Estado MakePay | Comportamiento de Blesta |
|---|---|
paid, completed, confirmed, succeeded | Registra una transacción aprobada |
pending, waiting, confirming | Mantiene el pago pendiente |
failed, expired, cancelled | Registra un pago rechazado |
Blesta sigue siendo responsable de la activación de servicios y la automatización de facturación recurrente después de que la factura se pague.
Notas de seguridad
Usa HTTPS, limita el acceso administrador de Blesta 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 de Blesta 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 la URL de callback de Blesta sea pública y que el gateway esté instalado como non-merchant.
Si las facturas no se actualizan, comprueba que la URL de callback mostrada en ajustes sea accesible y que el secreto de firma de webhook esté presente.
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.