A través de esta integración podrás:

• Enviar links de pago a tus huéspedes
• Recibir pagos directamente desde el motor de reservas
• Centralizar la gestión de pagos dentro de LobbyPMS

Durante este manual aprenderás cómo:

• Crear y configurar tu cuenta de Culqi.
• Obtener las credenciales necesarias para la integración.
• Configurar Culqi dentro de LobbyPMS.
• Activar Culqi como método de pago en el motor de reservas.
• Realizar pruebas para validar el correcto funcionamiento de la integración.

👉Esta integración sólo es viable si tienes una entidad legal en Perú.

¿Qué es Culqi?

Culqi es una pasarela de pagos peruana que permite a empresas y comercios recibir pagos online de forma segura mediante:

• Tarjetas de crédito
• Tarjetas débito
• Billeteras digitales
• Otros medios de pago locales

A través de esta integración podrás aceptar pagos de huéspedes desde tu sitio web y gestionar tus transacciones de forma centralizada.

Además, Culqi permite recibir pagos con:

• Visa • Mastercard • American Express • Diners Club • Yape • Plin

Configura tu cuenta en Culqi

Antes de comenzar, si no tienes cuenta de Culqi. Puedes hacer estos primeros pasos:

1. Crear un comercio activo en Culqi

Ingresa al portal de registro de Culqi y selecciona CulqiOnline:

afiliate.culqi.com 

Para crear la cuenta necesitarás:

• RUC o identificación fiscal activa del comercio.
• Correo electrónico de contacto.
• Número telefónico.
• Datos básicos del establecimiento.

Completa el formulario de registro y crea una contraseña segura para tu cuenta.

2. Aprobación y activación

Una vez terminado el proceso, deberás esperar la validación, que puede durar entre 1 a 3 días hábiles. Te llegará un correo con las credenciales para ingresar a tu CulqiPanel, donde podrás encontrar las llaves de integración. 

¿Cómo obtener los datos de integración?

Una vez ya tengas una cuenta de Culqi activa puedes ingresar al Panel de Integración con el mismo usuario y contraseña de tu CulqiPanel.  

https://culqipanel.culqi.com/login#/desarrollo/llaves 

Paso 1. Obtener API KEYS

En el panel producción, haz clic en la sección “Desarrollo / API Keys”  encontrarás dos API KEYS  (una pública y otra privada) que son creadas exclusivamente para funcionar dentro del ambiente seleccionado. 

• Llave pública: pk_(live)_XXXX
• Llave privada: sk_(live)_XXXX

Paso 2. Obtener la llave RSA

1. Ingresa al Dashboard de producción con tu usuario y contraseña.
2. Luego, haz clic en la sección “Desarrollo / RSA Keys” de la barra de navegación a la mano izquierda.
3. Pulsa crear llave RSA e ingresa los datos solicitados:

1. Nombre de tu llave RSA.
2. Tiempo de vigencia de la llave (el tiempo máximo es un año).
3. Marca el endpoint de backend
4. Seleccionar todos los servicios:
   • Tokens
   • Tarjetas
   • Cargos
   • Planes
   • Devoluciones
   • Suscripciones
   • Clientes
   • Ordenes

4. Una vez generada la llave copia y resguarda la siguiente información: 
   1. El RSA Key
   2. El código Hash
      
      
      Recuerda que la llave RSA sólo se mostrará una vez en el panel, en caso no se llegue a copiar se tendrá que generar una nueva. 

Pega los datos de integración en LobbyPMS:

1. Ingresa al menú Configuraciones > Pasarelas de pago 
    

2. Asegúrate de que tengas activa la opción Conectar un sistema de pagos online. 
   
   Es posible que para activar esta opción el sistema te solicite activar una forma de pago predeterminada para el motor de reservas. Si no sabes cómo hacerlo, visita este manual: Activar la forma de pago para el motor de reservas
    

3. Haz clic en el icono agregar en la opción Culqi. 
   

4. Debes pegar Llave pública, Llave privada, Llave RSA y Código Hash RSA  obtenidas en tu cuenta de Culqi.
    
5. Para finalizar, elige cómo Asociar a una forma de pago, también puedes dejar la opción predeterminada. Y das clic en “Guardar cambios”
   

Activar Culqi para el Motor de Reservas:

1. Ingresa al menú Configuraciones > Motor de reservas > Opción Confirmación y pagos.  Asegúrate de que tengas activa la opción Conectar un sistema de pagos online. 
    

2. Selecciona la forma de pago preferida para tus reservas: Pago de la primera noche o Pago de un porcentaje sobre el total de la reserva.
   
    

3. Activa Culqi y da clic en guardar cambios.
   
   

Puedes ingresar al motor de reservas y realizar una prueba con una reserva para verificar que el botón de Culqi esté activo al momento de completar la reserva. 

Nota importante:

• El tiempo máximo de vigencia de la llave RSA es de un año, cuando se actualice debe también actualizarse en LobbyPMS.

 ¿Necesitas ayuda adicional? 

Si tienes alguna duda sobre esta función, no olvides que puedes contactarnos en el botón azul de asistencia ubicado en la parte inferior derecha de tu cuenta de LobbyPMS.