Reservas - Confirmar Reserva e Pagamentos

O que é

Esta página reúne três ações de aprovação manual disponíveis no módulo de Reservas: confirmar uma reserva pendente, confirmar (ou rejeitar) um pagamento que está aguardando aprovação manual e reativar uma reserva cancelada. Todas elas vivem em telas distintas do admin, mas resolvem o mesmo problema: forçar manualmente uma transição de status quando o fluxo automático não cobre o caso.

O atendente costuma chegar aqui em duas situações: ao receber o pagamento por fora do meio de pagamento (PIX direto, dinheiro, transferência) e precisar liberar a vaga manualmente, ou quando precisa desfazer um cancelamento feito por engano. O acesso direto à fila de aprovações fica em "/admin/reservas/pagamentos-aguardando" e também aparece como banner laranja no topo de "/admin/reservas" sempre que houver pagamentos parados.

Como usar

Confirmar uma reserva pendente manualmente

1. Vá em Reservas no sidebar e abra a reserva desejada ("/admin/reservas/{passageiro}").
2. No cabeçalho do pedido, abra o dropdown Ações (ao lado do título "Pedido #...").
3. Clique em Confirmar Reserva. A opção só aparece quando o status atual é Pendente.
4. Confira o modal de confirmação. Se houver saldo em aberto, um alerta amarelo mostra o valor pendente em destaque.
5. Confirme em Confirmar Reserva no rodapé do modal. O status muda para Confirmado e o cliente recebe a notificação por e-mail.

Confirmar um pagamento aguardando aprovação

1. Em "/admin/reservas", clique no banner laranja "X pagamentos aguardando confirmação" quando ele aparecer, ou acesse direto "/admin/reservas/pagamentos-aguardando".
2. Localize o pagamento na tabela. Cada linha mostra o ID do pagamento, cliente, excursão, valor, origem (meio de pagamento/forma) e data.
3. Clique no botão verde Confirmar na coluna Ações.
4. Confirme no modal global que abre ("Confirmar este pagamento? A reserva será transformada em ... confirmada.").
5. O pagamento é marcado como confirmado, o registro de quem aprovou é gravado e a reserva é atualizada conforme o saldo restante.

Rejeitar um pagamento aguardando aprovação

1. Na mesma tela Pagamentos Aguardando Confirmação, clique no botão vermelho contornado Rejeitar na linha do pagamento.
2. Preencha o campo Motivo da rejeição (obrigatório, até 500 caracteres) no modal que abre.
3. Confirme em Rejeitar Pagamento. O pagamento muda para o status Cancelado e o motivo é anexado à observação do registro.

Reativar uma reserva cancelada

1. Abra a reserva cancelada em "/admin/reservas/{passageiro}" (use o filtro Status = Cancelado na listagem para encontrá-la).
2. No dropdown Ações do cabeçalho, clique na primeira opção, Reativar Reserva (Pendente).
3. Confirme no diálogo "Tem certeza que deseja reativar esta reserva? Ela voltará para o status Pendente." em Reativar.
4. A reserva volta para Pendente, o financeiro é reaberto (sem o flag de cancelado) e, se o pedido também estava cancelado, ele volta para Pendente.

Casos especiais

Reserva pendente com saldo em aberto

Confirmar reserva não quita valores. O modal exibe um aviso amarelo com o valor pendente e lembra que, após confirmar, é necessário registrar o pagamento manualmente caso o cliente já tenha pago por outro meio. A reserva fica confirmada mesmo assim - use o módulo de pagamentos para regularizar o financeiro depois.

Confirmação manual habilitada nas configurações

A página Pagamentos Aguardando só recebe entradas quando você tem a confirmação manual ativada nas configurações de pagamento. Sem isso, o meio de pagamento confirma automaticamente e o banner laranja nunca aparece em "/admin/reservas".

Reativar reserva soft-deleted

Quando a reserva cancelada também foi excluída da listagem (soft delete), a rota de reativação faz restore() antes de mudar o status. Por isso a rota de reativação é registrada com withTrashed() - é possível reativar mesmo reservas que sumiram dos filtros padrão.

Pagamento já processado

Se outro atendente já confirmou ou rejeitou o pagamento, a ação devolve o erro "Este pagamento não está aguardando confirmação." (no Confirmar) ou "Este pagamento não pode ser rejeitado." (no Rejeitar). Atualize a página para ver o status atual.

Erros comuns e como resolver

• "Esta reserva não pode ser confirmada." - Causa: a reserva não está no status Pendente (já foi confirmada, cancelada, transferida ou marcada como no-show). Solução: verifique o status atual no cabeçalho; se estiver cancelada, use Reativar Reserva antes.
• "Apenas reservas canceladas podem ser reativadas." - Causa: tentou reativar uma reserva que não está cancelada. Solução: a opção Reativar Reserva (Pendente) só aparece quando o status é Cancelado; nenhum outro status precisa de reativação.
• "Este pagamento não está aguardando confirmação." - Causa: o pagamento já mudou de estado (foi confirmado, rejeitado ou cancelado por outro usuário/meio de pagamento). Solução: atualize a página "/admin/reservas/pagamentos-aguardando" e revise a coluna Status do pagamento na reserva.
• "Este pagamento não pode ser rejeitado." - Causa: tentativa de rejeitar pagamento fora do estado Aguardando Confirmação. Solução: o pagamento já saiu da fila; se precisar estornar, use o estorno do módulo financeiro.
• Validação do motivo na rejeição - Causa: o campo Motivo da rejeição é obrigatório (mínimo 1 caractere, máximo 500). Solução: descreva sucintamente o motivo no modal antes de enviar.

Onde encontrar

• URL principal (listagem): /admin/reservas
• URL da fila de pagamentos: /admin/reservas/pagamentos-aguardando
• URL do detalhe de uma reserva: "/admin/reservas/{passageiro}"
• Caminho no menu: Reservas (item fixo do sidebar)
• Permissões necessárias: ver as reservas para abrir e editar as reservas para executar Confirmar, Reativar, Confirmar Pagamento ou Rejeitar Pagamento
• Módulo necessário: nenhum

Veja também

• Lista de Reservas
• Detalhes da Reserva
• Pagamentos da Reserva
• Cancelar Reserva
• Status da Reserva