Configure processadores de pagamento personalizados e pagamentos com cartão-presente no Motor de Reservas Plus

Objetivo Configurar um processador de pagamentos personalizado ou fluxo de cartão-presente no Motor de Reservas Plus e entender o caminho de implementação e suporte suportado.
Ideal para Administradores de PMS, gerentes de estabelecimento, proprietários e desenvolvedores web ou parceiros de integração que trabalham em um fluxo de pagamento personalizado.
Use quando Você quiser registrar uma opção de pagamento personalizada através do Motor de Reservas Plus, suportar o registro de cartão-presente com campos personalizados, testar um processador de terceiros ou entender o que é suportado com a Experiência Imersiva.
Requisitos Motor de Reservas Plus, Transferência Bancária habilitada para o Motor de Reservas, acesso à guia Personalizar do Motor de Reservas e um desenvolvedor web experiente ou parceiro de integração para JavaScript personalizado. Fluxos de cartão-presente também requerem um campo personalizado para hóspede.
Resultado esperado A opção de pagamento personalizada é registrada através do EventSystem do Motor de Reservas, aparece durante a finalização da compra hospedada, e a lógica personalizada do provedor pode redirecionar o hóspede para completar o pagamento após a criação da reserva.
Limitações Apenas um processador de pagamento personalizado pode ser configurado. Métodos de pagamento personalizados são suportados somente no Motor de Reservas hospedado, não na Experiência Imersiva completa. A Cloudbeds não desenvolve nem mantém a lógica personalizada do processador.

Introdução

Motor de Reservas Plus da Cloudbeds pode suportar um processador de pagamentos personalizado ou fluxo de trabalho de cartão-presente por meio de JavaScript personalizado. A opção de pagamento personalizada usa o EventSystem do Motor de Reservas e a opção de pagamento Transferência Bancária como base para o fluxo personalizado.

O Motor de Reservas hospedado continua sendo o ambiente de finalização da compra suportado para métodos de pagamento personalizados. Este artigo explica os requisitos de configuração, o que o Suporte da Cloudbeds pode ajudar, o que permanece sob responsabilidade do provedor de pagamento ou desenvolvedor, e como usar incorporações premium quando um estabelecimento deseja uma experiência de entrada no site mais imersiva.

Neste artigo

Quem isso afeta e como

Fluxos de pagamento personalizados envolvem tanto a configuração da Cloudbeds quanto o desenvolvimento de terceiros. Use esta tabela para identificar qual parte do processo se aplica a você.

Papel O que você precisa saber
Administrador do PMS ou Gerente do Estabelecimento Habilite a configuração de pagamento necessária no Motor de Reservas, adicione o código fornecido pelo provedor na guia Personalizar e conclua a configuração de teste suportada. Revise Requisitos e limites do suporte antes de implementar o script.
Desenvolvedor web ou provedor do processador de pagamentos Construa, mantenha e solucione problemas do JavaScript personalizado, redirecionamento do processador e lógica do lado do provedor. Para questões de integração mais profundas, o provedor de pagamento deve trabalhar com a equipe de Integrações da Cloudbeds. Revise Testar e solucionar problemas de um processador de pagamentos personalizado.
Proprietário ou Gerente Geral Use o Motor de Reservas hospedado para a finalização da compra com pagamento personalizado. Se desejar uma experiência de entrada no site mais personalizada com a marca, revise a abordagem suportada de incorporações premium em Usar métodos de pagamento personalizados com a experiência imersiva.

Requisitos e limites do suporte

Antes de implementar um processador de pagamentos personalizado ou fluxo de trabalho com cartão-presente, confirme as configurações necessárias do Motor de Reservas e quem é responsável por cada parte da implementação.

  • Habilite a Transferência Bancária como opção de pagamento para o Motor de Reservas no PMS da Cloudbeds.
  • Use JavaScript personalizado com o EventSystem do Motor de Reservas para registrar a opção de pagamento personalizada.
  • Apenas um processador de pagamento personalizado pode ser integrado. O estabelecimento não pode oferecer Transferência Bancária e um processador personalizado como opções separadas ao mesmo tempo.
  • O suporte a cartão-presente requer um campo personalizado para o hóspede inserir o número do cartão-presente.
  • Métodos de pagamento personalizados são suportados apenas em ambientes hospedados do Motor de Reservas. Eles não são suportados na experiência completa Immersive Experience 2.0 do Motor de Reservas da Cloudbeds.
  • As etapas de implementação deste artigo aplicam-se somente ao Motor de Reservas Plus.

 A Cloudbeds não desenvolve nem mantém processadores de pagamento personalizados. Construir, alterar ou solucionar problemas na lógica de processadores personalizados está fora do escopo do Suporte da Cloudbeds e do Cloudbeds Payments. Seu desenvolvedor web, fornecedor do processador de pagamento, revendedor ou parceiro de integração deve ser responsável pelo código personalizado e pelo comportamento do lado do provedor.

Como o Suporte da Cloudbeds pode ajudar

O Suporte da Cloudbeds pode auxiliar na configuração do lado da Cloudbeds necessária para que seu provedor teste a implementação. O suporte pode:

  • Orientar você na criação de um plano tarifário de teste com código promocional para que o provedor de pagamento possa revisar o console do navegador. Use uma tarifa personalizada de US$ 0,50 e disponibilize o plano tarifário de teste apenas para a fonte Motor de Reservas.
  • Ajudar você a adicionar scripts personalizados fornecidos pelo seu provedor de processador de pagamento ao painel Personalizar do Motor de Reservas.

Para solução de problemas avançada ou dúvidas sobre integração, o provedor do processador de pagamento deve trabalhar diretamente com a equipe de Integrações da Cloudbeds. Se o provedor ainda não for parceiro da Cloudbeds, peça que se inscreva pela página Parceiro da Cloudbeds.

Usar métodos de pagamento personalizados com a Immersive Experience

Os métodos de pagamento personalizados não são suportados na experiência completa do Motor de Reservas da Cloudbeds Immersive Experience 2.0. Se você deseja manter o início da jornada de reserva no site do seu estabelecimento, use as incorporações premium como ponto de entrada e conclua a reserva no Motor de Reservas hospedado.

Você pode usar incorporações premium, como os widgets multi-estabelecimento, seletor de data e seletor de acomodação no seu site. Os hóspedes podem interagir com a experiência suportada pelo widget no seu site e, em seguida, continuar para o Motor de Reservas hospedado pela Cloudbeds para concluir a reserva e usar o redirecionamento de pagamento personalizado.

 Limitação atual: Os hóspedes não podem visualizar nativamente os resultados completos da busca do Motor de Reservas no site do estabelecimento antes de serem redirecionados para a página hospedada para reserva e pagamento.

Configure um processador de pagamento de terceiro ou fluxo de trabalho de cartão-presente

A opção de pagamento personalizada deve ser registrada através do EventSystem do Motor de Reservas. A configuração abaixo cobre o registro do evento no lado da Cloudbeds e o evento de reserva criada usado pela lógica de redirecionamento do provedor.

Passo 1: Adicione o JavaScript personalizado na guia Personalizar

  1. Abra o Menu da Conta Account Menu.jpg e vá para Configurações > Motor de Reservas.
  2. Clique em Personalizar.
  3. Adicione o JavaScript personalizado no campo JavaScript.
  4. Clique em Salvar.

O JavaScript personalizado deve se inscrever no evento on-booking-engine-ready. Esse evento é disparado quando o Motor de Reservas está pronto para ativar e escutar eventos. O script também deve disparar o evento custom-payment-option-change para que o Motor de Reservas possa registrar a opção de pagamento personalizada.

<script>
window.addEventListener('on-booking-engine-ready', (e) => {
  const { eventSystem } = e.detail;

  eventSystem.dispatchEvent("custom-payment-option-change", {
    id: "%PAYMENT_OPTION_ID%",
    instructions: "Seu texto padrão para as instruções vai aqui.",
    name: "Seu texto padrão para a etiqueta vai aqui.",
  });
});
</script>

 Ao salvar as alterações no campo JavaScript, a Cloudbeds pode solicitar que você complete a autenticação multifator (MFA) avançada. Consulte Autenticação multifator avançada para campos personalizados de HTML e JavaScript do Motor de Reservas para o fluxo de verificação.

Passo 2: Registre a opção de pagamento personalizada no EventSystem

Use eventSystem.dispatchEvent() para disparar o evento custom-payment-option-change com os detalhes necessários da opção de pagamento:

  • id [string]: Obrigatório. O valor deve ter comprimento maior que 0 e ser válido para uso como um id CSS. Não use espaços, pontos e vírgulas ou caracteres especiais inválidos em seletores CSS. O formato sugerido é kebab-case. Substitua %PAYMENT_OPTION_ID% pelo id do gateway de pagamento personalizado.
  • instructions [string]: Opcional. Exibe instruções ou uma descrição quando o hóspede expande a opção de pagamento personalizada. Use este valor como texto padrão quando o texto específico por idioma não for personalizado via CSS.
  • name [string]: Obrigatório. O valor deve ter comprimento maior que 0.

 Se a carga do evento não atender às condições obrigatórias, a opção de pagamento personalizada não será registrada e a opção Transferência Bancária continuará sendo exibida.

Após salvar as alterações, abra o Motor de Reservas hospedado e teste a finalização da compra. A etapa de pagamento pode abrir em uma janela pop-up ou modal separada, em vez de aparecer embutida na página da reserva. A opção de pagamento personalizada ainda deve ser registrada através do EventSystem do Motor de Reservas.

A imagem a seguir mostra a janela de pagamento hospedada com as formas de pagamento disponíveis após o hóspede avançar na finalização da compra.

Finalização da compra no Motor de Reservas da Cloudbeds mostrando uma janela de pagamento separada com opções de Cartão de Crédito e Transferência Bancária

Passo 3: Trate o evento reservation-created e o redirecionamento do provedor

Quando um hóspede faz uma reserva usando a opção de pagamento personalizada, a reserva é criada no PMS da Cloudbeds com um método de pagamento e-banking e nenhum pagamento é coletado pela Cloudbeds. O script personalizado do provedor pode escutar o evento reservation-created, usar os dados da reserva e redirecionar o hóspede para o gateway de pagamento do terceiro para concluir o pagamento.

eventSystem.addEventListener('reservation-created', (data) = {
  // Seu código para executar após a criação da reserva...
})

Use o EventSystem do Motor de Reservas para os eventos de registro e reservation-created. Não dependa apenas de ouvintes de clique específicos da página, cliques em botões de acordeão ou seletores da interface para determinar se a opção de pagamento personalizada foi selecionada.

Expanda as seções de referência avançada abaixo se precisar de detalhes opcionais sobre etiqueta, instrução, ícone ou dados da reserva.

Personalizações opcionais de etiqueta, instrução e ícone

Você pode especificar texto baseado no idioma para a etiqueta personalizada da opção de pagamento:

html[lang="%LANG%"] [data-id="%PAYMENT_OPTION_ID%-name"]::before {
  content: "Seu texto específico para o idioma da etiqueta vai aqui.";
}

Também é possível configurar instruções baseadas no idioma:

html[lang="%LANG%"] [data-id="%PAYMENT_OPTION_ID%-instructions"]::before {
  content: "Seu texto específico para o idioma das instruções vai aqui.";
}

Você pode ocultar o ícone padrão e adicionar um logotipo ou ícone personalizado:

// Para ocultar o ícone SVG padrão
[data-id="%PAYMENT_OPTION_ID%-icon"] svg {
  display: none;
}

// Para personalizar o ícone definindo-o como imagem de fundo
[data-id="%PAYMENT_OPTION_ID%-icon"] {
  background-image: url(PAYMENT_OPTION_ICON_URL);
  background-size: cover;
  background-position: center;
  width: 40px;
  height: 40px;
}

referência de dados reservation-created

Os dados expostos pelo evento reservation-created têm a seguinte estrutura:

interface CreatedReservation {
  booking_id?: `${number}`;
  booking_total?: number;
  checkin_date?: string;
  checkout_date?: string;
  city?: string;
  currency_code?: string;
  hotel_name?: string;
  real_booking_total?: number;
  resRooms?: {
    adults: `${number}`;
    id: `${number}`;
    kids: `${number}`;
    package: `${number}`;
    package_name: string | null;
    rate_id: `${number}`;
    room_total: `${number}`;
    room_type_id: `${number}`;
    room_type_name: string;
    room_type_photos: ({
      TYPE?: string;
      alt: string;
      cropParam: string | null;
      croppedImage: string;
      fullPath: string;
      galleryPath?: string | null;
      id: string;
      imageHeight: string;
      imageWidth: string;
      mime?: string;
      originalName: string;
      ownerId?: string;
      ownerType?: string;
      parentId: string;
      path: string;
      section?: string;
      size?: string;
      thumbPath: string;
      uploadedAt?: string;
      utype?: string;
    } & {
      featured: number;
      featuredPath: string | null;
    })[];
  }[];
  rooms?: Record<string, {="{" adults:="adults:" number;="number;" amount:="amount:" bookedid:="bookedId:" string[];="string[];" kids:="kids:" name:="name:" string;="string;" packageid?:="packageId?:" packagename?:="packageName?:" picture?:="picture?:" price?:="price?:" rateid:="rateId:" roomid:="roomId:" unit?:="unit?:" }="}">;
  state?: string;
  total_tax?: number;
  widget_property?: number;
};</string,>

Testar e solucionar problemas de um processador de pagamentos personalizado

Use um fluxo de teste controlado do Motor de Reservas quando seu provedor de pagamento precisar inspecionar o comportamento no console do navegador ou validar sua lógica de redirecionamento. O Suporte da Cloudbeds pode ajudar na configuração do teste do lado da Cloudbeds, mas o provedor de pagamento continua responsável pelo código do processador personalizado e pela solução de problemas do lado do provedor.

Criar um plano tarifário de teste para solução de problemas do provedor

O Suporte da Cloudbeds pode orientar você na criação de um plano tarifário temporário com código promocional para testes. Use uma tarifa personalizada de USD 0,50 e deixe o plano tarifário disponível apenas para a fonte Motor de Reservas, assim seu provedor de pagamento pode reproduzir o fluxo de finalização da compra e revisar o console do navegador.

Expanda o problema que corresponde ao comportamento que você está observando.

A opção de pagamento personalizada não é exibida

Verifique o seguinte:

  • Confirme que a Transferência Bancária está habilitada para o Motor de Reservas no PMS da Cloudbeds.
  • Confirme que o JavaScript personalizado foi adicionado na guia Personalizar do Motor de Reservas.
  • Confirme que a carga do evento custom-payment-option-change inclui um id e um nome válidos.
  • Confirme que o id não contém espaços, ponto e vírgula ou caracteres inválidos para seletor CSS.
  • Confirme que apenas um gateway de pagamento personalizado está configurado.

Se a carga do evento não atender a todos os requisitos, a opção de pagamento personalizada não será registrada e a Transferência Bancária continuará sendo exibida.

O redirecionamento do pagamento personalizado não funciona

Verifique o seguinte:

  • Confirme que o script personalizado escuta o evento reservation-created.
  • Confirme que o script não depende apenas de ouvintes de clique específicos da página, cliques em botões de acordeão ou seletores da interface.
  • Confirme que a URL do gateway de pagamento de terceiro e os parâmetros de redirecionamento são válidos.

Se o redirecionamento continuar falhando após a confirmação da configuração do lado da Cloudbeds, o provedor do gateway de pagamento ou o desenvolvedor deve solucionar a lógica personalizada. Para dúvidas sobre integração mais profunda, o provedor deve trabalhar diretamente com a equipe de Integrações da Cloudbeds. Se o provedor ainda não for parceiro da Cloudbeds, peça que se inscreva pela página Parceiro da Cloudbeds.


Agora que você entende a configuração suportada de pagamento personalizado e os limites de titularidade, revise estes recursos para capacidades mais amplas do Motor de Reservas Plus e a configuração suportada da Experiência Imersiva:

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0

Comentários

0 comentário

Por favor, entre para comentar.