Gateway MakePay para ClientExec

Resumen

El gateway oficial MakePay para ClientExec agrega checkout cripto alojado a facturas de ClientExec. ClientExec crea la factura, el gateway crea un enlace de pago MakePay y los callbacks firmados marcan la factura como pagada después de que el pago se liquida.

La facturación recurrente permanece dentro de ClientExec. Cuando ClientExec crea cada factura de renovación, el mismo flujo del gateway MakePay permite al cliente pagar esa factura.

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

Antes de empezar

• ClientExec 6.8 o superior, incluido ClientExec 7.x
• PHP 7.4 o superior con OpenSSL y cURL habilitados
• URL HTTPS de ClientExec
• Acceso administrador de ClientExec a Payment Processors
• Una empresa MakePay donde puedas gestionar ajustes de pago

Instalar el gateway

Descarga el paquete ZIP más reciente:

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

Extrae el ZIP y sube la carpeta makepay a:

ClientExec/plugins/gateways/makepay

El paquete instala estos archivos:

plugins/gateways/makepay/PluginMakepay.php
plugins/gateways/makepay/PluginMakepayCallback.php
plugins/gateways/makepay/callback.php
plugins/gateways/makepay/oauth.php
plugins/gateways/makepay/lib/*.php

En ClientExec, abre Settings > Plugins > Payment Processors, selecciona MakePay y guarda los ajustes del procesador de pago.

Conectar MakePay

Abre los ajustes del procesador MakePay y copia la Connect MakePay URL en tu navegador. El gateway:

1. Abre la página de conexión MakePay.
2. Te pide iniciar sesión y elegir la empresa que recibirá los pagos.
3. Muestra los permisos que necesita el gateway ClientExec.
4. Te devuelve a ClientExec tras aprobar.
5. Guarda la conexión en la instalación ClientExec.
6. Configura la URL de callback MakePay y el secreto de webhook.

Configurar MakePay

Después de conectar, conserva Auth Method en oauth. Revisa:

• ID de empresa MakePay
• Activo de liquidación
• Expiración de pago
• Secreto de firma de webhook
• Nombre de signup mostrado a clientes

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 cliente paga una factura ClientExec impaga con MakePay, el gateway crea un enlace de pago alojado y redirige al cliente al checkout MakePay.

Campo	Propósito
source=clientexec	Identifica la integración
orderId=clientexec_invoice_<invoiceId>	Mapea actividad MakePay de vuelta a ClientExec
invoiceId	Número de factura ClientExec
clientId	ID de cliente ClientExec cuando está disponible
moduleVersion	Versión instalada del gateway MakePay
clientexecVersion	Versión runtime de ClientExec cuando está disponible

El comprador vuelve a la factura original de ClientExec después del pago o cancelación.

Facturas recurrentes

ClientExec sigue siendo responsable de productos recurrentes, fechas de renovación, impuestos, generación de facturas y emails de clientes. MakePay no crea un calendario separado de suscripción en v1.

Para cada factura recurrente que ClientExec crea, el gateway MakePay se comporta igual que con una factura única: crea un enlace de checkout alojado y espera el callback firmado antes de marcar la factura como pagada.

Estados de factura

MakePay envía callbacks firmados a:

https://billing.example.com/plugins/gateways/makepay/callback.php

Estado MakePay	Comportamiento de ClientExec
paid, completed, confirmed, succeeded	Llama la aceptación de pago de ClientExec y registra el ID de transacción
failed, expired	Registra el callback y deja la factura impaga
cancelled, canceled	Registra el callback y deja la factura impaga
refunded	Registra el callback para revisión manual
Otros estados	Se registran y se ignoran

Notas de seguridad

El gateway guarda detalles de conexión en la instalación ClientExec. Limita el acceso administrador a operadores confiables y desconecta el gateway desde el dashboard MakePay si se expone una cuenta administradora o backup del servidor.

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 de ClientExec sea HTTPS pública y que la carpeta makepay esté subida en plugins/gateways. Si los clientes ven un error de checkout, confirma que MakePay esté conectado y que la factura esté impaga. Si los callbacks no marcan facturas como pagadas, compara la URL de callback MakePay con la URL anterior y rota el secreto de webhook desde los ajustes del gateway.