Omnibees
O Omnibees é uma plataforma de distribuição e gerenciamento de hotéis que fornece tecnologia para que os hotéis gerenciem reservas e otimizem a receita em vários canais de vendas. Para mais informações, visite o site oficial do Omnibees.
Pré-requisitos
Antes de integrar o PayU com o Omnibees, certifique-se de ter o seguinte:
- Uma conta PayU Latam ativa.
- Uma conta PayU Enterprise (PaymentsOS) ativa no modo de produção/ao vivo (veja os detalhes de ativação abaixo).
Ativando sua Conta PayU Enterprise (Modo ao vivo)
Por padrão, novas contas são configuradas no modo de teste. Para habilitar transações ao vivo, entre em contato com seu gerente de conta e envie uma solicitação com os seguintes detalhes:
- Merchant ID: Localize o Merchant ID da sua conta LATAM no Painel de Gerenciamento do PayU.
- Account ID: Encontre seu Account ID no painel de controle do PayU Enterprise clicando no seu nome de usuário no canto superior direito.
Integrando o PayU com o Omnibees
A integração consiste em duas etapas principais:
- Configurando sua conta PayU Enterprise
- Entrando em contato com o Omnibees para habilitar a integração
1. Configurando sua Conta PayU Enterprise
O PayU Enterprise opera através do PaymentsOS, que atua como middleware entre o PayU Latam e o Omnibees. A configuração inclui os seguintes componentes:
- Configuração do provedor
- Configuração da unidade de negócios
- Criação de webhook
1.1 Configurando um Provedor
Um provedor armazena suas credenciais de processamento de pagamento. Siga estas etapas para configurar um:
- No painel do PayU Enterprise, navegue até Configurations > Providers.
-
Clique no módulo correspondente ao país ou divisão que você está configurando.
-
Preencha os seguintes campos:
Campo | Descrição |
---|---|
Configuration Name | Insira um nome para a configuração do provedor. |
Description | Forneça uma descrição opcional. |
apiLogin | Nome de usuário ou login fornecido pelo PayU. Obter API Login |
apiKey | Chave única do seu comércio. Obter API Key |
accountId | ID da conta PayU com base no seu país de operação. |
merchantId | Seu ID de comércio no PayU Latam. |
paymentCountry | País de processamento no formato ISO 3166 Alpha-3. |
multicapture | Selecione None. |
cashRedirect | Selecione None. |
Nota
Se você estiver usando versões mais antigas do Módulo Administrativo do PayU, encontre as informações da sua conta em Configurations > Technical Information.
- Clique em Create.

1.2 Criando uma Unidade de Negócios
Uma unidade de negócios vincula a configuração do provedor com as credenciais da API do PayU Enterprise para processar transações. Siga estas etapas:
- No painel, vá para Configurations > Business Units.

- Clique em Create Business Unit e insira:
Campo | Descrição |
---|---|
Business Unit Name | Deve estar em minúsculas e não conter espaços. Este valor não pode ser alterado posteriormente, portanto, garanta a precisão. |
Description | Descrição opcional. |
- Na seção Choose a Default Provider for This Business Unit, selecione o provedor criado na Etapa 1.1 e clique em Create.

Nota
Você pode clicar na guia da unidade de negócios para recuperar os seguintes detalhes necessários para a integração do Omnibees: App ID, Public API key e Private API key.

1.3 Criando um Webhook
O webhook recebe notificações do Omnibees quando o status de uma transação muda. Siga estas etapas:
- No painel, navegue até Configurations > Webhooks.

-
Clique em Create a Webhook Endpoint e insira:
https://paymentgateways.omnibees.com/PayUWebhookService.ashx
-
Habilite Update e Create para o evento Charge em Payment Event Alerts.
-
Atribua o webhook à unidade de negócios criada anteriormente e selecione a versão mais recente do webhook.
-
Clique em Create.

2. Entrando em Contato com o Omnibees para Habilitar a Integração
Depois que os componentes do PayU Enterprise estiverem configurados, envie um e-mail para servicedesk@omnibees.com para solicitar a ativação. Inclua os seguintes detalhes:
- App ID
- Public API key
- Private API key
- Unidade de negócios (opcional)
Gerenciamento de Usuários no PayU Enterprise
O PayU Enterprise permite acesso de usuário baseado em função para unidades de negócios. Para obter detalhes sobre o gerenciamento de usuários e permissões, consulte a documentação do PayU Enterprise.