Ir para o conteúdo

Infraestrutura

Pix em hotéis: sinal, saldo e a diferença para o Pix Automático

Separe o sinal e o saldo de uma reserva do Pix Automático e veja qual confirmação libera o quarto.

07/11/202615 min de leituraPor Gustavo Sanchez Palencia
Recepcionista segura dois comprovantes de tamanhos diferentes ligados à mesma reserva.

Uma reserva de hotel com sinal e saldo é um conjunto de obrigações da mesma estadia. O Pix Automático é outra coisa: uma autorização para cobranças recorrentes, concedida pelo pagador ao seu prestador de serviços de pagamento. Cobrar o sinal de uma diária e, depois, o restante da conta não cria, por si só, uma recorrência. Tratar os dois desenhos como se fossem o mesmo faz a recepção liberar quarto cedo demais ou faz o financeiro procurar uma autorização que a reserva avulsa nunca teve.

Este guia é para equipes de reservas, recepção, produto e finanças de hotéis que recebem em reais no Brasil. Ele separa o que confirma a disponibilidade, o que confirma cada pagamento e o que só faria sentido numa relação periódica. Os valores são fictícios. O texto não descreve integração com PMS, channel manager ou política jurídica de cancelamento, e não afirma que a AZPay ofereça Pix Automático. A modalidade e o contrato precisam ser confirmados na documentação do serviço usado.

O que a operação precisa decidir antes de emitir o primeiro QR?

Antes do QR, o hotel define a condição comercial que segura a reserva. Pode ser um sinal, o valor integral ou outra regra da tarifa. Também define por quanto tempo a disponibilidade permanece enquanto o pagamento não é confirmado por uma fonte financeira. Essas duas decisões são do negócio. O Pix só executa a cobrança que a operação decidiu criar.

Uma estadia de três noites, no exemplo deste artigo, custa R$ 1.200. A tarifa pede sinal de R$ 360 para manter o quarto e saldo de R$ 840 até a véspera da chegada. São duas obrigações, com valor, prazo e efeito próprios. O sinal, quando confirmado, sustenta a reserva. O saldo, quando confirmado, quita o restante combinado. A soma das duas obrigações explica a estadia. A soma dos comprovantes enviados pelo hóspede não explica nada até que cada crédito seja reconhecido.

O identificador da reserva deve nascer antes da cobrança. Cada Pix gerado carrega uma referência que aponta para essa reserva e para a obrigação específica: sinal ou saldo. Sem essa amarração, dois pagamentos corretos podem parecer um pagamento duplicado, e um pagamento de outra reserva pode quitar a conta errada.

Sinal e saldo são cobranças distintas da mesma estadia

Cada obrigação merece sua própria cobrança, seu próprio valor e seu próprio resultado. O guia Pix por dentro: cobrança, QR Code, confirmação, devolução e webhooks explica o ciclo de uma cobrança: criar, acompanhar o estado, confirmar o recebimento por canal confiável e tratar devolução como um fato separado. Uma estadia com sinal e saldo percorre esse ciclo duas vezes. O segundo ciclo não herda a confirmação do primeiro.

No exemplo, a reserva 4821 gera a cobrança do sinal de R$ 360. Quando o recebimento de R$ 360 é confirmado e associado a essa cobrança, a obrigação do sinal fica quitada e a reserva pode permanecer. Mais tarde, a mesma reserva gera a cobrança do saldo de R$ 840. O quarto só deve ser tratado como totalmente pago quando esse segundo recebimento também estiver confirmado e ligado à obrigação do saldo. R$ 360 confirmados não significam R$ 1.200 recebidos.

Emitir os dois QR ao mesmo tempo é uma escolha operacional, não uma exigência do Pix. Se os dois ficarem ativos, o hóspede pode pagar os dois, pagar só um ou pagar um valor que não corresponde a nenhuma das cobranças. A tela e o atendimento precisam dizer qual QR quita qual obrigação. Um único QR de R$ 1.200 resolve outro desenho: pagamento integral. Ele não deve ser apresentado como se fosse o sinal.

Por que dois Pix da mesma reserva não são Pix Automático?

O FAQ do Banco Central para participantes do Pix Automático descreve o serviço como um Pix iniciado pelo prestador do pagador, de forma automática, com base em instruções do prestador do recebedor e numa autorização prévia e específica do pagador. A página do Banco Central sobre Pix Automático apresenta a autorização prévia e os controles do pagador. O guia de implementação do Pix Automático separa recorrência, permissão e autorização: a recorrência descreve a periodicidade e o recebedor; a permissão permite o envio periódico de instruções; a autorização é concedida ao PSP do pagador e fica restrita a essa ponta.

Duas cobranças de uma mesma estadia não carregam essa estrutura. Não há periodicidade, ciclo mensal nem permissão para o hotel enviar instruções futuras de forma automática. Há um contrato de hospedagem com marcos de pagamento. Chamar esse fluxo de Pix Automático porque “o pagamento acontece sozinho depois do QR” mistura a confirmação instantânea de um Pix com a autorização de uma recorrência.

O artigo Pix Automático para assinaturas: autorização, cobrança e cancelamento na prática desenvolve autorização, ciclo, falha e cancelamento. Ele continua sendo a referência quando a relação é periódica. Este texto não repete esse mecanismo. Ele existe para a reserva em que a pergunta real é outra: o sinal confirmado segura o quarto, e o saldo confirmado quita o restante.

A diferença também aparece no cancelamento. Numa recorrência, cancelar a autorização interrompe instruções futuras e precisa ser confirmado no fluxo do participante. Numa reserva avulsa, cancelar a estadia é uma decisão comercial sobre disponibilidade e sobre o dinheiro já recebido. As duas conversas podem acontecer no mesmo hotel. Elas não compartilham o mesmo registro.

Quando uma relação de hospedagem pede recorrência de verdade?

Algumas relações do hotel são periódicas. Um contrato corporativo com diárias faturadas todo mês, uma mensalidade de clube do hotel ou uma vaga de estacionamento renovada no mesmo dia podem exigir cobrança recorrente. Aí a pergunta deixa de ser “como confirmar o sinal desta reserva” e passa a ser “existe autorização para o recebedor enviar instruções periódicas”.

Mesmo nesse caso, cada ciclo continua sendo uma competência. O guia de assinaturas mostra por que uma autorização válida não garante saldo e por que um pagamento de um ciclo não deve ser somado a tentativas falhas como se fossem novas dívidas. Para o hotel, o equivalente é claro: a mensalidade de abril e a mensalidade de maio são obrigações diferentes, ainda que nasçam da mesma permissão.

Uma reserva de fim de semana não vira recorrência porque a tarifa foi dividida em sinal e saldo. Também não vira recorrência porque o hóspede já se hospedou no ano anterior. Histórico de estadias é relacionamento comercial. Recorrência é um arranjo de pagamento com autorização, periodicidade e instruções. Confundir os dois faz o time procurar um cancelamento de autorização quando o que existe é uma cobrança avulsa em aberto.

Se o produto ainda não confirmou Pix Automático no provedor contratado, a operação periódica precisa de outro desenho explícito, como cobranças avulsas geradas a cada ciclo, com comunicação clara ao pagador. Gerar um QR todo mês sem dizer isso não é Pix Automático. É uma cobrança nova, que o pagador precisa concluir.

O que confirma que o hotel recebeu o dinheiro?

A confirmação útil vem do participante e da integração, por consulta autenticada ou por webhook validado. Um print, um e-mail encaminhado ou a frase “já paguei” no balcão registram uma alegação do hóspede. Eles não alteram o saldo da obrigação.

Na documentação pública da AZPay consultada em 7 de novembro de 2026, uma cobrança com `type_charge` Pix devolve QR, payload de copia e cola e expiração, e o status percorre estados como emitida, paga, cancelada, erro ou estornada. A mesma documentação trata o webhook como fonte de verdade do status final e afirma que Pix confirmado não tem etapa de captura. Essa descrição vale para o contrato e o ambiente habilitados na conta. Ela não cria um conector de PMS nem uma modalidade de Pix Automático.

O status pago precisa ser ligado à cobrança que o hotel criou e, por meio da referência, à reserva e à obrigação. Pago na cobrança do sinal não preenche o saldo. Pago numa cobrança expirada ou de outro valor pede investigação, não baixa automática. O artigo de ciclo de vida do Pix detalha corrida entre consulta e webhook, Pix com valor inesperado e a regra de não usar o navegador como fonte da verdade.

Para a recepção, a tela da reserva deve mostrar três fatos separados: a disponibilidade, a obrigação do sinal e a obrigação do saldo. Cada obrigação mostra valor esperado, cobrança associada, estado financeiro e identificador do recebimento quando ele existir. “Reserva confirmada” só deveria aparecer se a condição comercial definida no início estiver satisfeita por esses fatos.

Como amarrar cada recebimento à reserva certa?

O desenho mínimo usa quatro identificadores que não se substituem. A reserva identifica a estadia. A obrigação identifica sinal ou saldo. A cobrança identifica o pedido de pagamento enviado ao provedor. O recebimento identifica o Pix confirmado, com o valor e o momento em que a operação passou a conhecê-lo. Guardar só o número da reserva no campo de descrição do QR é frágil: descrição ajuda o hóspede, mas a conciliação precisa de referência estável no sistema.

No exemplo, a reserva 4821 tem a obrigação SINAL-4821 de R$ 360 e a obrigação SALDO-4821 de R$ 840. A cobrança do sinal nasce com referência externa SINAL-4821. Quando o webhook validado informa pagamento daquela cobrança no valor de R$ 360, o financeiro quita só SINAL-4821. A cobrança do saldo permanece em aberto até o próprio resultado. Se um segundo evento repetir o mesmo pagamento, a idempotência reconhece o fato já aplicado. O guia de webhooks em pagamentos explica por que repetir o evento não pode criar outro crédito.

Um pagamento de R$ 360 que chega sem referência, ou com referência de outra reserva, fica em exceção. A equipe pode suspeitar que é o sinal da 4821, mas a suspeita não quita a obrigação. A baixa espera a vinculação explícita, com registro de quem decidiu e qual evidência usou. Esse cuidado evita que duas reservas “confirmadas” dependam do mesmo Pix.

A expiração do QR também é um fato da cobrança, não da reserva. Se o QR do sinal expira sem pagamento, a disponibilidade segue a regra que o hotel definiu: liberar o quarto, prorrogar o prazo ou emitir nova cobrança. Emitir nova cobrança sem encerrar a anterior abre a porta para o hóspede pagar as duas. O estado da cobrança antiga precisa estar resolvido antes de tratar a nova como a única válida.

E se o valor ou a ordem dos pagamentos não bater com o combinado?

O saldo pode chegar antes do sinal, os dois podem chegar no mesmo minuto, ou o hóspede pode transferir R$ 1.200 para uma cobrança de R$ 360. Cada caso tem uma leitura financeira diferente. A pressa de entregar a chave não deveria colapsar essas leituras num único status “pago”.

Se o saldo de R$ 840 é confirmado e o sinal de R$ 360 ainda não, a estadia tem R$ 840 reconhecidos e R$ 360 em aberto. A soma recebida é menor que R$ 1.200. A reserva pode continuar sob a política da casa, mas o razão da obrigação do sinal segue pendente. Quitar as duas porque “o valor grande já entrou” esconde a falta do sinal e dificulta uma devolução parcial depois.

Se chega exatamente R$ 1.200 numa cobrança de R$ 360, o excedente de R$ 840 não é automaticamente o saldo. Pode ser um pagamento a maior da obrigação errada. A operação registra o valor recebido, compara com a cobrança e decide, com trilha, se concilia o excedente com SALDO-4821 ou se devolve a diferença. A conciliação de pagamentos é o lugar desse cruzamento. Ela não deve apagar a diferença para a reserva parecer redonda.

Se os dois pagamentos corretos chegam juntos, a idempotência e a referência decidem a ordem de aplicação. Os dois fatos podem ser registrados no mesmo instante. O que não pode acontecer é o segundo evento sobrescrever o primeiro e deixar a reserva com um único crédito de R$ 360.

Cancelar a reserva não devolve o Pix sozinho

Cancelar a estadia muda a disponibilidade e abre uma pergunta financeira: o que já foi recebido deve permanecer, ser devolvido no todo ou ser devolvido em parte, segundo a regra comercial que o hotel comunicou. A regra comercial não é uma regra do arranjo Pix e não cabe inventá-la aqui. O que cabe é o registro.

A devolução é um movimento próprio, ligado ao Pix original, com valor e confirmação. Devolver R$ 360 do sinal não apaga o fato de que R$ 360 foram recebidos. Se o saldo também tinha sido pago e a política devolve só o sinal, o saldo permanece reconhecido. Se a política devolve os dois, existem duas devoluções ou uma devolução por recebimento, conforme o provedor permitir, cada uma com resultado confirmado. O guia de ciclo de vida do Pix explica devolução parcial, múltiplas devoluções e o limite de não devolver mais do que foi recebido.

No exemplo, o hóspede cancela depois do sinal confirmado e antes do saldo. O hotel encerra a cobrança do saldo se ela ainda puder ser paga, libera ou mantém o quarto conforme a política e inicia a devolução do sinal apenas se a regra comercial mandar devolver. Um botão “cancelar reserva” que também dispara devolução sem mostrar o valor e a cobrança de origem mistura comercial e financeiro. A recepção precisa ver os dois resultados: quarto liberado e dinheiro em tratamento.

No-show é o mesmo tipo de separação. A estadia não aconteceu. O dinheiro do sinal pode estar retido pela regra tarifária. Manter o valor é uma decisão comercial registrada. Não é um estado automático do Pix. Se mais tarde a casa devolve parte do sinal, como R$ 100 de R$ 360, a devolução parcial de R$ 100 convive com os R$ 260 que permaneceram. O extrato da reserva mostra as duas coisas.

Pré-autorização de cartão é outro instrumento

Hotéis também bloqueiam valor estimado no cartão e capturam depois, no checkout, conforme consumo. A documentação de criação de cobrança da AZPay, lida em 7 de novembro de 2026, descreve `capture: false` como fluxo de somente autorização para hotéis, locadoras e padrões de pré-autorização. Isso é vocabulário de cartão. A página de Pix da mesma documentação diz que a confirmação Pix não tem etapa de captura.

Um sinal Pix de R$ 360 que já foi pago não é uma pré-autorização de R$ 360. O dinheiro do Pix, quando a cobrança está paga, já entrou segundo a confirmação do arranjo. Não fica “reservado” à espera de captura. Usar a mesma palavra “garantia” para os dois casos faz a recepção achar que pode liberar o quarto com um Pix ainda não confirmado, ou faz o financeiro esperar uma captura que não existe.

Se a estadia combina sinal em Pix e extras no cartão, os instrumentos continuam separados. O café da manhã adicional lançado no cartão não quita saldo Pix em aberto, e o Pix do saldo não captura o cartão. O artigo de autorização e captura aprofunda o modelo de cartão em hotelaria. Ele não redefine o Pix.

O que testar com uma reserva fictícia antes de abrir a tarifa?

Monte a reserva 4821 num ambiente de teste, com hóspede fictício e sem dados reais. Confirme que o sinal de R$ 360 só baixa SINAL-4821, que um webhook repetido não cria outro crédito e que o saldo segue em aberto. Pague o saldo de R$ 840 e verifique se a reserva mostra as duas obrigações quitadas, com identificadores diferentes.

Depois force os casos que o balcão vai encontrar. QR do sinal expirado sem pagamento. Pagamento de R$ 360 depois da expiração. Pagamento de R$ 1.200 na cobrança de R$ 360. Saldo confirmado com sinal ainda pendente. Cancelamento com sinal pago e saldo ainda cobrável. Devolução parcial de R$ 100. Em cada um, a tela deve permitir explicar o quarto, o valor recebido e o valor em tratamento sem usar uma única palavra “pago” para tudo.

Inclua o caminho em que o hóspede envia um comprovante e o webhook ainda não chegou. A reserva permanece na condição definida para “aguardando confirmação”. A chave não depende do anexo. Quando o evento válido chega, a baixa usa a cobrança, não a imagem.

Por fim, revise a copy. O texto oferecido ao hóspede deve dizer “sinal” e “saldo” quando forem duas cobranças, e só deve falar em Pix Automático se houver uma recorrência de verdade, com autorização explicada no fluxo do pagador. Uma tarifa de fim de semana não precisa dessa palavra.

Como a recepção e o financeiro dividem a mesma reserva?

A recepção decide se entrega a chave com base na condição comercial já satisfeita. O financeiro decide se o valor está reconhecido. Os dois olham a mesma reserva e não editam o status um do outro por telefone. Se a política permite check-in com sinal confirmado e saldo ainda aberto, a tela mostra exatamente isso: entrada autorizada pela casa e saldo pendente de R$ 840. Se a política exige pagamento integral, a chave espera o saldo confirmado, mesmo que o hóspede esteja no balcão com um print.

O atendimento responde com os identificadores. “Recebemos R$ 360 na cobrança do sinal da reserva 4821” é uma frase verificável. “Está tudo certo no Pix” não é. Quando houver exceção, o chamado registra a reserva, a obrigação, o valor alegado e a fonte ainda ausente. A pessoa seguinte continua a investigação sem reconstruir a conversa.

Essa divisão também protege a auditoria. Uma estadia com sinal retido por no-show precisa mostrar a regra aplicada e o Pix que permaneceu. Uma estadia com devolução precisa mostrar o movimento de volta. Nenhuma das duas fica correta só porque o quarto mudou de status no mapa de ocupação.

Perguntas frequentes

Pix Automático serve para cobrar o sinal de uma diária?

O sinal de uma reserva avulsa é uma cobrança dessa estadia. O Pix Automático, na descrição do Banco Central consultada para este texto, depende de autorização do pagador para instruções recorrentes. Use cobrança avulsa para o sinal e para o saldo. Recorra ao desenho de recorrência quando existir relação periódica e a modalidade estiver contratada. O passo a passo de autorização e cancelamento está no guia de Pix Automático para assinaturas.

Dois pagamentos da mesma reserva exigem recorrência?

Não pelo fato de serem dois. Sinal e saldo são duas obrigações com valores próprios. Cada uma tem cobrança, confirmação e, se for o caso, devolução. A recorrência entra quando o pagador autoriza débitos periódicos, como uma mensalidade, e não quando a mesma hospedagem foi dividida em duas parcelas combinadas.

Uma captura de tela libera a chave do quarto?

A captura mostra o que o hóspede acredita ter pago. A liberação da chave segue a condição comercial e a confirmação financeira da cobrança correspondente. Enquanto consulta ou webhook validado não associarem o valor à obrigação, a reserva continua no estado de espera que a casa definiu.

Cancelar a reserva devolve o Pix sozinho?

Cancelar a estadia altera a disponibilidade e abre a decisão comercial sobre o valor já recebido. A devolução, quando a regra mandar devolver, é um movimento adicional, com valor e confirmação ligados ao Pix original. Sem esse movimento confirmado, o cancelamento do quarto não é prova de que o dinheiro voltou.

Quem quiser o procedimento de antecipo e saldo para equipes que leem em espanhol encontra um guia próprio, com canonical independente, em Pix para reservas de hotel en Brasil. Ele não é tradução desta página. A referência de cobrança Pix na documentação pública da AZPay está na página de Pix da Dev Central.