Antes de ofrecer un medio de pago en tu página, tienes que conectarlo. Se hace en la pestaña Conexiones de Configuración de Payments.
ℹ️ Esta guía es parte de WeSpeak Payments, donde está la lista de lo que tiene que estar listo antes de empezar.
En este artículo
- Qué medios de pago puedes ofrecer
- Conexiones
- Conectar una pasarela (Stripe, Mercado Pago, PayPal, PayU o Wompi)
- Qué pide cada pasarela
- Wompi: la URL de eventos
- La tarjeta en garantía
- Transferencia, link de pago y pago en el hotel
- Editar las credenciales
- Desconectar un medio de pago
- Preguntas frecuentes
Qué medios de pago puedes ofrecer
| Medio | Con qué paga el huésped | Qué necesita antes de ofrecerlo | Cobro |
|---|---|---|---|
| Stripe | Tarjeta de crédito y/o débito. | Conexión con tus claves y Cobrar con Stripe en la opción de tarjeta. | En línea, al reservar (el total o la seña). |
| Mercado Pago | Tarjeta y/o la opción Mercado Pago (paga en Mercado Pago con su cuenta). | Conexión y activar una o las dos opciones. | En línea, al reservar. |
| PayU | Tarjeta y/o la opción PayU (paga en la página de PayU). | Conexión y activar una o las dos opciones. | En línea, al reservar. |
| PayPal | La opción PayPal (paga en PayPal). No cobra la tarjeta. | Conexión y activarla. | En línea, al reservar. |
| Wompi | La opción Wompi (paga en la página de Wompi: tarjetas, PSE, Nequi…). Wompi cobra en pesos colombianos. | Conexión, URL de eventos configurada en Wompi y activarla. | En línea, al reservar. |
| Tarjeta en garantía (Guardar datos de tarjeta) | Tarjeta de crédito y/o débito: la tarjeta queda guardada, sin cobro. | Viene conectada; en Medios de pago, la tarjeta en Guardar datos de tarjeta para cobro manual. | Lo cobras tú, después, con los datos que ve un Administrador en Reservas. |
| Transferencia bancaria | Transfiere a tu cuenta con tus instrucciones. | Conexión (un clic), activarla y escribir las instrucciones. | Lo registras tú en Reservas cuando llega. |
| Link de pago | Paga en un link genérico de tu propia pasarela, cargando el monto y sus datos. | Conexión (un clic), activarla y escribir las instrucciones con el link. | Lo registras tú en Reservas cuando llega. |
| Pago en el hotel | Paga al llegar, en efectivo o con tarjeta en recepción; reserva sin pago adelantado. | Conexión (un clic), activarla y escribir las instrucciones. | Lo registras tú en Reservas al cobrar. |
- Plazo para pagar: el link no vence; con las pasarelas y la tarjeta en garantía, el huésped tiene 12 minutos para completar el pago desde que confirma (ver Lo que ve el huésped).
- Países y monedas: el panel no limita en qué países o monedas usas cada pasarela; lo que cuenta es que tu cuenta del proveedor acepte cobrar en la moneda de tus reservas (ver Monedas y conversión).
Conexiones
La pestaña Conexiones (Conocimiento → Precio y Disponibilidad → Configuración de Payments) muestra lo que ya está conectado, con su tipo (Pasarela de pago, Tarjeta manual o Método directo), su estado (Activo) y tres acciones: Ver detalles (el ojo), Editar (el lápiz, solo en las pasarelas) y Desconectar (el enchufe). En pantallas de laptop verás solo los íconos; al pasar el cursor aparece el nombre.
- Quién puede hacerlo: los usuarios Administrador y Supervisor.
- Cada propiedad conecta los suyos: si tienes varias, elige primero la propiedad en la barra Configuración por hotel (ver Configurar tu página de reservas). Lo que conectas en una propiedad no sirve para las otras.
ℹ️ Al activar WeSpeak Payments ya encontrarás Guardar datos de tarjeta conectado en cada propiedad: es la tarjeta en garantía (ver La tarjeta en garantía).
⚠️ Conectar no activa nada en tu página. Después de conectar un medio de pago, actívalo en la pestaña Medios de pago (ver Medios de pago). Hasta entonces, el huésped no lo ve.
Conectar una pasarela (Stripe, Mercado Pago, PayPal, PayU o Wompi)
Necesitas una cuenta propia en la pasarela: los cobros entran directamente a esa cuenta.
En Conexiones, haz clic en Nueva Conexión.
En Pasarelas de Pago, elige el proveedor. Lo que ya está conectado aparece atenuado, con Ya conectado: puedes tener una sola cuenta de cada proveedor por propiedad.
Se abre la ventana Conectar del proveedor, con una guía paso a paso: cómo crear o entrar a tu cuenta, dónde están las credenciales en el panel del proveedor y qué configurar allí. Debajo de la guía (en una laptop, desplazándote hacia abajo dentro de la ventana) pega las credenciales. Los campos llevan el nombre que usa el proveedor en su panel.
Haz clic en Conectar (se habilita cuando completas todos los campos). El proveedor aparece en la tabla como Activo.
En la pestaña Medios de pago, activa el medio y, para cobrar tarjetas, elige Cobrar con… (ver Medios de pago). Si usas WeSpeak Rates, revisa también las políticas de pago que tengan su propia configuración (ver Políticas de pago).
⚠️ WeSpeak no comprueba las credenciales con el proveedor. Si pegas una clave con un error o una clave de prueba, la conexión queda Activo igual y los pagos de tus huéspedes fallan. Copia las claves de producción directamente del panel del proveedor y haz una reserva de prueba antes de abrir (ver Probar antes de abrir).
Qué pide cada pasarela
| Pasarela | Credenciales | Dónde están (según la guía de la ventana) | Qué suma a tu página |
|---|---|---|---|
| Stripe | Publishable Key y Secret Key | Panel de Stripe → Developers → API Keys (Standard keys), en modo Live. | Cobrar la tarjeta: Cobrar con Stripe. |
| Mercado Pago | Access Token y Public Key | Panel de desarrolladores de Mercado Pago → Tus integraciones → tu aplicación → Producción → Credenciales de producción. | Dos opciones con la misma conexión: cobrar la tarjeta (Cobrar con Mercado Pago) y la opción Mercado Pago, en la que el huésped paga en Mercado Pago con su cuenta. El checkout le pide el tipo de documento de su país (DNI, CPF, RUT…). |
| PayPal | Client ID y Client Secret | Portal de desarrolladores de PayPal → Apps & Credentials → REST API apps (con una cuenta de negocio, en modo Live). | La opción PayPal: el huésped paga en PayPal. No sirve para cobrar la tarjeta. |
| PayU | Merchant ID, Account ID, API Login y API Key | Panel de PayU → Configuración → Configuración técnica. | Dos opciones con la misma conexión: cobrar la tarjeta (Cobrar con PayU) y la opción PayU, que lleva al huésped a la página de pago de PayU. |
| Wompi (Colombia) | Llave Pública, Llave Privada, Secreto de Integridad y Secreto de Eventos | Panel de Wompi → Desarrollo → Programadores. Además, la URL de eventos (ver abajo). | La opción Wompi: el huésped paga en la página de Wompi (tarjetas, PSE, Nequi…). No sirve para cobrar la tarjeta ni para la tarjeta en garantía. |
Si no encuentras las credenciales en tu cuenta, pídeselas a tu proveedor: la misma ventana te lo recuerda en ¿No sabes cómo obtener las credenciales?.
Wompi: la URL de eventos
Wompi avisa cada pago a una URL de eventos que se configura en su panel. El paso Configura la URL de eventos (webhook) de la guía te muestra la URL de WeSpeak con un botón Copiar: pégala en Wompi, en Desarrollo → Programadores → Seguimiento de transacciones → URL de eventos, y guarda. Si también usas el modo de pruebas de Wompi, repite el paso en ese entorno.
⚠️ Sin la URL de eventos, el huésped paga pero la reserva no se confirma en WeSpeak: el aviso de Wompi nunca llega.
Wompi admite una sola URL de eventos. Si ese campo ya tiene la URL de tu motor de reservas o de tu web, no la reemplaces: en ¿Ya tienes una URL en ese campo?, pega la URL que tienes hoy y copia la que te devuelve. Con esa única URL, WeSpeak procesa los avisos de sus reservas y los de tu otra integración le siguen llegando a ella.
La tarjeta en garantía
Guardar datos de tarjeta guarda la tarjeta del huésped como garantía sin cobrarle nada. Viene conectada desde que activas WeSpeak Payments, y en la pestaña Medios de pago la tarjeta arranca en Guardar datos de tarjeta para cobro manual.
- El huésped elige Tarjeta de crédito y/o débito, carga la tarjeta en la página segura de pago y, al terminar, se le avisa que su tarjeta quedó como garantía y que todavía no se le cobró.
- Tú haces el cobro con tu propio medio (por ejemplo, tu terminal), cuando corresponda según tu política: los datos de la tarjeta los ve un usuario Administrador desde Reservas (ver Tarjeta en garantía: ver los datos y marcarla como cobrada).
- No tiene credenciales, así que no se edita. Si la desconectas y era la forma de procesar la tarjeta, la tarjeta desaparece de tu página hasta que elijas otro proveedor. Para volver a tenerla, conéctala desde Nueva Conexión y vuelve a elegir Guardar datos de tarjeta para cobro manual en Medios de pago.
Transferencia, link de pago y pago en el hotel
Estos métodos no piden credenciales y no cobran en línea: el huésped paga por su cuenta y tú registras el cobro en Reservas (ver Registrar un cobro).
- En Nueva Conexión → Métodos Directos, elige Transferencia bancaria, Link de pago o Pago en el hotel ("No requiere credenciales"). Queda Activo al instante.
- En Medios de pago, activa Mostrar Transferencia bancaria en el checkout, Mostrar Link de Pago en el checkout o Mostrar Pago en el hotel en el checkout.
- Escribe las instrucciones en el campo que aparece debajo del interruptor (se guardan al salir del campo):
- Transferencia bancaria: los datos para transferir (titular, banco, número de cuenta o alias).
- Link de pago: un link genérico de tu propia pasarela y cómo usarlo. WeSpeak no puede armarlo con el monto ni los datos del huésped: él los carga a mano. Con Insertar variable puedes sumar el ID de la reserva en el PMS.
- Pago en el hotel: cuándo y cómo se paga (por ejemplo, en efectivo o con tarjeta al hacer el check-in).
El huésped ve esas instrucciones en la página de confirmación de su reserva.
⚠️ El panel te avisa si el campo está vacío ("Debe configurar las instrucciones antes de activar esta opción en el checkout"), pero no te impide activarlo. Si lo dejas vacío, el huésped puede elegir el método y no recibe ninguna instrucción.
Estos métodos no tienen Editar ni Desconectar: para dejar de ofrecer uno, apaga su interruptor en Medios de pago.
Editar las credenciales
Si cambiaste o renovaste una clave en el panel del proveedor, actualízala con Editar (el lápiz de la fila). Los datos públicos vienen cargados y los secretos aparecen vacíos, marcados como ya configurados: escribe solo lo que cambió (un secreto vacío se mantiene como estaba) y haz clic en Guardar cambios. La guía de la pasarela sigue ahí, plegada, por si la necesitas. En Mercado Pago y PayU se actualizan juntas las dos opciones (la tarjeta y la cuenta).
⚠️ Los cobros nuevos usan las credenciales nuevas en cuanto guardas: un huésped que esté pagando en ese momento puede ver fallar su pago. Hazlo en un momento tranquilo.
Si el proveedor rechaza algún dato, la ventana te indica cuál: corrígelo y vuelve a guardar. Si te dice que la conexión es de una versión anterior y no se puede editar, desconéctala y vuelve a conectarla con sus credenciales.
Desconectar un medio de pago
Con Desconectar (el enchufe) y la confirmación ¿Desconectar …?, el medio de pago se quita de la propiedad y tu página deja de ofrecerlo. Si era el que cobraba la tarjeta, la tarjeta queda apagada hasta que elijas otro proveedor en Medios de pago; si usas WeSpeak Rates, también se quita de tus políticas de pago. Las credenciales no quedan guardadas: para volver a usarlo, conéctalo de nuevo desde Nueva Conexión.
Si ves Esta conexión necesita una baja manual, la conexión es de una versión anterior: con Desconectar de todos modos se quita de la propiedad, y después escríbenos a soporte para completar la baja con el proveedor.
Preguntas frecuentes
¿Qué necesito para conectar Stripe?
Solo tus dos claves de API: la Publishable Key y la Secret Key (panel de Stripe → Developers → API Keys, en modo Live). La ventana Conectar Stripe te guía paso a paso y no hace falta activar nada más en Stripe. WeSpeak no comprueba las claves: si hay un error, la conexión queda Activo igual y los pagos fallan, así que haz una reserva de prueba. Después, en Medios de pago, elige Cobrar con Stripe para la tarjeta.
Conecté Stripe (o Mercado Pago), pero las tarjetas no se cobran.
En Medios de pago, en ¿Cómo desea procesar los pagos con tarjeta?, sigue elegido Guardar datos de tarjeta para cobro manual (así arranca la cuenta): la tarjeta solo se guarda como garantía. Elige Cobrar con Stripe (o Cobrar con Mercado Pago / Cobrar con PayU). Si usas WeSpeak Rates, revisa también las políticas de pago que tengan su propia configuración.
¿Puedo conectar dos cuentas de Stripe (o de otra pasarela) en la misma propiedad?
No: cada propiedad tiene una sola conexión por proveedor. Si administras varias propiedades, cada una conecta la suya (puede ser la misma cuenta o una distinta).
Ya uso Wompi con mi motor de reservas. ¿Tengo que cambiar la URL de eventos?
No la reemplaces: en el paso de la URL de eventos, en ¿Ya tienes una URL en ese campo?, pega la que tienes hoy y copia la URL combinada que te devuelve. Tu motor sigue recibiendo sus avisos y WeSpeak confirma los pagos de sus reservas (ver Wompi: la URL de eventos).
El huésped reservó con transferencia y no recibió los datos de la cuenta.
Faltan las instrucciones: al activar Mostrar Transferencia bancaria en el checkout aparece el campo de instrucciones y, si queda vacío, el huésped no recibe ningún dato. Pasa lo mismo con el link de pago y el pago en el hotel. Complétalo (en cada propiedad) y envíale los datos a ese huésped por el chat.