Como autorizar um cartão com o recurso do portal de pagamentos

Mariia Korostashevych

Atualizado 3 de agosto de 2026 09:41

Objetivo	Autorizar o cartão de crédito de um hóspede por meio de um processador de pagamentos conectado ao PMS da Cloudbeds, e então capturar, anular ou revisar a autorização.
Indicado para	Agentes da recepção, administradores da propriedade e equipe que gerenciam pagamentos de reservas e autorizações de cartão de crédito.
Use quando	Você precisar colocar uma retenção temporária no cartão do hóspede e capturar ou liberar o valor autorizado posteriormente.
Requisitos	O processamento de pagamentos deve estar configurado no PMS da Cloudbeds, e o portal de pagamentos conectado deve suportar autorizações de cartão de crédito.
Resultado esperado	O valor selecionado é autorizado no cartão do hóspede e pode ser capturado ou anulado posteriormente na reserva.
Limitações	O PMS da Cloudbeds não suporta o aumento de uma autorização existente. Para alterar o valor, anule a autorização atual e crie uma nova.

Introdução

Uma autorização de cartão de crédito coloca uma retenção temporária nos fundos sem cobrar imediatamente o hóspede. O valor autorizado pode ser capturado depois como pagamento ou anulado para liberar a retenção.

Este guia explica como adicionar um cartão a uma reserva, autorizar um valor, gerenciar uma autorização existente e revisar os registros de transações relacionados. Antes de começar, confirme que o processamento de pagamentos está configurado no PMS da Cloudbeds.

Para os fluxos de trabalho de despesas incidentais do Cloudbeds Payments, revise o artigo: Cloudbeds Payments - Como autorizar despesas incidentais.

Sumário

Considerações importantes
Adicionando e autorizando um cartão de crédito
Período de autorização
Gerenciando uma autorização existente
Revisão de registros de autorização e captura

Considerações importantes

Alterando um valor autorizado

Autorizações incrementais não são suportadas. Você não pode adicionar um valor a uma autorização existente.
Anule e reautorize quando o valor precisar ser alterado. Anule a autorização existente e, em seguida, crie uma nova autorização para o total atualizado.
Confirme os fundos disponíveis antes de reautorizar. Após a anulação da retenção original, o cartão pode não ter fundos suficientes disponíveis para a nova autorização. A nova tentativa pode falhar, e a retenção anterior não estará mais disponível.

Adicionando e autorizando um cartão de crédito

Um cartão deve estar armazenado na reserva antes que você possa autorizar um valor. Use a opção de entrada manual para um processador de terceiros suportado. Propriedades que utilizam o Cloudbeds Payments também podem tokenizar um cartão por meio de um terminal conectado.

Opção A: Inserir os dados do cartão manualmente

Abra a reserva e selecione a guia Cartões de crédito;
Selecione +ADICIONAR;
Insira os dados do cartão.

Opção B: Adicionar um cartão com um terminal do Cloudbeds Payments

Um terminal do Cloudbeds Payments não pode criar uma autorização diretamente. Use-o para tokenizar e salvar o cartão na reserva sem cobrar o hóspede. Crie a autorização a partir do PMS da Cloudbeds após o cartão ser salvo.

Abra a reserva e selecione a guia Cartões de crédito;
Selecione +ADICIONAR e depois selecione Adicionar com terminal;
Selecione o leitor de cartão conectado e peça para o hóspede passar, inserir ou aproximar o cartão;
Selecione Salvar. O cartão é tokenizado e armazenado na reserva sem gerar uma cobrança.

Dica importante: O terminal salva apenas o cartão tokenizado. A retenção da autorização começa quando você autoriza o cartão no PMS da Cloudbeds, não quando o cartão é adicionado pelo terminal.

Autorização do o cartão salvo

Depois que o cartão é armazenado na reserva, conclua a autorização:

Selecione o cartão que deseja autorizar. Isso é necessário quando a reserva possui vários cartões armazenados;
Selecione AUTORIZE;
Insira o valor a autorizar e depois selecione AUTORIZE.

Período de autorização

O vencimento da autorização depende do processador conectado e do país da transação. Confirme o período de retenção aplicável com o processador de pagamentos ao planejar depósitos para reservas com data de chegada futura.

O processador de pagamentos determina por quanto tempo o valor autorizado permanece bloqueado no cartão.
O período máximo de autorização no PMS da Cloudbeds é de 30 dias para o Cloudbeds Payments e sete dias para outros processadores.
Exceção México: Quando a propriedade e o emissor do cartão estão no México, a autorização expira após sete dias.
Quando uma autorização expira, ela é anulada. O valor é removido dos detalhes do cartão e a opção de capturar ou anular a autorização não está mais disponível.
Para reservas com data de check-in distante, você pode autorizar o cartão novamente mais próximo da chegada. Inclua o momento da autorização na política de pagamento ou depósito da propriedade.

Para cartões adicionados por meio de um terminal do Cloudbeds Payments, o período de autorização começa quando a autorização é criada no PMS da Cloudbeds. Não começa quando o cartão é tokenizado pelo terminal.

Gerenciando uma autorização existente

Após a autorização do cartão, a reserva exibe opções para capturar ou anular a autorização.

Capturar

Use Capturar para cobrar os fundos da autorização existente.

Insira um valor que seja menor ou igual ao valor autorizado.
Se você capturar um valor menor que o autorizado, o valor restante será anulado. Se você inserir um valor maior que o autorizado, a transação falhará.

Anular

Use Anular para cancelar a autorização e solicitar a liberação dos fundos retidos.

O sistema da Cloudbeds envia a solicitação de anulação quando você seleciona a ação.
A instituição financeira do hóspede pode levar até 14 dias para disponibilizar os fundos novamente.

Revisão de registros de autorização e captura

Os registros do cartão mostram a data e hora, tipo de transação, identificador da transação ou pagamento e o valor associado às atividades de autorização e captura.

Abra a guia Cartões de Crédito da reserva;
Selecione Registros.

A ID da transação é gerada pelo processador de pagamentos para identificar uma operação financeira envolvendo movimentação de fundos.
Use o identificador como referência ao buscar a transação no portal do processador de pagamentos.
Dependendo do processador, o Relatório de Processamento de Pagamentos pode mostrar uma ID de pagamento em vez disso. Muitos processadores não geram uma ID de transação para uma autorização porque nenhum fundo foi movimentado ainda.

Próximo passo

Após autorizar, capturar ou anular o cartão, revise o Relatório de Processamento de Pagamentos quando precisar reconciliar a transação ou localizar sua referência no processador.