Omnibees
Omnibees es una plataforma de distribución y gestión hotelera que proporciona tecnología para que los hoteles gestionen reservas y optimicen los ingresos a través de múltiples canales de venta. Para obtener más información, visita el sitio web oficial de Omnibees.
Requisitos Previos
Antes de integrar PayU con Omnibees, asegúrate de tener lo siguiente:
- Una cuenta activa de PayU Latam.
- Una cuenta activa de PayU Enterprise (PaymentsOS) en modo de producción/en vivo (consulta los detalles de activación a continuación).
Activación de Tu Cuenta de PayU Enterprise (Modo Live)
Por defecto, las cuentas nuevas se configuran en modo de prueba. Para habilitar las transacciones en vivo, contacta a tu gerente de cuenta y envía una solicitud con los siguientes detalles:
- Merchant ID: Localiza el Merchant ID de tu cuenta LATAM en el Panel de Gestión de PayU.
- Account ID: Encuentra tu Account ID en el panel de control de PayU Enterprise haciendo clic en tu nombre de usuario en la esquina superior derecha.
Integración de PayU con Omnibees
La integración consta de dos pasos principales:
- Configuración de tu cuenta de PayU Enterprise
- Contactar a Omnibees para habilitar la integración
1. Configuración de tu Cuenta de PayU Enterprise
PayU Enterprise opera a través de PaymentsOS, que actúa como middleware entre PayU Latam y Omnibees. La configuración incluye los siguientes componentes:
- Configuración del proveedor
- Configuración de la unidad de negocio
- Creación de webhook
1.1 Configuración de un Proveedor
Un proveedor almacena tus credenciales de procesamiento de pagos. Sigue estos pasos para configurar uno:
- En el panel de control de PayU Enterprise, navega a Configurations > Providers.
-
Haz clic en el módulo correspondiente al país o división que estás configurando.
-
Completa los siguientes campos:
| Campo | Descripción |
|---|---|
| Configuration Name | Ingresa un nombre para la configuración del proveedor. |
| Description | Proporciona una descripción opcional. |
| apiLogin | Nombre de usuario o login proporcionado por PayU. Obtener API Login |
| apiKey | Clave única de tu comercio. Obtener API Key |
| accountId | ID de la cuenta de PayU basado en tu país de operación. |
| merchantId | Tu ID de comercio en PayU Latam. |
| paymentCountry | País de procesamiento en formato ISO 3166 Alpha-3. |
| multicapture | Selecciona None. |
| cashRedirect | Selecciona None. |
Nota
Si estás utilizando versiones anteriores del Módulo Administrativo de PayU, encuentra la información de tu cuenta en Configuración > Información técnica.
- Haz clic en Create.
1.2 Creación de una Unidad de Negocio
Una unidad de negocio vincula la configuración del proveedor con las credenciales de la API de PayU Enterprise para procesar transacciones. Sigue estos pasos:
- En el panel de control, ve a Configurations > Business Units.
- Haz clic en Create Business Unit e ingresa:
| Campo | Descripción |
|---|---|
| Business Unit Name | Debe estar en minúsculas y no contener espacios. Este valor no se puede cambiar más tarde, así que asegúrate de que sea preciso. |
| Description | Descripción opcional. |
- En la sección Choose a Default Provider for This Business Unit, selecciona el proveedor creado en el paso 1.1 y luego haz clic en Create.
Nota
Puedes hacer clic en la pestaña de la unidad de negocio para obtener los siguientes detalles necesarios para la integración de Omnibees: App ID, Public API key y Private API key.
1.3 Creación de un webhook
El webhook recibe notificaciones de Omnibees cuando el estado de una transacción cambia. Sigue estos pasos:
- En el panel de control, navega a Configurations > Webhooks.
-
Haz clic en Create a Webhook Endpoint e ingresa:
https://paymentgateways.omnibees.com/PayUWebhookService.ashx -
Habilita Update y Create para el evento Charge en Payment Event Alerts.
-
Asigna el webhook a la unidad de negocio creada anteriormente y selecciona la versión más reciente del webhook.
-
Haz clic en Create.
2. Contactar a Omnibees para Habilitar la Integración
Una vez que los componentes de PayU Enterprise estén configurados, envía un correo electrónico a servicedesk@omnibees.com para solicitar la activación. Incluye los siguientes detalles:
- App ID
- Public API key
- Private API key
- Unidad de negocio (opcional)
Gestión de Usuarios en PayU Enterprise
PayU Enterprise permite el acceso de usuarios basado en roles para las unidades de negocio. Para obtener detalles sobre la gestión de usuarios y permisos, consulta la documentación de PayU Enterprise.