Configurações - Pagamentos

O que é

A página de Pagamentos é o painel central onde a agência define como recebe das reservas feitas pelo site, pelo WhatsApp ou pelo balcão. Tudo o que o cliente vê no checkout - quais botões aparecem, em quantas parcelas pode pagar, se há QR Code PIX, se há dados bancários, se a reserva expira em 24 horas - é decidido aqui.

Você costuma chegar nesta página em três momentos: na configuração inicial da conta (item Pagamentos do Checklist de Configuração); ao trocar de meio de pagamento (por exemplo, sair de Mercado Pago para Asaas); ou ao revisar regras de cobrança (mudar prazo de pagamento, ativar Sinal + Saldo, ajustar taxas de parcelamento). A página tem quatro abas no topo: Meio de pagamento de Pagamento, PIX Direto, Transferência e Configurações.

Como usar

Ativar um meio de pagamento de pagamento

1. Vá em Configurações > Pagamentos no menu lateral.
2. A aba Meio de pagamento de Pagamento já abre selecionada. No bloco Meio de pagamento Ativo para Checkout, escolha o meio de pagamento que será usado: Mercado Pago, Asaas, PagSeguro/PagBank, Pagar.me, Valepay, InfinitePay ou Nenhum. Apenas um meio de pagamento pode estar ativo por vez.
3. Logo abaixo, na seção Configurar Meios de pagamento, clique no card do meio de pagamento escolhido para expandir o accordion. O card do meio de pagamento ativo aparece destacado com borda verde e o selo ATIVO.
4. Preencha as credenciais:
   • Em Mercado Pago, Pagar.me e PagSeguro/PagBank existem dois ambientes: Sandbox (testes) e Produção (real). Marque o ambiente e cole Public Key e Access Token (Mercado Pago), Secret Key e Public Key (Pagar.me) ou Email e Token (PagSeguro).
   • Em Asaas, informe a API Key do ambiente escolhido.
   • Em InfinitePay, basta colar o handle da conta (com ou sem $ ou @ - o sistema remove).
   • Em Valepay, é necessário Public Key, Secret Key e Company UUID por ambiente.
5. Em Mercado Pago, Pagar.me e PagSeguro/PagBank, clique em Testar Configuração dentro do card para validar as credenciais antes de salvar.
6. Clique em Salvar Configurações no rodapé. O badge do meio de pagamento na aba muda para Sandbox (amarelo) ou Produção (verde).

Habilitar PIX Direto com chave própria

1. Abra a aba PIX Direto (segunda aba do topo).
2. Ligue o toggle Habilitado ao lado do título.
3. Selecione o Tipo de Chave: CPF, CNPJ, E-mail, Telefone ou Chave Aleatória.
4. Informe a Chave PIX. O campo se adapta ao tipo: CPF/CNPJ com máscara, e-mail (até 77 caracteres), telefone com prefixo +55 (formato 5511999999999) ou UUID para chave aleatória. O sistema valida CPF/CNPJ com dígitos verificadores e DDD do telefone.
5. Preencha Nome do Beneficiário (máx 25 caracteres, aparece no PIX para o cliente) e Cidade (máx 15 caracteres, sem acentos).
6. Salve em Salvar Configurações.
7. Após salvar, com a chave válida e o toggle habilitado, o bloco Preview do QR Code aparece com o botão Gerar Preview, que monta um QR Code de exemplo no valor de R$ 10,00 para conferência visual.

Cadastrar dados bancários para transferência

1. Abra a aba Transferência (terceira aba do topo, ícone biblioteca).
2. Ligue o toggle Habilitado.
3. No campo Banco, digite o nome ou código e selecione no dropdown de autocomplete. O formato de Agência e Conta se ajusta ao banco escolhido (a busca é feita em /admin/configuracoes/pagamentos/bancos).
4. Escolha o Tipo de Conta: Corrente ou Poupança.
5. Preencha Agência, Conta, Titular e (opcional) Documento (CPF/CNPJ).
6. Salve. Pagamentos por transferência sempre exigem confirmação manual - não há webhook de banco.

Definir o modo de venda e as formas de pagamento do checkout

1. Abra a aba Configurações (quarta aba do topo, ícone engrenagem).
2. No bloco Modo de Venda, escolha entre:
   • Apenas Catálogo - site funciona como vitrine, sem botão de reserva nem WhatsApp.
   • Apenas WhatsApp - botão Reservar abre a conversa no WhatsApp; aceita apenas métodos manuais (PIX Direto, Cartão por Link, Transferência).
   • Apenas Venda Online - cliente reserva e paga direto no site; aceita apenas métodos automáticos (PIX/Cartão/Boleto via meio de pagamento).
   • Venda Online + WhatsApp (marcado como Recomendado) - libera todas as formas, manuais e automáticas.
3. Se escolher WhatsApp ou Online + WhatsApp, defina WhatsApp para Vendas: usar o número da empresa (recomendado, vindo de Configurações > Empresa) ou um número alternativo.
4. No bloco Formas de Pagamento no Checkout, ative os toggles das opções que o cliente verá. As opções disponíveis dependem do modo de venda escolhido (controlado pelo método validarMetodoPorModoVenda no controller): PIX Direto, PIX via {meio de pagamento ativo}, Cartão via {meio de pagamento ativo}, Cartão por Link, Boleto via {meio de pagamento ativo} ou TED/DOC Manual.
5. Se PIX Direto e PIX via Meio de pagamento estiverem ambos configurados no modo Online + WhatsApp, o toggle Permitir os dois tipos de PIX no checkout aparece - desligado por padrão (recomendação do sistema, para não confundir o cliente).
6. Quando o cliente tem meio de pagamento ativo + PIX habilitado, aparece o toggle Processar PIX automaticamente pelo meio de pagamento - quando ligado, o PIX Direto vira QR Code do meio de pagamento, com confirmação automática.
7. Clique em Salvar Configurações.

Definir prazos e regras de cobrança

1. Ainda na aba Configurações, role até Confirmação de Pagamentos. O toggle Confirmação Automática define se reservas pagas via meio de pagamento são aprovadas instantaneamente ou ficam Aguardando Confirmação para revisão manual. PIX Direto e Transferência sempre exigem confirmação manual, independente desse toggle.
2. No bloco Regras de Reserva, configure os prazos de cancelamento automático separados:
   • Prazo para pagamento online (meio de pagamento, cartão, boleto) - sugestões: 10 min, 30 min, 1h, 6h, 12h, 24h.
   • Prazo para pagamento manual (PIX Direto, transferência, cartão por link) - sugestões: 12h, 24h, 2 dias, 3 dias, 7 dias.
   • Cada prazo tem toggle próprio. Desligado = sem expiração automática (você cancela manualmente).
3. Ative Sugestão de pagamento mínimo para exibir orientação no checkout (informativo, o sistema não bloqueia valor menor). Escolha entre Percentual do valor ou Valor fixo e informe o número.
4. Dentro do bloco de sugestão de mínimo, marque Permitir pagar somente o sinal no checkout para liberar o fluxo Sinal + Saldo: cliente paga só o sinal agora; o saldo vira 2ª parcela no portal Minha Conta. Configure Vencimento do saldo (dias antes da viagem) - padrão 30 dias.
5. No bloco Taxas por Forma de Pagamento, ligue o toggle principal e configure:
   • Taxa no PIX - percentual único aplicado a PIX Direto e Meio de pagamento.
   • Taxa no Cartão de Crédito - percentual por número de parcelas (CET) e máximo de parcelas (1 a 12). Se o meio de pagamento ativo for Mercado Pago Checkout Pro, o formulário muda para o modo MDR: você define apenas a taxa 1x e o máximo de parcelas; o MP cobra os juros do comprador.
6. Salve em Salvar Configurações no rodapé.

Casos especiais

Modo Catálogo desliga o checkout inteiro

Quando o modo de venda fica em Apenas Catálogo, o bloco Formas de Pagamento exibe a mensagem "Modo Catálogo ativo" e nenhum método pode ser ativado. O backend ignora qualquer toggle salvo via validarMetodoPorModoVenda, que retorna false para o modo catalogo. Para liberar pagamentos, troque o modo primeiro e salve.

Trocar de meio de pagamento com pagamentos pendentes

Você pode trocar o Meio de pagamento Ativo para Checkout a qualquer momento. Pagamentos já em curso (reservas com PIX aberto, cartão aguardando aprovação) continuam sendo processados pelo meio de pagamento antigo até concluir ou expirar. Apenas as novas reservas passam a usar o meio de pagamento novo. Recomenda-se aguardar zerar os pendentes antes de remover credenciais antigas.

PagSeguro/PagBank e Valepay em "Em Breve"

Os meios de pagamento PagSeguro/PagBank e Valepay aparecem como Em Breve para a maioria das empresas - não ficam disponíveis no seletor nem no accordion. A liberação é feita caso-a-caso pela equipe Viagilize via array $gatewaysLiberadosPorTenant na view tab-gateways.blade.php (atualmente apenas você rotaazul tem InfinitePay, Pagar.me e Valepay liberados como teste).

PIX Direto com confirmação automática pelo meio de pagamento

Quando há meio de pagamento ativo + PIX Direto habilitado, o toggle Processar PIX automaticamente pelo meio de pagamento (na aba Configurações) faz o sistema gerar o QR Code via API do meio de pagamento em vez de usar a chave PIX salva. O resultado: PIX Direto e PIX Parcelado ganham confirmação e cancelamento automáticos, sem precisar conferir extrato no banco. Útil para quem tem InfinitePay/Mercado Pago configurado mas quer manter a aparência de "PIX da própria conta" no checkout.

Mercado Pago Checkout Pro vs. Transparente

Em Mercado Pago, o campo Modo define pro (Checkout Pro - redireciona para o MP, juros de parcelamento cobrados do comprador) ou transparente (cliente preenche cartão no próprio site, juros absorvidos pela agência). Quando o modo é Pro, o bloco Taxas troca o grid de 12 parcelas pelo formulário simplificado de MDR + máximo de parcelas.

Formato BACEN da chave PIX

A chave PIX é normalizada antes de salvar (método normalizePixChave): CPF/CNPJ só dígitos, telefone com prefixo + e código do país (+5511999999999), e-mail em minúsculas, UUID em minúsculas. A exibição no formulário reaplica a máscara via formatPixChave. Isso garante compatibilidade com o padrão do BACEN para EMV PIX Copia-e-Cola.

Erros comuns e como resolver

• "Selecione o banco." / "Informe a agência." / "Informe o número da conta." / "Informe o nome do titular." - Causa: o toggle de Dados Bancários ficou habilitado mas algum campo obrigatório está em branco. Solução: vá até a aba Transferência e preencha todos os campos marcados com asterisco, ou desligue o toggle se não quiser oferecer transferência.
• "Selecione o tipo de chave PIX." / "Informe a chave PIX." / "Informe o nome do beneficiário." - Causa: o toggle PIX Direto está habilitado sem dados. Solução: complete a configuração na aba PIX Direto ou desligue o toggle.
• "Preencha o Access Token antes de testar a conexão" (toast) - Causa: clicou em Testar Configuração no Mercado Pago/Pagar.me/PagSeguro sem colar a credencial do ambiente selecionado. Solução: cole o token/secret na linha do ambiente correto (Sandbox ou Produção) e tente de novo.
• "PIX não está configurado. Salve as configurações primeiro." - Causa: clicou em Gerar Preview antes de salvar a chave PIX. Solução: salve a configuração, recarregue a página e gere o preview.
• "Campos obrigatórios não preenchidos: ..." (toast vermelho ao salvar) - Causa: o JavaScript da página detectou campos vazios em abas que não estão sendo exibidas. Solução: o sistema navega automaticamente para a primeira aba com erro; corrija o campo apontado no toast e salve novamente.
• Status do meio de pagamento aparece "Erro" (vermelho) no badge - Causa: o Mercado Pago retornou falha de conexão na chamada testConnection do MercadoPagoService ao abrir a página. Solução: abra o card do Mercado Pago, confira as credenciais do ambiente ativo e clique em Testar Configuração para ver a mensagem do MP.
• Chave PIX marcada "✓ Válida" mas o QR Code não funciona - Causa: a chave existe no padrão correto, mas não está cadastrada no banco do beneficiário. Solução: confirme no internet banking que a chave PIX está realmente registrada na conta antes de habilitar.

Onde encontrar

• URL: /admin/configuracoes/pagamentos
• Caminho no menu: Configurações > Pagamentos
• Permissão necessária: ver as configurações para ver, editar as configurações para salvar/testar/gerar preview
• Módulo necessário: nenhum (faz parte do core)
• Rotas auxiliares: /admin/configuracoes/pagamentos/test-mercadopago, test-asaas, test-pagarme, test-pagseguro, test-infinitipay, test-valepay, preview-pix, bancos, bancos/{codigo}

Veja também

• Configurações do Sistema - visão geral de todas as áreas configuráveis da sua empresa.
• Dados da Empresa - o WhatsApp e o CNPJ usados aqui vêm de lá.
• Checklist de Configuração - marca Pagamentos como concluído após a primeira configuração.
• Integrações - Google Analytics e Pixel para acompanhar a conversão depois de habilitar o checkout.