Proveedor de pago MakePay para XenForo

Resumen

El add-on oficial MakePay para XenForo agrega checkout cripto alojado a perfiles de pago de XenForo. XenForo crea la solicitud de compra, MakePay crea el enlace de pago alojado y el manejador de callback de pago de XenForo completa la compra después de un webhook MakePay firmado.

Usa Connect MakePay para configuración normal. Las credenciales manuales con clave API siguen disponibles como fallback.

Antes de empezar

• XenForo 2.3 o superior
• PHP 8.1 o superior con OpenSSL habilitado
• URL HTTPS del foro/comunidad
• Acceso administrador a perfiles de pago
• Una empresa MakePay donde puedas gestionar ajustes de pago

Instalar el add-on

Descarga el paquete ZIP más reciente:

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

Instálalo mediante el instalador de archivos de add-on de XenForo o sube el contenido del directorio upload/ a la raíz de XenForo. El ID del add-on es MakePay/Payment y el código fuente se instala en:

src/addons/MakePay/Payment

Conectar MakePay

Ve a Options > Service providers > Payment profiles > Add payment profile y elige MakePay. Guarda el perfil una vez, vuelve a abrirlo y luego elige Connect MakePay. El add-on:

1. Abre MakeCrypto en una pestaña del navegador.
2. Te pide iniciar sesión y elegir la empresa que recibirá los pagos.
3. Muestra los permisos que necesita el proveedor de pago XenForo.
4. Te devuelve a XenForo tras aprobar.
5. Guarda la conexión en las opciones del perfil de pago.
6. Configura la URL de callback MakePay y el secreto de webhook.

Configurar MakePay

Después de conectar, conserva Connection Method en el modo conectado predeterminado. Revisa:

• ID de empresa MakePay
• Moneda de liquidación
• Expiración del enlace de pago
• URL de callback de webhook
• 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

Agrega el perfil de pago MakePay a un upgrade de usuario XenForo, recurso pagado u otro flujo comprable que soporte perfiles de pago. Cuando un miembro elige MakePay, el add-on crea un enlace de pago MakePay con metadata de XenForo.

Campo	Propósito
source=xenforo	Identifica la integración
orderId=xenforo_purchase_<requestKey>	Mapea actividad MakePay de vuelta a XenForo
requestKey	Clave de solicitud de compra XenForo
purchasableTypeId	Tipo comprable de XenForo
moduleVersion	Versión instalada del add-on MakePay
xenforoVersion	Versión runtime de XenForo

El comprador es redirigido al checkout alojado MakePay y vuelve a XenForo después del pago o cancelación.

Estados de pago

MakePay envía callbacks firmados a:

https://your-forum.example/payment_callback.php?_xfProvider=makepay

Estado MakePay	Resultado de callback XenForo
paid, completed, confirmed, succeeded	Pago recibido
failed, expired	Pago revertido
cancelled, canceled	Pago revertido
refunded	Pago revertido
Otros estados	Pendiente

XenForo registra el log del proveedor de pago con el UID de pago MakePay, clave de solicitud de compra, URL de pago cuando esté disponible y payload de callback.

Notas de seguridad

El add-on guarda detalles de conexión en las opciones del perfil de pago. Limita el acceso administrador de XenForo a operadores confiables y desconecta la comunidad en MakeCrypto si una cuenta administradora o backup del servidor queda expuesto.

La conexión solicita estos permisos:

• company:read
• makepay:payment-links:read
• makepay:payment-links:write
• makepay:customers:read
• makepay:customers:write
• makepay:settings:read
• makepay:settings:write

Solución de problemas

Si Connect MakePay no puede iniciar, confirma que la URL del foro XenForo sea HTTPS y accesible públicamente. Si falta el botón Connect MakePay, guarda el perfil de pago una vez y vuelve a abrirlo. Si las compras no se completan, compara la URL de callback de webhook MakePay con la URL payment_callback.php?_xfProvider=makepay de XenForo y rota el secreto de webhook.