Cómo implementar una pasarela de pago

Descripción general

La pasarela de pago permite a tus clientes realizar pagos seguros directamente desde la app, lo que les permite completar compras de productos o servicios sin salir de ella.

STAY ofrece integración con dos pasarelas de pago:

• Stripe, una de las plataformas de pago más utilizadas y fiables a nivel global.
• Adyen, una solución de nivel empresarial usada por grandes marcas del sector hotelero.

Este artículo explica cómo configurar cada opción y qué información se necesita para completarla.

Antes de empezar

Antes de integrar una pasarela de pago con STAY, asegúrate de:

• Tener acceso como administrador a tu cuenta de Stripe o Adyen.
• Contar con una persona de contacto responsable de completar la configuración técnica en tu empresa o grupo.

Opción 1: Integración con Stripe

STAY ofrece una integración directa con Stripe mediante Stripe Connect. Esta opción es rápida y adecuada para la mayoría de los establecimientos.

Guía paso a paso

Paso 1: Abrir el enlace de registro de Stripe

1. Haz clic en el enlace de registro personalizado que te haya proporcionado STAY.
2. Introduce tu correo electrónico y número de teléfono, y haz clic en Continuar.
3. Introduce el código de verificación de 6 dígitos que recibirás por SMS.

Paso 2: Introducir la información de la empresa

1. Selecciona país y tipo de empresa:
   • Elige el país donde opera la empresa.
   • Especifica el tipo de empresa y su estructura. 
2. Rellena los datos de la empresa: nombre legal, CIF, dirección comercial y página web.

Paso 3: Verificar al representante de la empresa

Proporciona el nombre completo, fecha de nacimiento y dirección del representante legal.

Indica si es un propietario (con al menos un 25% del negocio) o miembro del consejo directivo.

Paso 4: Añadir los datos bancarios

Introduce los datos de la cuenta bancaria en la que deseas recibir los pagos de Stripe.

 

 

Paso 5: Revisar y confirmar

Verifica que toda la información sea correcta y haz clic en Confirmar para completar el registro.

Condiciones de Stripe

• Precios: Consulta los precios de Stripe Connect Standard.
• Pagos: Stripe transfiere los fondos automáticamente cada 7 días.

 

 

 

Opción 2: Integración con Adyen

STAY también admite integración con Adyen, una plataforma avanzada para clientes corporativos. Adyen ofrece capacidades ampliadas y soporte para múltiples métodos de pago, como Apple Pay y Google Pay.

 

 Guía paso a paso

Paso 1: Crear una cuenta de comerciante

Crea una merchant account (cuenta de comerciante) específica en Adyen para cada hotel. Se recomienda incluir la palabra “STAY” en el nombre para facilitar su identificación. Asegúrate de que la cuenta esté en estado “live” (activa, en producción).

Paso 2: Generar las credenciales de API

1. Ve a Developers > API credentials en el panel de Adyen.
   
   

2. Haz clic en Create new credential.

3. Selecciona Web service user como tipo de credencial y haz clic en Create credential.
   
   

4. Genera una API Key. Solo se muestra una vez. Guárdala en un lugar seguro.
   
   

5. Configura los métodos de pago que desees activar.
   
   

6. Añade los siguientes dominios como allowed origins (orígenes permitidos):

   https://.stay-app.com
   https://.stay-app.systems
   https://pwa.staging03.stay-app.systems

   

7. Obtén la Client Key (clave de cliente): en la sección Authentication de tus credenciales de API, copia el campo Client Key y guárdalo junto con tu API Key. Ambos deberán compartirse con el equipo de STAY.
   
   

8. Asigna los permisos necesarios a la cuenta.

   

   

Paso 3: Crear y configurar el webhook

1. Ve a Developers > Webhooks > Create new webhook.
   
   
2. Tipo: Standard
   
   
3. Nombre sugerido: Webhook for STAY
4. Selecciona las cuentas de merchant correspondientes.
   
   
5. En Server Configuration, introduce la URL: https://cluster.stay-app.com/stay-api/payments/adyen/hook
   
   
6. En Security:

• • Configura un usuario y contraseña (compártelo de forma segura usando onetimesecret o solicita acceso al equipo de STAY).
  • Genera una HMAC Key y guárdala de forma segura. También deberás compartirla con STAY más adelante.
    
    

Paso 4: Obtener el live endpoint prefix

El live endpoint prefix es un identificador único que Adyen asigna a tu cuenta de empresa en el entorno de producción (live). Se usa para construir las URLs de los endpoints de la API y garantizar que las transacciones se enruten correctamente a través de la infraestructura de Adyen.

1. Ve a Developers > API URLs en tu cuenta de Adyen (entorno live).
   
   
2. En la sección Prefix, copia el valor del live endpoint prefix.
3. Guarda esta información para compartirla más adelante.

Paso 5: Compartir las credenciales de forma segura con STAY

Cuando hayas completado la configuración en Adyen, envía al equipo de STAY las siguientes credenciales a través de un canal seguro (preferiblemente onetimesecret):

• API_KEY
• CLIENT_KEY
• HMAC_KEY
• Nombre de la cuenta de merchant
• Live Endpoint Prefix correspondiente a la región del hotel

Paso 6: Activar Apple Pay y Google Pay (opcional)

Apple Pay

Para que el botón de Apple Pay se muestre en la ventana de pago de Adyen (donde los clientes pueden introducir los datos de su tarjeta) sigue estos pasos:

1. Activa Apple Pay como método de pago en tu cuenta de Adyen.
2. Configura un certificado válido de Apple Pay:
   • Usando el certificado de Adyen (documentación oficial)
   • Usando tu propio certificado (documentación oficial)

Google Pay

Google Pay no necesita certificado, pero requiere completar ciertos pasos descritos en la documentación oficial de Adyen.

Paso 7: Personalizar la apariencia de los enlaces de pago

Para ofrecer una experiencia coherente y alineada con tu marca al utilizar Pay by Link, debes configurar el diseño asociado a la cuenta de merchant utilizada para STAY.

1. Ve a Pay by Link > Themes en el panel de Adyen.
   
   
2. Crea un nuevo tema o edita uno existente.
3. Personaliza los siguientes elementos:
   • Logotipo
   • Colores
   • Tipografía
   • Botón de pago

Haz clic en Guardar.

Paso 8: Añadir una URL de términos y condiciones

Para evitar que aparezca un mensaje de “undefined” (sin definir) en la página de pago, configura una URL válida para los Términos y condiciones.

1. Ve a Pay by Link > Settings en el panel de Adyen.
2. En el campo Terms and Conditions URL, introduce el enlace a la página legal del hotel o de STAY.
3. Haz clic en Guardar.

Próximos pasos

Una vez que completes la configuración con Stripe o Adyen:

• El equipo de STAY habilitará y probará la pasarela de pago.
• Realiza transacciones de prueba para confirmar que todo funciona correctamente.
• Comienza a aceptar pagos reales desde la app para huéspedes (consulta la sección Pagos en los ajustes de PRO).

¿Necesitas más ayuda?

Si tienes más preguntas o necesitas asistencia adicional:

• Contacta con nosotros a través del chat
• Envía un ticket a nuestro equipo de Soporte
• Visita STAY Academy, nuestra plataforma de formación.