Primeiros Passos - Configurar Pagamentos

O que é

Este é o roteiro curto para deixar o Viagilize pronto para receber a primeira venda. A página Configurações > Pagamentos concentra o meio de pagamento ativo (Mercado Pago, Asaas, Pagar.me, InfinitePay, Valepay ou PagBank), o PIX Direto com chave própria, os dados bancários para transferência e as regras gerais de cobrança.

Neste guia o foco é só o mínimo necessário para sair do zero: escolher o modo de venda, conectar um meio de pagamento em sandbox, testar e virar a chave para produção. Os ajustes avançados (taxas, parcelamento, sinal + saldo, confirmação automática, PIX manual, transferência bancária) estão explicados no artigo completo Configurações - Pagamentos.

Como usar

1. Vá em Configurações > Pagamentos no sidebar.
2. Abra a aba Configurações (última do menu superior) e escolha o Modo de Venda que combina com o seu fluxo:
   • Catálogo - só vitrine, sem checkout. Nenhum método de pagamento pode ser ativado.
   • Online - checkout completo via meio de pagamento (PIX/cartão/boleto automáticos).
   • WhatsApp - venda manual, libera apenas métodos manuais (PIX Direto, cartão por link, transferência).
   • Ambos - libera tudo, online e WhatsApp na mesma operação.
3. Volte para a aba Meio de pagamento de Pagamento (primeira aba, com badge mostrando o status atual).
4. Marque um meio de pagamento como ativo para o checkout (Mercado Pago é o padrão recomendado para iniciar) e expanda o card dele.
5. Mantenha Sandbox ligado, cole as credenciais de teste e clique em Testar Configuração ao lado dos campos. Aguarde o toast verde de sucesso.
6. Clique em Salvar Configurações (botão azul no rodapé).
7. Faça uma reserva de teste pelo site para confirmar que o pagamento gera corretamente.
8. Volte na mesma página, desmarque Sandbox no card do meio de pagamento, cole as credenciais de produção, teste novamente e salve.

Casos especiais

Quero vender só pelo WhatsApp (sem checkout online)

Em Modo de Venda, escolha WhatsApp e preencha o número em WhatsApp de Vendas. Não precisa configurar nenhum meio de pagamento agora; basta ligar o PIX Direto (aba PIX Direto) com a chave da agência ou os Dados Bancários (aba Transferência) para enviar manualmente ao cliente.

Não tenho conta no meio de pagamento ainda

Crie a conta direto no site do provedor (Mercado Pago, Asaas, Pagar.me ou InfinitePay) e gere as credenciais de Sandbox. O cadastro é gratuito e permite testar antes de assinar plano ou liberar produção. O artigo Integrações - Meios de pagamento de Pagamento lista quais credenciais cada um pede (Access Token, API Key, Secret Key, Handle).

Quero usar PIX da agência sem meio de pagamento

Use a aba PIX Direto: marque Habilitar PIX Direto, escolha o Tipo de Chave (CPF, CNPJ, Email, Telefone ou Aleatória), informe a chave e o Nome do Beneficiário. O cliente paga via QR Code próprio, mas a confirmação fica manual - o operador precisa marcar como pago no admin.

Erros comuns e como resolver

• "Preencha o Access Token antes de testar a conexão" - Causa: o campo Access Token (ou Secret Key/Token) do meio de pagamento está vazio no ambiente selecionado. Solução: cole a credencial correspondente ao ambiente (sandbox ou produção) antes de clicar em Testar Configuração.
• Badge "Erro" vermelho no card do Mercado Pago - Causa: o token salvo está inválido ou expirou. Solução: gere um novo Access Token no painel do Mercado Pago, cole novamente, teste e salve.
• "Corrija os erros abaixo: Selecione o tipo de chave PIX / Informe a chave PIX / Informe o nome do beneficiário" - Causa: PIX Direto ficou marcado como habilitado sem preencher os obrigatórios. Solução: abra a aba PIX Direto e complete os três campos, ou desmarque o toggle se ainda não pretende usar.
• "Campos obrigatórios não preenchidos: Transferência: Banco, Agência, Conta, Titular da Conta" - Causa: o toggle de dados bancários ficou ligado sem cadastro completo. Solução: abra a aba Transferência e preencha banco, agência, conta e titular, ou desligue o toggle.

Onde encontrar

• URL: /admin/configuracoes/pagamentos
• Caminho no menu: Configurações > Pagamentos
• Permissão necessária: ver as configurações e editar as configurações
• Módulo necessário: nenhum

Veja também

• Bem-vindo ao Viagilize
• Configurar Dados da Empresa
• Configurações - Pagamentos (guia completo)
• Integrações - Meios de pagamento de Pagamento