Plugins de e-commerce
Gateway de Invision Community
Instala y configura el gateway oficial de Invision Community 5 Commerce con OAuth nativo, checkout alojado MakePay y webhooks firmados.
Gateway MakePay para Invision Community
Resumen
La aplicación oficial MakePay para Invision Community agrega checkout cripto alojado a Invision Community 5 Commerce. Commerce crea la factura y la transacción, MakePay crea el enlace de pago alojado y los webhooks firmados actualizan la transacción después de eventos de pago.
Usa Connect MakePay para configuración normal. Las credenciales manuales con clave API siguen disponibles como fallback.
Antes de empezar
- Invision Community 5.0 o superior
- Aplicación Commerce instalada
- PHP 8.1 o superior
- URL HTTPS de la comunidad
- Una empresa MakePay donde puedas gestionar ajustes de pago
Instalar la aplicación
Descarga el paquete TAR más reciente:
https://plugins.makecrypto.io/downloads/invision-community/latest.tar
Instálalo desde el gestor de aplicaciones del AdminCP de Invision.
Conectar MakePay
Abre los ajustes de pago de Commerce y agrega MakePay como método de pago. Elige Connect MakePay. La aplicación:
- Abre MakeCrypto en una pestaña del navegador.
- Te pide iniciar sesión y elegir la empresa que recibirá los pagos.
- Muestra los permisos que necesita el gateway Invision Community.
- Te devuelve a Invision tras aprobar.
- Guarda la conexión de comunidad en ajustes cifrados de Invision.
- Configura la URL de callback de webhook MakePay.
Configurar MakePay
Conserva Connection Method en el modo conectado predeterminado después de conectar. Revisa:
- Disponibilidad del método de pago
- ID de empresa MakePay
- URL de callback de webhook
- Logging de debug/solicitudes
- Credenciales de fallback con clave API manual
El fallback manual requiere ID de empresa MakePay, ID de clave API, secreto de clave API y secreto de webhook.
Flujo de checkout
Cuando un miembro elige MakePay, Invision crea una transacción Commerce y la aplicación crea un enlace de pago MakePay con metadata de factura.
| Campo | Propósito |
|---|---|
source=invision | Identifica la integración |
externalId=invision_invoice_<id> | Mapea actividad MakePay de vuelta a Commerce |
invoiceId | ID de factura Invision Commerce |
transactionId | ID de transacción Invision Commerce |
moduleVersion | Versión instalada de la aplicación MakePay |
El miembro es redirigido al checkout alojado MakePay y vuelve a la comunidad después del pago o cancelación.
Estados de Commerce
El endpoint de webhook verifica X-MakePay-Signature antes de cambiar el estado de transacción Commerce.
| Estado MakePay | Estado de transacción Invision |
|---|---|
paid, completed, confirmed, succeeded | Approved |
failed, expired | Refused |
cancelled, canceled | Refused |
refunded | Refunded |
| Otros estados | Pending |
Cada webhook escribe un mensaje privado de factura con el estado MakePay, UID de pago y URL de pago alojado cuando está disponible.
Notas de seguridad
La aplicación guarda detalles de conexión en ajustes cifrados de Invision. Limita el acceso AdminCP a operadores confiables y desconecta el gateway en MakeCrypto si una cuenta administradora o backup del servidor queda expuesto.
La conexión solicita estos permisos:
company:readmakepay:payment-links:readmakepay:payment-links:writemakepay:customers:readmakepay:customers:writemakepay:settings:readmakepay:settings:write
Solución de problemas
Si Connect MakePay no puede iniciar, confirma que la URL base de la comunidad sea HTTPS y accesible públicamente. Si las redirecciones de checkout fallan, confirma que Commerce esté instalado y que MakePay tenga una conexión guardada o credenciales manuales. Si las facturas no se actualizan, compara la URL de callback de webhook MakePay con la URL de webhook de la comunidad y rota el secreto.