Pasarela de pago de Mercado Pago Terminal
La pasarela de Mercado Pago Terminal permite aceptar pagos presenciales en terminales Mercado Pago Point Smart desde WCPOS. El pago se inicia en WooCommerce y se completa en el terminal; la confirmación de Mercado Pago se registra en el pedido.
Mercado Pago Terminal for WooCommerce es una extensión nueva y la versión 0.1.0 es su primer lanzamiento. Considérela una versión beta: empiece en modo Test con el terminal virtual de pruebas de Mercado Pago y realice un pago de prueba antes de aceptar pagos reales.
Características
Hardware Point Smart
Acepte pagos presenciales en terminales Mercado Pago Point Smart 1 y 2
Lista de terminales en tiempo real
Los terminales se obtienen en tiempo real de su cuenta; en los ajustes puede usar la acción Switch to PDV con un solo clic
Finalización fiable
La consulta cada 2 segundos, el webhook de Mercado Pago y una comprobación en segundo plano a los 5 minutos confirman los pagos, aunque se haya cerrado el navegador
Reembolsos desde WooCommerce
Envíe reembolsos totales o parciales desde la pantalla del pedido de WooCommerce
Diagnóstico integrado
Compruebe la conexión y el estado del webhook en los ajustes y descargue un paquete de asistencia para solucionar problemas
Cómo funciona
La pasarela utiliza la Orders API for Point en la nube de Mercado Pago. Al iniciar un pago, se crea un pedido de Mercado Pago por el importe total del pedido de WooCommerce y se envía al terminal seleccionado. El pedido de Mercado Pago caduca al cabo de 5 minutos.
La página de pago consulta Mercado Pago cada 2 segundos. El webhook y una comprobación en segundo plano a los 5 minutos también pueden completar un pedido pagado, aunque se haya cerrado el navegador. El webhook es opcional, pero se recomienda; sin Webhook secret, se siguen procesando las notificaciones, pero no se verifican sus firmas.
El terminal debe estar en modo PDV (integrado). Los terminales se entregan en modo STANDALONE, así que cambie a PDV en los ajustes de la pasarela y reinicie el terminal antes de aceptar pagos.
Configuración
Instalar Mercado Pago Terminal for WooCommerce
Descargue el archivo zip del plugin (no el archivo zip del código fuente de GitHub) desde la página de versiones de GitHub. Súbalo mediante Plugins > Añadir nuevo > Subir plugin y actívelo con WooCommerce instalado y activo.
Añadir sus credenciales de Mercado Pago
- Vaya a
WP Admin > WooCommerce > Ajustes > Pagosy abra Mercado Pago Terminal - Seleccione Mode:
Testutiliza el terminal virtual de pruebas;Liveutiliza terminales reales - Pegue el Access token (
APP_USR-…) de su aplicación, en Mercado Pago → Your integrations → Credentials
Un token TEST- en modo Live envía los pagos al entorno de pruebas. La pantalla de ajustes advierte de esta combinación; pegue su token de producción antes de aceptar pagos reales.
Registrar el webhook
- En Mercado Pago, vaya a Your integrations → su aplicación → Webhooks
- Añada la URL del webhook que aparece en la pantalla de ajustes de la pasarela
- Seleccione el evento Order (Mercado Pago) y guarde
- Copie la secret signature en Webhook secret en WooCommerce
El webhook es opcional. Los pagos se completan mediante consultas aunque no esté configurado, pero al configurar el secreto el plugin puede verificar las firmas de los webhooks.
Configurar los terminales
- Guarde y vuelva a cargar la pantalla de ajustes. Los terminales de su cuenta aparecen en la lista desplegable Default terminal y en la tabla Terminals
- Para un terminal que aparezca en modo STANDALONE, haga clic en Switch to PDV y, a continuación, reinicie el terminal
- Elija un Default terminal
- (Opcional) Limite Enabled terminals a los dispositivos que pueden elegir los cajeros. Déjelo vacío para permitir todos los terminales; el terminal predeterminado guardado sigue disponible aunque no se seleccione aquí
- (Opcional) Active Lock terminal selection para usar siempre el terminal predeterminado e impedir que los cajeros lo cambien. Esto requiere un terminal predeterminado
- Guarde los ajustes
Activar en WCPOS
- Vaya a
WP Admin > POS > Ajustes > Finalizar compra - Busque la pasarela Mercado Pago Terminal y actívela para el POS
- Guarde los ajustes
La casilla Enable/Disable de la pantalla de ajustes de WooCommerce solo controla el pago de la tienda en línea. WCPOS usa esta pasarela una vez configurada, independientemente de si la casilla está marcada.
Referencia de ajustes
| Ajuste | Función |
|---|---|
| Enable/Disable | Activa la pasarela para el pago de la tienda en línea. La activación para el POS se controla en POS > Ajustes > Finalizar compra |
| Title | Etiqueta que se muestra en el pago; el valor predeterminado es Mercado Pago Terminal |
| Description | Descripción del pago; el valor predeterminado es Pay in person on a Mercado Pago Point terminal. |
| Mode | Test (predeterminado) utiliza el terminal virtual de pruebas; Live utiliza terminales reales con credenciales activas |
| Access token | Token de su aplicación en Mercado Pago → Your integrations → Credentials. Un token guardado no vuelve a mostrarse; déjelo en blanco para conservarlo |
| Webhook secret | Firma secreta de los ajustes del webhook de Mercado Pago, utilizada para verificar notificaciones |
| Default terminal | Terminal que se usa de forma predeterminada al pagar, obtenido en tiempo real de su cuenta. Aparece un campo de texto si no se puede obtener la lista |
| Enabled terminals | Limita los terminales que pueden elegir los cajeros. Si está vacío, se permiten todos; el terminal predeterminado siempre está disponible. Se oculta si no se puede cargar la lista |
| Lock terminal selection | Usa siempre el terminal predeterminado para que los cajeros no puedan cambiarlo. Requiere un terminal predeterminado |
| Checkout debug logs | Muestra Show logs, Copy y Clear en el panel de pago. Está desactivado de forma predeterminada; actívelo al recopilar registros para asistencia |
| Log level | Off, Errors only o Debug. En esta versión, el valor predeterminado es Debug; registra solicitudes y respuestas sin los secretos |
Debajo de los campos, la tabla Mercado Pago Terminal diagnostics muestra la comprobación de la API (incluidos los recuentos de terminales y PDV), el último webhook verificado, el entorno activo, si las credenciales están configuradas, el terminal predeterminado, la URL del webhook y el enlace a los registros de pagos.
Uso
Procesar pagos
- Añadir artículos: Añada productos al carrito en el POS
- Seleccionar la pasarela: Elija Mercado Pago Terminal como método de pago
- Elegir el terminal: Elija un terminal o use el predeterminado si la selección está bloqueada
- Iniciar el pago: Haga clic en Start Terminal Payment para enviar el importe total del pedido al terminal
- Pago del cliente: Siga los mensajes de estado —
Sending to terminal…→Waiting for terminal…→Customer is paying on the terminal…— mientras el cliente completa el pago en el terminal - Finalización automática: Cuando Mercado Pago confirma el pago, el pedido se completa y el POS muestra el recibo
Controles de pago
- Start Terminal Payment: Envía una nueva solicitud de pago al terminal seleccionado
- Cancel Terminal Payment: Cancela solo antes de que el terminal reciba el pago. Después, cancélelo en el terminal o espere a que transcurran 5 minutos
- Volver a cargar la página: Reanuda un pago que ya está en curso
Recibos
El terminal no imprime ningún recibo. Use el recibo del POS cuando se complete el pago.
Reembolsos
Abra la pantalla de reembolsos del pedido de WooCommerce y elija Refund via Mercado Pago Terminal para enviar un reembolso total o parcial. Mercado Pago permite reembolsos hasta 90 días después del pago.
Algunos adquirentes de tarjetas solo permiten reembolsos en el terminal. En ese caso, haga el reembolso en el terminal y registre un reembolso manual en WooCommerce.
Registros y paquete de asistencia
Busque los registros en WooCommerce > Status > Registros, en la fuente mercadopago-terminal. En esta versión, el nivel predeterminado es Debug. Se registran las solicitudes, respuestas, webhooks y cambios de estado de los pagos, con los secretos y números de tarjeta ocultos.
Haga clic en Download support bundle en la pantalla de ajustes de la pasarela para descargar un archivo .txt y adjuntarlo a su solicitud de asistencia. Incluye detalles del entorno, ajustes con las credenciales ocultas, la lista de terminales y modos de funcionamiento, los intentos de pago de los 10 pedidos más recientes y las últimas 500 líneas del registro; no contiene nada que permita realizar pagos.
Active Checkout debug logs para añadir Show logs, Copy y Clear al panel de pago. La actividad de pago se registra en los registros de WooCommerce independientemente de este ajuste.
Requisitos
Alcance y limitaciones
- En el terminal se cobra el importe total del pedido. No se admite pagar solo una parte del pedido en el terminal
- No se admiten propinas
- Los importes se envían con dos decimales. Las tiendas que vendan en pesos chilenos o colombianos deben confirmar el funcionamiento con un pago de prueba
- No se admite el pago con bloques de la tienda en línea
- El plugin aún no declara compatibilidad con HPOS
Solución de problemas
Problemas frecuentes
Mercado Pago rechazó el token de acceso (HTTP 401)
- El token de acceso no es válido o está obsoleto
- Copie un token nuevo desde Your integrations → Credentials y guárdelo en Access token
No aparece ningún terminal
- Si no hay terminales Point vinculados a la cuenta, inicie sesión en el terminal con esa cuenta de Mercado Pago, cambie a PDV y reinícielo
- Si Default terminal aparece como un cuadro de texto en lugar de una lista desplegable, no se pudo obtener la lista. Compruebe el token y el diagnóstico; después, vuelva a cargar la pantalla de ajustes
El terminal está en modo STANDALONE
- Los pagos integrados requieren el modo PDV
- Haga clic en Switch to PDV en la tabla Terminals de la pantalla de ajustes y, a continuación, reinicie el terminal
El pago ya está en el terminal
- El terminal ya ha recibido el pago, por lo que ya no se puede cancelar desde WooCommerce
- Cancele el pago en el terminal o espere a que caduque a los 5 minutos. La página de pago sigue comprobando su estado
El webhook nunca se ha verificado
- Compruebe la URL y el secreto del webhook en Mercado Pago si el diagnóstico muestra Last verified webhook: never
- Si falta Webhook secret, pegue la secret signature de Mercado Pago. Los pagos se siguen completando mediante consultas, pero las notificaciones sin el secreto no tienen la firma verificada
El adquirente de la tarjeta rechazó el reembolso
- Algunos adquirentes solo permiten reembolsos en el terminal; Mercado Pago también limita los reembolsos a 90 días
- Haga el reembolso en el terminal y registre un reembolso manual en WooCommerce
El pago caducó en el terminal
- Los pedidos de Mercado Pago caducan al cabo de 5 minutos
- Inicie el pago de nuevo
Obtener ayuda
- Adjunte el paquete de asistencia de la pantalla de ajustes de la pasarela a su solicitud de asistencia
- Visite el repositorio de GitHub para informar de problemas
- Póngase en contacto con el servicio de asistencia de Mercado Pago si tiene preguntas sobre la cuenta y el hardware