Conectar una pasarela de pago

en contestar tu solicitud de 3D Secure)

Una pasarela de pago es el servicio que cobra con tarjeta en tu sitio web y renueva las membresías cada mes. Puedes conectar Openpay o Mercado Pago, y cada sede tiene las suyas. Si ves otra opción en la pantalla, todavía no está disponible.

Sigue los pasos con cuidado: si dejas la pasarela en modo de prueba, tus socios "pagan" pero no se mueve dinero real; y si falta el webhook, la pasarela no cobra en línea.

Antes de empezar

• Tu empresa debe estar Verificada en Configuración → Cuenta → Datos fiscales y verificación. Mientras no la aprueben, el sistema no te deja entrar a conectar pasarelas.
• Necesitas el rol de dueño o de administrador.
• El sitio web de la sede debe estar publicado. Sin sitio publicado no hay dirección del webhook y la pasarela no puede quedar lista.
• Una cuenta activa con la pasarela, con sus llaves de producción a la mano.
• Si vas a usar Openpay: pídele a Openpay por escrito que desactive el 3D Secure obligatorio para cobros automáticos. Si sigue activo, las renovaciones con tarjeta guardada no pasan. El sistema no te deja guardar Openpay sin confirmar que ya lo pediste.
• Cámbiate a la sede que vas a configurar: las llaves se guardan solo para la sede activa. Si tienes varias sedes, repite estos pasos en cada una o no se podrá cobrar en las demás.

Abrir la pantalla de la pasarela

1. En el menú, entra a Configuración → Pagos → Métodos y operadores.
2. En Configurar para, revisa que aparezca la sede que quieres configurar.
3. Presiona la tarjeta de la pasarela (Configurar sede → si es nueva o Administrar → si ya la tenías). Se abre una ventana con:
   • arriba, el estado y la lista Cobro en línea y webhook (aparece hasta que guardas tus llaves);
   • el Tutorial paso a paso, con imágenes de cada paso en el panel de la pasarela;
   • abajo, Conectar cuenta (o Reemplazar credenciales), donde eliges el Modo y pegas tus llaves.

Ojo: en esa ventana hay dos botones Actualizar. El que está debajo de la lista Cobro en línea y webhook solo recarga el estado. El de hasta abajo, junto a Cerrar, guarda las credenciales cuando la pasarela ya existe.

Pasos con Openpay

1. En el panel de Openpay de producción (dashboard.openpay.mx), abre el menú ☰ de arriba a la derecha y entra a Llaves API. Copia el Merchant ID, la llave secreta (empieza con sk_) y la pública (empieza con pk_).
2. En MomentumOS, abre la tarjeta de Openpay.
3. En Modo, elige Producción / Live. Si dejas Sandbox / Test, los cobros son de prueba y no se mueve dinero real.
4. Pega Merchant ID, Public Key y Private Key.
5. Inventa un usuario y una contraseña para el webhook (solo letras y números) y escríbelos en Usuario del webhook y Contraseña del webhook. Anótalos: los vas a escribir igual en Openpay.
6. Marca Ya pedí a Openpay desactivar el 3D Secure obligatorio para cobros automáticos.
7. Presiona Guardar y conectar.
8. Presiona Probar conexión. Si todo está bien, la etiqueta de arriba dice Conectado · Live.
9. En la lista Cobro en línea y webhook, copia la Dirección del webhook con Copiar.
10. En Openpay, abre el menú ☰ y entra a Configuraciones. En Webhooks presiona + Agregar:
    • pega la dirección del webhook;
    • deja Todos los eventos;
    • activa Usar autenticación de acceso básica y escribe el mismo usuario y contraseña del paso 5;
    • guarda.
11. Openpay manda un código que aparece en MomentumOS. Presiona el Actualizar de debajo de la lista y copia el Código de verificación de Openpay.
12. En Openpay, en la fila de tu webhook, presiona Verificar, pega ese código y confirma. Ese aviso cuenta como el primer aviso autenticado.
13. En MomentumOS, presiona otra vez el Actualizar de debajo de la lista. Debe decir Último aviso autenticado con la fecha y, arriba, Lista para cobrar en línea.

En Openpay un webhook no se edita: si cambias la dirección, el usuario o la contraseña, bórralo en Openpay, créalo de nuevo y vuelve a verificarlo.

Pasos con Mercado Pago

1. En Mercado Pago Developers, entra a Integraciones (arriba a la derecha), abre tu aplicación y, en el menú de la izquierda, entra a Credenciales de producción. Copia la Public Key y el Access Token.
2. En MomentumOS, abre la tarjeta de Mercado Pago.
3. En Modo, elige Producción / Live. Si dejas Sandbox / Test, los cobros son de prueba y no se mueve dinero real.
4. Pega Access Token y Public Key. Deja vacía por ahora la Clave secreta de Webhooks: te la da Mercado Pago más adelante.
5. Presiona Guardar y conectar.
6. Presiona Probar conexión. El mensaje te dice si las credenciales son válidas y si las suscripciones de Mercado Pago están disponibles en tu cuenta (con ellas se cobran las renovaciones mensuales).
7. En la lista Cobro en línea y webhook, copia la Dirección del webhook con Copiar.
8. En Mercado Pago, en el menú de la izquierda, entra a Webhooks y presiona Configurar notificaciones. En la pestaña Modo productivo:
   • pega la dirección del webhook;
   • marca Pagos (legacy), Planes y suscripciones y Contracargos;
   • presiona Guardar configuración.
9. En esa misma página, en Clave secreta, presiona el ojo para verla y cópiala. Esta clave la genera Mercado Pago; tú no la inventas.
10. En MomentumOS, en Reemplazar credenciales, revisa que siga elegido Producción / Live, vuelve a pegar Access Token y Public Key, pega la clave en Clave secreta de Webhooks (requerida para cobrar en línea) y presiona el Actualizar de hasta abajo para guardar.
11. Presiona otra vez Probar conexión: cada vez que guardas, la prueba se tiene que repetir.
12. En Mercado Pago, presiona Simular notificación.
13. En MomentumOS, presiona el Actualizar de debajo de la lista. Debe decir Último aviso autenticado con la fecha y, arriba, Lista para cobrar en línea.

La lista de la pasarela

La lista Cobro en línea y webhook muestra lo que le falta a la pasarela. Los puntos marcados con ✗ impiden cobrar en línea; los grises (•) son informativos.

Para que la pasarela aparezca en tus contratos, necesita llaves de producción, modo Producción / Live y la Prueba de conexión aprobada. Si falta algo, la ventana te dice Todavía no aparece en tus contratos.

Mientras diga Aún no puede cobrar en línea:

• Los planes con precio o inscripción desaparecen de tu sitio web en esa sede, sin aviso al socio.
• En recepción se sigue cobrando normal.
• Las renovaciones con tarjeta se pausan sin culpar al socio.

El Último aviso autenticado se borra, y tienes que volver a comprobar el webhook (en Openpay, verificarlo; en Mercado Pago, Simular notificación), cuando:

• cambias las llaves por las de otra cuenta de la pasarela;
• cambias de Sandbox / Test a Producción / Live o al revés;
• cambias el usuario o la contraseña del webhook (Openpay) o la clave secreta (Mercado Pago).

Qué esperar de cada pasarela

Qué pasa después

• Cuando la lista dice Lista para cobrar en línea y el modo es Producción / Live, los socios ya pueden pagar en línea en esa sede.
• Cada socio puede guardar hasta 3 tarjetas por cuenta de pasarela.
• El dinero llega a tu cuenta de la pasarela. Los depósitos de Openpay se ven en Pagos y finanzas → Payouts pendientes; los de Mercado Pago, en tu panel de Mercado Pago.
• Tus llaves se guardan cifradas. En Configuración guardada solo se ven enmascaradas: nadie del equipo puede volver a verlas completas.

Problemas frecuentes

"No me deja entrar a conectar la pasarela." Tu empresa todavía no está Verificada. El sistema te lleva a Datos fiscales y verificación para que subas tus documentos y esperes la aprobación.

"Dice Todavía no tenemos la dirección de esta sede." El sitio de la sede no está publicado. Publícalo y presiona el Actualizar de debajo de la lista. Si ya estaba publicado, avísale a soporte.

"No me deja guardar Openpay." Falta marcar Ya pedí a Openpay desactivar el 3D Secure obligatorio para cobros automáticos. Pídeselo a Openpay por escrito antes de marcarlo.

"Quise cambiar algo y me pide otra vez las llaves." Cada vez que guardas tienes que volver a pegar las llaves (y, en Openpay, volver a marcar la casilla del 3D Secure). El usuario y la contraseña del webhook de Openpay, y la clave secreta de Mercado Pago, se conservan si los dejas vacíos y la cuenta es la misma. Después de guardar, vuelve a presionar Probar conexión.

"La pasarela dice Lista para cobrar en línea, pero no me llega dinero." Revisa el Modo. Si dice Sandbox en la etiqueta de arriba, estás en pruebas: cambia a Producción / Live con tus llaves de producción, guarda, prueba la conexión y vuelve a comprobar el webhook.

"La lista dice que no ha llegado ningún aviso." Revisa que la dirección del webhook esté bien pegada en el panel de tu pasarela. En Openpay, revisa que el usuario y la contraseña sean idénticos en los dos lados y que hayas presionado Verificar con el código que aparece en MomentumOS. En Mercado Pago, revisa que la clave secreta sea la de tu aplicación y presiona Simular notificación otra vez.

"Openpay aparece con la etiqueta Pide 3D Secure." Openpay detuvo cobros automáticos porque sigue pidiendo 3D Secure. Pídele que lo desactive y, cuando lo hayas pedido, presiona Ya lo pedí a Openpay en la ventana de la pasarela.

"No me deja cambiar las llaves: dice que hay cobros en curso." Espera a que terminen esos cobros o contacta a soporte de MomentumOS para cerrarlos antes de cambiar las llaves.

"Los pagos se aprueban pero la membresía tarda en activarse." La pasarela avisa al sistema cuando el pago se confirma. Si ese aviso se pierde, el sistema lo revisa solo en unos minutos.

"No veo las llaves de otra sede." Solo se ven y se editan las de la sede activa. Cámbiate de sede.

"¿Puedo devolver un pago de Mercado Pago desde MomentumOS?" Sí, igual que con Openpay. Algunos cobros hechos en la terminal Mercado Pago Point no se pueden devolver así: el sistema te avisa y no marca nada como devuelto; en ese caso, devuélvelo desde tu panel de Mercado Pago.

"Devolví un pago desde el panel de la pasarela y la membresía sigue activa." Es lo esperado: devolver dinero no cancela la membresía. La ficha del socio la marca para revisión y recepción decide si la cancela o la mantiene.

Artículos relacionados

• Dar de alta tu gimnasio
• Crear un plan de membresía
• Revisar tus finanzas