Pagos

En la página Payments (pagos) conectas Requiply con pasarelas de pago online. Las pasarelas conectadas permiten a los clientes pagar online durante la reserva, al finalizar la reserva, en las facturas y con los enlaces de pago.

Esta página está en Settings → Integrations → Payments.

Por qué importan los pagos

Las integraciones de pago controlan qué pasarelas de pago online están disponibles para tu organización. Sin una integración activa con una pasarela, Requiply sigue admitiendo los flujos de pago que no son online, pero los clientes no pueden usar esa pasarela para pagar online en una página alojada.

Las pasarelas de pago conectadas se pueden usar en:

• Finalizar la reserva en el portal de clientes: los métodos de pago online solo se pueden activar después de configurar la pasarela correspondiente.
• Reservas: los intentos de pago online crean registros de pago vinculados a la reserva.
• Facturas y enlaces de pago: los clientes pueden abrir las URL de pago de la pasarela desde los registros de pago.
• Actualizaciones del estado del pago: las notificaciones de la pasarela actualizan el estado del pago de la reserva cuando un pago se completa, falla, caduca o se cancela.

Qué verás

La página agrupa las pasarelas en dos secciones:

• Global providers (pasarelas internacionales): Stripe, para pagos con tarjeta en cualquiera de las 14 monedas de Requiply.
• Ukrainian providers (pasarelas ucranianas): Plata by mono, LiqPay y WayForPay.

Cada tarjeta de pasarela incluye:

• El nombre de la pasarela y su logotipo.
• El estado de la configuración: Configured (configurada) o Not configured yet (todavía sin configurar).
• Tutorial: abre en una pestaña nueva del navegador la guía paso a paso de Requiply para configurar esa pasarela, en el idioma de tu interfaz. La tarjeta de Stripe no tiene enlace a un tutorial; sus pasos de configuración están en Stripe, más abajo.
• Setup (configurar): abre el formulario de credenciales de esa pasarela. Cuando la pasarela ya está configurada, el botón dice Manage (gestionar) y abre el mismo formulario.

El catálogo actual de pasarelas incluye:

Abrir un tutorial

Pulsa Tutorial en la tarjeta de una pasarela cuando necesites ayuda para encontrar las credenciales en tu cuenta de la pasarela. Requiply abre su propia guía paso a paso para esa pasarela en una pestaña nueva, en inglés o en ucraniano, según el idioma de tu interfaz.

Guías de configuración:

Configurar una pasarela

Pulsa Setup en la tarjeta de una pasarela para abrir el diálogo de configuración. El diálogo muestra el logotipo de la pasarela elegida y las credenciales que Requiply necesita para ella.

Después de pulsar Save, Requiply comprueba las credenciales con la pasarela de pago antes de guardar la integración. Si la comprobación es correcta, la pasarela queda activa para tu organización y la tarjeta puede pasar a Configured. Si la comprobación falla, Requiply muestra un error y no guarda la pasarela como activa.

Pulsa Cancel para cerrar el diálogo de configuración sin guardar los cambios.

Campos de cada pasarela

Plata by mono

Requiply comprueba el token con Monobank antes de guardarlo. Se rechaza un token con permisos no válidos o con un valor no válido. Los tokens del área de empresas de Monobank, incluidas las cuentas de personas jurídicas, también se verifican. Si antes se rechazó un token de este tipo, vuelve a intentar guardarlo.

LiqPay

Requiply comprueba las claves pública y privada de LiqPay antes de guardar la pasarela.

WayForPay

Requiply comprueba los datos de comercio de WayForPay antes de guardar la pasarela.

Stripe

Requiply comprueba la clave secreta con Stripe antes de guardarla. El secreto de firma del webhook no se comprueba al guardar: si es incorrecto o falta el endpoint, los clientes pueden pagar igualmente, pero el pago se queda en Pending (pendiente) en Requiply porque las actualizaciones de Stripe nunca llegan o se rechazan.

Añade el webhook de Requiply en Stripe

Stripe informa a Requiply de los pagos completados, fallidos, caducados y reembolsados mediante un webhook. Añádelo antes de guardar la integración:

1. En el Dashboard de Stripe, abre Developers → Webhooks y añade un endpoint (en los Dashboards más recientes se llama destino de eventos).
2. Pon como URL del endpoint https://app.requiply.com/api/payment-integrations/stripe/update-status.
3. Selecciona estos eventos: checkout.session.completed, checkout.session.async_payment_succeeded, checkout.session.async_payment_failed, checkout.session.expired y charge.refunded.
4. Guarda el endpoint, muestra su Signing secret (secreto de firma) y pégalo en Webhook signing secret en Requiply.

Monedas e importes

Stripe cobra a los clientes en la moneda de tu organización, y se admiten las 14 monedas de Requiply, incluida la rupia india (INR). JPY se cobra en yenes enteros e ISK en coronas enteras, así que los importes en esas monedas se redondean a una unidad entera.

Stripe también tiene un cobro mínimo por moneda, por ejemplo 0,50 USD o EUR, 0,30 GBP, 2,50 DKK, 3,00 NOK o 50 JPY. Se rechaza un enlace de pago por debajo del mínimo. Consulta las monedas admitidas por Stripe para ver todas las reglas.

Actualizar las credenciales

Para sustituir un token, una clave privada o un secreto de comercio, pulsa Manage en la misma tarjeta de la pasarela, introduce las credenciales nuevas y pulsa Save. Requiply actualiza la integración activa existente cuando las credenciales nuevas superan la comprobación.

Los valores secretos guardados no se muestran en la página después de la configuración. Guarda una copia segura en tu cuenta de la pasarela de pago o en tu gestor de contraseñas.

Desconectar una pasarela

La página Payments actual no incluye ninguna acción visible para desconectar o eliminar. Para cambiar una pasarela activa, pulsa Manage y guarda credenciales nuevas para esa misma pasarela.

Dónde se usan las integraciones de pago

Casos habituales

Conectar los pagos online por primera vez

1. Ve a Settings → Integrations → Payments.
2. Elige la pasarela que usa tu organización.
3. Pulsa Tutorial si necesitas ayuda para encontrar las credenciales necesarias.
4. Pulsa Setup.
5. Introduce las credenciales de la pasarela.
6. Pulsa Save.
7. Comprueba que la tarjeta de la pasarela cambia a Configured.
8. Ve a la pestaña Payments de la configuración del portal y activa el método de pago online correspondiente si hace falta.

Actualizar las credenciales de una pasarela

1. Ve a Settings → Integrations → Payments.
2. Pulsa Manage en la pasarela que quieras actualizar.
3. Introduce el nuevo token, las nuevas claves o los nuevos datos de comercio.
4. Pulsa Save.
5. Comprueba que la configuración se completa correctamente.

Resolver una configuración fallida

Si la configuración falla:

• Comprueba que los valores de las credenciales se han copiado de la cuenta correcta de la pasarela.
• Comprueba que la cuenta de la pasarela está activa y tiene permiso para crear pagos.
• Asegúrate de que la moneda de la organización es compatible con la pasarela que quieres usar.
• En Stripe, pega la clave secreta (sk_...), no la clave publicable (pk_...).
• En LiqPay y WayForPay, comprueba que las credenciales públicas y secretas pertenecen a la misma cuenta de comercio.
• Prueba a abrir el tutorial de la pasarela y repetir los pasos de configuración desde su panel.

Los pagos de Stripe se quedan en Pending

Si los clientes pagan con Stripe pero el pago se queda en Pending en Requiply:

• Comprueba que el endpoint de webhook de Stripe apunta a https://app.requiply.com/api/payment-integrations/stripe/update-status y escucha los eventos indicados en Añade el webhook de Requiply en Stripe.
• Comprueba que el secreto de firma guardado en Requiply pertenece a ese endpoint y al mismo modo (prueba o real) que la clave secreta.
• Después de corregir el endpoint, pulsa Manage en la tarjeta de Stripe y guarda el secreto de firma correcto.