⚠️ Cette page n'a pas encore été traduite en français. Version en espagnol ci-dessous.

Configurá cobros con MercadoPago

Esta guía explica cómo conectar tu cuenta de MercadoPago con EzGYM para que tus clientes puedan pagar sus facturas con tarjeta de crédito o débito.

Qué permite esta integración

Una vez configurado MercadoPago, cada factura que crees tendrá automáticamente un link de pago. Cuando tu cliente hace clic en ese link:

  1. Ve el monto a pagar y puede elegir cuotas
  2. Paga con tarjeta de crédito, débito o saldo de MercadoPago
  3. El pago se registra automáticamente en EzGYM
  4. El cliente recibe confirmación por email y/o WhatsApp (si lo tenés configurado)

No tenés que hacer nada manual. El dinero llega a tu cuenta de MercadoPago y la factura queda marcada como pagada.

Crear una cuenta en MercadoPago

Si todavía no tenés una cuenta de MercadoPago:

  1. Entrá a MercadoPago de tu país: Uruguay o Argentina
  2. Hacé clic en Crear cuenta
  3. Completá tus datos personales o de empresa
  4. Verificá tu identidad siguiendo los pasos indicados

Importante: Necesitás una cuenta verificada para recibir pagos. El proceso de verificación puede tardar algunos días.

Obtener las credenciales de producción

Las credenciales son las claves que permiten que EzGYM se conecte con tu cuenta de MercadoPago.

Paso 1: Acceder al panel de desarrolladores

  1. Entrá al panel de desarrolladores de Mercado Pago (Uruguay o Argentina) e iniciá sesión.
  2. Hacé clic en Integraciones.

Abrir Integraciones

Paso 2: Crear una aplicación

  1. En Gestión de integraciones, hacé clic en Crear aplicación.

Crear aplicación

  1. Elegí Crear en el panel de integración. No elijas Crear con IA.

Crear en el panel de integración

  1. En Elegí una solución para integrar, seleccioná Checkout API.

Seleccionar Checkout API

  1. En Tipo de API, seleccioná API de Orders. Dejá el nombre que Mercado Pago propone, aceptá la autorización de datos y hacé clic en Crear aplicación.

Configurar API de Orders y crear

Paso 3: Obtener las credenciales de producción

  1. Dentro de la aplicación que acabás de crear, abrí Credenciales de producción.

Abrir credenciales de producción

  1. Si Mercado Pago te pide datos adicionales, elegí la industria que corresponda al comercio. En Sitio web (obligatorio) colocá https://www.ezgym.net/. No copies la URL que aparece en la captura como si fuera tuya.

Industria y sitio web

  1. Una vez dentro, vas a encontrar las dos claves que necesitás:
    • Public Key: empieza con APP_USR-
    • Access Token: empieza con APP_USR-

Copiar Public Key y Access Token

Importante: El Access Token es secreto. No lo compartas con nadie.

Paso 4: Copiar las credenciales

Copiá y guardá estas dos claves. Las vas a necesitar en el siguiente paso.

Configurar MercadoPago en EzGYM

  1. Abrí la configuración de EzGYM
  2. Entrá a la sección Mercado Pago
  3. Completá los siguientes campos:

Pestaña Mercado Pago de la configuración

Campo Descripción Ejemplo
Habilitar Pagos con Mercado Pago Activá esta opción ✓
Mercado Pago Public Key Tu Public Key APP_USR-xxxxxxxx
Mercado Pago Access Token Tu Access Token APP_USR-xxxxxxxx
Cantidad de cuotas por defecto Cuotas preseleccionadas 1
Cantidad máxima de cuotas Máximo de cuotas que puede elegir el cliente 12
Mercado Pago Webhook Secret Key Clave secreta para validar las notificaciones La que entrega Mercado Pago
  1. Hacé clic en Guardar cambios

Configurar el webhook

El webhook permite que MercadoPago le avise a EzGYM cuando un pago se completa. Esto es lo que hace que los pagos se registren automáticamente. Si no realizás este paso, deberás marcar los pagos realizados por MercadoPago manualmente.

Paso 1: Obtener la URL del webhook

La URL depende de tu cuenta:

https://www.ezgym.net/api/payment/mercadopago/webhook?domain=TU-CUENTA.ezgym.net

Reemplazá TU-CUENTA por el subdominio real de tu aplicación. Por ejemplo, si entrás a https://tutoriales.ezgym.net, la URL queda:

https://www.ezgym.net/api/payment/mercadopago/webhook?domain=tutoriales.ezgym.net

No uses /webhook solo ni pongas como cuenta el dominio público www.ezgym.net.

Paso 2: Configurar en MercadoPago

  1. En el panel de desarrolladores, andá a tu aplicación y entrá a Webhooks en el menú lateral.

Abrir Webhooks y configurar notificaciones

  1. Hacé clic en Configurar notificaciones y seleccioná la pestaña Modo productivo.

URL del webhook y clave secreta

  1. Completá los campos:
    • URL de producción: pegá la URL del webhook obtenida en el paso anterior
    • Eventos: seleccioná Order (Mercado Pago). Si vas a cobrar planes con suscripción automática de Mercado Pago, marcá también Planes y suscripciones: sin ese evento los cobros de las suscripciones no se registran solos.
  2. Hacé clic en Guardar

Paso 3: Copiar la clave secreta

Justo encima del botón guardar vas a ver una clave secreta. Copiala y pegala en la configuración de EzGYM, sección Mercado Pago, campo Webhook Secret Key. Esto agrega una capa de seguridad adicional.

Probar la integración

Para verificar que todo funciona:

  1. Creá una factura de prueba para un cliente
  2. En el listado de facturas, hacé clic en el ícono de link de pago para copiarlo
  3. Abrí el link en el navegador

  4. Deberías ver la pantalla de pago de MercadoPago con el monto asociado a la factura.

Configurar comisión al cliente (opcional)

MercadoPago cobra una comisión por cada transacción. Si querés trasladarle esa comisión al cliente en lugar de absorberla vos:

  1. En la configuración de MercadoPago, buscá Porcentaje de comisión a cobrar al usuario
  2. Ingresá el porcentaje (ej: 5 para 5%)
  3. Guardá los cambios

Cuando el cliente pague, verá el monto original más la comisión. En EzGYM solo se registrará el monto de la factura original.

Ejemplo:

Concepto Monto
Factura original $1.000
Comisión (5%) $50
El cliente paga $1.050
Se registra en EzGYM $1.000

Costos

MercadoPago cobra una comisión por cada transacción. Los porcentajes varían según el método de pago y las cuotas. Consultá los costos de MercadoPago en Uruguay o Argentina.

Solución de problemas

Problema Solución
No aparece el link de pago Verificá que MercadoPago esté habilitado en la configuración
El pago no se registra automáticamente Verificá que el webhook esté configurado correctamente
Error de credenciales Revisá que estés usando las credenciales de producción, no las de prueba
El cliente no puede pagar Verificá que tu cuenta de MercadoPago esté verificada