MercadoPago es la forma de pago que más piden los clientes de hosting en México: tarjetas, efectivo en tiendas y transferencia en un solo checkout. WHMCS no trae una pasarela de MercadoPago que funcione bien con Checkout Pro, así que hay que agregarla con un módulo. En este artículo explicamos qué debe hacer ese módulo para que no termines revisando pagos a mano.
El problema: el pago se hizo, la factura sigue pendiente
Casi todos los problemas con MercadoPago en WHMCS son el mismo: el cliente pagó, MercadoPago cobró, y la factura sigue como «sin pagar». Pasa por dos razones.
La primera es confiar en el regreso del navegador. Cuando el cliente termina de pagar, MercadoPago lo manda de vuelta a tu sitio con una dirección que dice «aprobado». Si la pasarela marca la factura como pagada en ese momento, cualquiera puede escribir esa dirección a mano. Y si el cliente cierra la pestaña antes de regresar, el pago nunca se aplica.
La segunda es no verificar los avisos. MercadoPago envía a tu servidor un aviso (webhook) cada vez que un pago cambia de estado. Ese aviso viene firmado. Si tu pasarela no comprueba la firma, acepta avisos falsos; si la comprueba mal, rechaza los verdaderos y ningún pago se aplica solo.
Qué debe hacer una pasarela de MercadoPago para WHMCS
- Aplicar el pago solo con el aviso firmado. El regreso del navegador sirve para dar las gracias, nada más.
- No registrar dos veces el mismo pago cuando MercadoPago repite un aviso, que es algo normal.
- No marcar como pagada una factura con un pago incompleto.
- Anotar la comisión que cobra MercadoPago en cada pago, para que tus reportes muestren el neto.
- Avisar del error si la moneda de la factura no es compatible, en lugar de cobrar otra cosa.
Reembolsos: el punto donde más dinero se pierde
Un reembolso enviado dos veces por un doble clic es dinero que sale de tu cuenta. Una buena integración revisa lo que MercadoPago ya tiene registrado antes de enviar otro reembolso, y si algo no cuadra se detiene.
También importa el camino contrario: si haces el reembolso desde el panel de MercadoPago, WHMCS debería enterarse y anotarlo en la factura, aunque sea parcial. De lo contrario tu contabilidad y la de MercadoPago dejan de coincidir.
Conciliar: saber qué pago no llegó
Por bien que funcione todo, un día tu servidor estará caído cuando llegue un aviso. Por eso conviene tener una conciliación: una pantalla que compare los pagos aprobados en MercadoPago contra lo registrado en WHMCS y te señale los que faltan.
Qué necesitas para empezar
- Una cuenta de MercadoPago con credenciales de producción.
- La clave secreta de avisos, que se genera en el panel de MercadoPago.
- Tu WHMCS accesible por HTTPS.
Nuestro módulo de MercadoPago Checkout Pro para WHMCS hace todo lo anterior y agrega un panel con pagos, avisos, conciliación y reembolsos. Si además quieres trasladar la comisión al cliente, se combina con Cargos por pasarela de pago.