01Introduccion
Esta guia te ayuda paso a paso a configurar MercadoPago en tu club para que tus clientes puedan pagar las reservas de turnos de forma online.
- Una cuenta de MercadoPago activa (la del club o la persona que recibe los pagos)
- No hace falta conocimientos tecnicos avanzados
El proceso tiene 3 etapas simples:
- Crear una aplicacion en MercadoPago (solo se hace una vez)
- Copiar las credenciales en CanchaPlay
- Configurar el webhook (para que los pagos se confirmen automaticamente)
02Crear aplicacion en MercadoPago
Acceder al Panel de Desarrolladores
- Abri tu navegador e ingresa a: https://www.mercadopago.com.ar/developers/panel
- Inicia sesion con la cuenta de MercadoPago donde queres recibir los cobros
- Si es la primera vez, MercadoPago te pide que aceptes los terminos de desarrollador. Acepta para continuar.
Crear una nueva aplicacion
- En el panel, hace clic en "Crear aplicacion" o "Tus integraciones"
- Completa los datos:
- Nombre: pone algo descriptivo, por ejemplo "CanchaPlay - [Nombre del Club]"
- Tipo de integracion: selecciona "Checkout Pro"
- Hace clic en "Crear aplicacion"
La aplicacion es como un "puente" entre CanchaPlay y tu cuenta de MercadoPago. Solo necesitas crear una por club.
03Obtener credenciales
Access Token (Credencial de Produccion)
- Dentro de tu aplicacion en MercadoPago, anda a la seccion "Credenciales de produccion"
- Copia el "Access Token". Es un texto largo que empieza con
APP_USR- - Guarda este dato en un lugar seguro
MercadoPago tiene dos tipos de credenciales: de Produccion (para cobros reales) y de Prueba/Test (para probar sin dinero real). Para tu club, usa las credenciales de PRODUCCION. Las de prueba (que empiezan con TEST-) son solo para desarrollo.
Clave Secreta del Webhook
Esta clave se obtiene en el paso de configuracion del webhook (seccion 5). Por ahora, pasemos a configurar CanchaPlay.
04Configurar en CanchaPlay
- Ingresa al backoffice de tu club
- En el menu lateral, hace clic en "Configuracion"
- Hace clic en la tab "Pagos"
- Pega el Access Token que copiaste en el paso anterior
- Presiona Enter o hace clic en Guardar
| Campo | Descripcion |
|---|---|
| Access Token | El token que copiaste (empieza con APP_USR-) |
| Webhook Secret | La clave del paso 5.2 (lo completamos despues) |
| Modalidad de Pago | Como queres cobrar (ver seccion 6) |
| Porcentaje de Reserva | Solo si elegis "Reserva Online" -- el % que se cobra por adelantado |
| Tiempo Limite | Minutos que tiene el cliente para completar el pago (ej: 15) |
05Configurar el webhook
El webhook permite que cuando un cliente paga en MercadoPago, CanchaPlay se entere automaticamente y confirme la reserva. Sin esto, los pagos no se procesarian.
Configurar la URL del Webhook
- Volve al panel de MercadoPago: https://www.mercadopago.com.ar/developers/panel
- Ingresa a tu aplicacion
- Busca la seccion "Webhooks" o "Notificaciones"
- En el campo "URL de produccion", ingresa:
https://canchaplay.ar/webhooks/mercadopago - En "Eventos", selecciona (marca con tilde): Pagos (payment)
- Hace clic en "Guardar"
Si tu club tiene un dominio personalizado, usa tu dominio en la URL del webhook. Ejemplo: https://miclub.canchaplay.ar/webhooks/mercadopago
Copiar la Clave Secreta
- Despues de guardar el webhook, MercadoPago muestra una "Clave secreta" (Secret Key)
- Copia esa clave secreta
- Volve a CanchaPlay > Configuracion > Pagos
- Pega la clave en el campo "Webhook Secret" y guarda
La Clave Secreta del Webhook NO es la misma que el Access Token. El Access Token es para crear cobros. La Clave Secreta es para verificar que las notificaciones de pago vienen de MercadoPago y no de un tercero.
06Modalidades de pago
CanchaPlay ofrece varias modalidades. Elegi la que mejor se adapte a tu club.
| Modalidad | Descripcion |
|---|---|
| Sin Pago | No se cobra online. El turno se confirma al reservar. |
| Pago en Mostrador | El cliente reserva y paga cuando llega al club. |
| Reserva Online | Se cobra un porcentaje por adelantado (ej: 30%) y el resto en el club. |
| Pago Total Online | Se cobra el 100% del turno al momento de reservar. |
Si recien empezas, "Reserva Online" con un 30-50% es buena opcion. Asegura compromiso del cliente sin cobrarle todo por adelantado.
07Verificar que funciona
- Hace una reserva de prueba desde el portal publico de tu club
- Selecciona un turno disponible y confirma la reserva
- Deberias ser redirigido a MercadoPago para pagar
- Completa el pago (podes usar tarjeta de credito)
- Despues de pagar, volve a CanchaPlay y verifica que la reserva dice "Confirmada"
- Verifica que el Access Token sea el correcto (de produccion, empieza con
APP_USR-) - Verifica que la Clave Secreta del Webhook este bien copiada
- Verifica que la URL del webhook sea correcta y que la app este online
- Si el pago se hizo pero la reserva no se confirmo, revisa el Webhook Secret
Checklist de configuracion
| Paso | Estado |
|---|---|
| 1. Crear aplicacion en MercadoPago | Pendiente |
| 2. Copiar Access Token (produccion) | Pendiente |
| 3. Pegar Access Token en CanchaPlay | Pendiente |
| 4. Elegir modalidad de pago | Pendiente |
| 5. Configurar URL del webhook en MP | Pendiente |
| 6. Copiar Clave Secreta del webhook | Pendiente |
| 7. Pegar Clave Secreta en CanchaPlay | Pendiente |
| 8. Hacer reserva de prueba | Pendiente |
08Preguntas frecuentes
Puedo usar la cuenta personal de MercadoPago?
Si, podes usar cualquier cuenta. Los pagos van directo a esa cuenta. Si tu club tiene cuenta empresa de MercadoPago, es mejor usar esa.
Cuanto cobra MercadoPago de comision?
MercadoPago cobra una comision por cada transaccion (generalmente entre 3% y 5% + IVA). Consulta las tarifas vigentes en mercadopago.com.ar.
Si cambio la contrasena de MercadoPago, tengo que actualizar algo?
No. El Access Token no cambia con tu contrasena. Solo si regeneras las credenciales desde el panel de desarrolladores necesitas actualizar el token.
Puedo desactivar los pagos online temporalmente?
Si. En CanchaPlay > Configuracion, cambia la modalidad de pago a "Sin Pago" o "Pago en Mostrador". No necesitas borrar las credenciales.
Que pasa si el cliente no paga dentro del tiempo limite?
La reserva se cancela automaticamente y el turno vuelve a quedar disponible para otros clientes.
Los reembolsos se hacen automaticamente?
No. Si necesitas hacer un reembolso, podes hacerlo desde tu cuenta de MercadoPago o desde CanchaPlay a traves de las solicitudes de reembolso.
Puedo usar modo sandbox para probar?
Si. En CanchaPlay > Configuracion > Pagos, activa el toggle "Modo sandbox". Usa credenciales de prueba (empiezan con TEST-) para probar sin dinero real. Recorda desactivarlo antes de ir a produccion.