Como configurar as formas de pagamento da loja
Em Formas de pagamento, configure os serviços e as modalidades que sua loja aceita. A disponibilidade para o comprador depende de a opção estar ativa, visível e compatível com aquela compra.
Em Primeiros passos, a etapa de recebimento acompanha a configuração salva. Ela fica concluída com uma forma de pagamento configurada, ativa e disponível para os compradores. Se a última for desativada, a etapa volta a ficar pendente.
Como começar a receber
O destaque inicial é Pix com confirmação manual, quando disponível para a loja. Os demais serviços ficam em Outras formas de pagamento, que já abre quando algum desses serviços está ativo na loja e fica fechado nos demais casos. Abrir ou recolher o grupo não altera os cadastros nem sua ativação. O nome antigo desse grupo era Configurações avançadas; nenhum conhecimento técnico é necessário para usá-lo.
Passo a passo dentro do painel: Como configurar?
No cartão do serviço, o botão roxo com o ícone de ajustes abre a configuração quando disponível. Use Ver vídeo, com o ícone de reprodução, para assistir ao tutorial. Em Pix manual e depósito, escolha Como cadastrar a chave Pix ou Como cadastrar a conta. Feche o vídeo para continuar no mesmo ponto ou abra o link para a transcrição na Central de ajuda.
Cada forma de pagamento da lista tem a ação Como configurar?, ao lado de Configurar ou Editar. Ela abre um painel lateral com o passo a passo daquele serviço, sem alterar nada na loja e mesmo antes de você configurar. O mesmo tutorial aparece no topo da tela de configuração, recolhido inclusive no primeiro cadastro. Abra o passo a passo para consultá-lo enquanto preenche os campos.
- Antes de começar: o tipo de conta e o que você precisa ter em mãos.
- Passo a passo: onde encontrar cada informação no serviço de pagamento e em qual campo da LojaVirtual colar, destacado em Na LojaVirtual.
- Como conferir se ficou pronto: o que a tela consegue confirmar e o que depende da conta no fornecedor, além do significado de cada situação.
- Não conseguiu configurar?: problemas comuns, o link para o guia desta Central, a documentação oficial do fornecedor e o suporte pelo WhatsApp.
Nos campos de credenciais, um texto curto abaixo do campo indica onde encontrar a informação. Quando o serviço não oferece teste remoto, como PicPay e PagHiper, a tela avisa que salvar confere somente o formato dos dados. Se o plano não incluir o serviço, o tutorial continua disponível para leitura, mas não oferece a configuração.
Como começar pelo Pix manual
O selo Mais rápido para começar destaca o cadastro da chave Pix sem precisar de conta em gateway. Confira o dinheiro na sua conta antes de confirmar manualmente o pagamento do pedido.
Use Configurar Pix manual no primeiro cadastro ou Gerenciar Pix e depósitos quando já houver contas. Ver cadastros permite conferir os registros existentes, sem duplicá-los na lista avançada. O destaque respeita disponibilidade e plano. Veja como cadastrar e conferir o Pix manual.
Como encontrar e configurar um serviço
Abra Outras formas de pagamento para encontrar os demais serviços, separados em Pagamentos automáticos e Confirmação manual. A tela apresenta os serviços diretamente, sem filtros por serviço ou meio e sem contagem de resultados. Cada serviço mantém logo ou ícone, descrição, meios suportados, situação e ações.
Prefere Pix automático, cartão ou boleto? Configure um serviço compatível neste grupo. No PagBank, o selo Conexão sem chaves de API identifica a autorização pelo provedor. Os meios suportados indicam a capacidade da integração; disponibilidade para cobrar depende da conta e da configuração.
- Não configurada: ainda não há cadastro salvo. Use Configurar para o primeiro cadastro. No PagBank, Conectar conta abre a tela onde você inicia a autorização.
- Complete a configuração: abra Completar configuração para revisar os dados e a situação. Esse aviso local não significa recusa financeira.
- Desativada na loja: existe uma configuração salva, mas a forma não aparece para os compradores. Use Editar ou o interruptor de ativação quando disponível.
- Ativa na loja: indica a ativação local. Não significa conta aprovada pelo provedor nem que todas as modalidades estarão disponíveis para qualquer compra.
- Restrita pelo plano: confira Ver planos. Havendo cadastro existente, Ver situação permite consultar o estado salvo, sem abrir o formulário de alteração.
- Indisponível: o serviço não oferece ações para configurar ou ativar. Se houver cadastro existente e permissão, Ver situação permite consultar o estado salvo.
Ativar ou desativar exige um clique explícito. Aguarde a resposta: a tela usa a situação devolvida pelo servidor. Se a operação falhar, a lista é consultada novamente; se essa consulta também falhar, use Atualizar antes de tentar outra alteração. Nos cadastros manuais, um salvamento ou uma exclusão confirmados também atualizam a situação da lista e liberam os interruptores.
Para pagamento personalizado e outros cadastros manuais da lista, use Configurar no primeiro cadastro ou Gerenciar cadastros quando já houver registros. Ver cadastros expande a lista de contas, com indicação de ativo ou inativo. É possível abrir pelo teclado com Tab e Enter. Cada cadastro é administrado individualmente, sem um interruptor único para todo o serviço.
Entenda a tela de configuração de cada provedor
Mercado Pago, Pagar.me, PicPay, PagBank, Vindi e PagHiper compartilham a mesma organização: Situação da conexão, Disponibilidade, Meios aceitos, condições comerciais, Chaves de acesso ou Conexão com a conta e Configurações avançadas. Cada serviço mostra apenas os campos atendidos pela integração.
Ativo na loja representa sua escolha de ativação. Se faltarem credenciais ou autorização, a tela informa Ativação selecionada. Conclua a configuração para disponibilizar o pagamento. A escolha não comprova acesso válido, liberação dos meios ou recebimento de dinheiro. Desativar voluntariamente também não significa que a conexão falhou.
As credenciais cadastradas aparecem protegidas. Clique em Substituir chaves para editar; os campos começam vazios e não revelam os segredos antigos. Deixe vazio para manter o valor salvo. Cancelar substituição descarta somente a edição das credenciais, preservando outras alterações. Se o salvamento falhar, confira o erro e corrija os campos antes de tentar novamente.
Salvar alterações permanece visível, desabilitado enquanto não houver mudanças. Durante o envio, aguarde a resposta para evitar duplicidade. Ao rolar uma página com alterações pendentes, aparece um atalho de salvamento. A tela pede confirmação ao sair com mudanças não salvas. Após salvar, confira a confirmação e, quando disponível, use Testar conexão.
Mercado Pago, Pagar.me, Vindi e PagBank oferecem teste com as credenciais salvas. PicPay e PagHiper não oferecem esse teste nesta tela: confira a conta e as permissões no painel correspondente. Chaves cadastradas não aparecem como Conexão verificada sem uma resposta positiva do teste. A última tentativa de cobrança do PagBank continua separada da verificação de acesso.
O PicPay apresenta somente a carteira digital, controlada pela disponibilidade do serviço. Parcelamento aparece apenas nos provedores que o atendem; ao desligar cartão, as condições permanecem preservadas. Depósito/Pix manual e pagamento personalizado mantêm seus cadastros individuais.
Configurar, conectar, salvar e ativar
Na lista e na configuração, as logos aparecem em espaços padronizados sobre fundo branco, junto ao nome de cada serviço. Confira a indicação de situação para saber se a forma está ativa: a presença da logo, sozinha, não confirma ativação nem conexão.
- Chaves de acesso: nos serviços que usam chaves, informe os dados da sua conta. Deixe os campos vazios para manter as credenciais existentes. Se novas credenciais não puderem ser gravadas, o aviso permanece e os ajustes permitidos continuam disponíveis.
- Autorização: somente no PagBank, use a conexão externa apresentada na tela. Uma conta conectada tem autorização válida, mas isso não comprova liberação para cobranças. Se aparecer Autorização expirada, use Reconectar conta. Tokens individuais anteriores permanecem preservados; para trocar essa conexão, contate o suporte. A autorização validada pelo PagBank já ativa a forma na loja conforme o fluxo existente, inclusive ao reconectar.
- Modalidades e regras: escolha apenas os meios disponíveis para sua conta. Com o cartão ligado, Parcelamento no cartão aparece diretamente na tela, com máximo de parcelas, parcela mínima e condições de juros. Descontos e condições de boleto ficam em Configurações avançadas dos meios. Limites, tipo de pessoa, adicionais e instruções ficam em Configurações avançadas; prioridade e nome aparecem em Exibição no checkout dentro desse mesmo grupo. Recolher um grupo não muda seus valores salvos. Nas formas manuais, confira os dados do recebedor; adicionais, prioridade e instruções ficam em Configurações avançadas. Se um ajuste recolhido tiver erro, o grupo abre para você corrigir.
- Salvar: confira a escolha de ativação e salve o formulário. Alterar o interruptor no detalhe só aplica a escolha ao salvar. Configuração salva confirma o registro dos dados; confira separadamente a indicação Ativa na loja. Não há salvamento parcial ou automático durante a edição.
- Após salvar uma forma de pagamento ou alterar a ativação pela lista, o painel consulta novamente o progresso real da loja. Se ainda faltar alguma configuração, a confirmação mostra Voltar aos Primeiros passos para você escolher a próxima etapa. Ao cadastrar o primeiro Pix manual, o botão aparece também quando essa era a última etapa. A assinatura é tratada separadamente. Para configurar outro meio, use Voltar à lista no detalhe da forma de pagamento.
O que o teste de acesso confirma?
Nos serviços que oferecem Testar conexão, o teste é uma ação explícita e não financeira: verifica acesso com os dados já salvos. Não cria cobrança e não comprova aprovação cadastral, recebimento, tokenização do cartão ou liberação dos meios. Se o acesso falhar, confira as instruções, corrija os dados ou a autorização e tente novamente. No PagBank, os diagnósticos da última tentativa de cobrança continuam separados do teste de acesso.
Não compartilhe tokens ou chaves secretas em páginas, descrições de produto ou atendimento público.
Modalidades atendidas
| Serviço | Modalidades nesta integração |
|---|---|
| Vindi Pagamentos | Pix e cartão no checkout seguro da Vindi Commerce |
| Mercado Pago | Pix e cartão |
| Pagar.me | Pix, cartão e boleto |
| PagBank | Pix, cartão e boleto |
| PagHiper | Boleto |
| PicPay | Carteira PicPay para pessoa física |
| Depósito ou Pix manual | Recebimento com confirmação pelo lojista |
| Personalizado | Instruções e confirmação manual |
Por que uma opção não aparece?
Confira ativação, exibição, credenciais, valor da compra, CPF/CNPJ permitido e modalidade habilitada. Uma conta conectada não torna todas as modalidades possíveis automaticamente. Taxas e condições da conta devem ser verificadas no serviço contratado; não são definidas por este guia.
Para exibir os meios aceitos na página inicial e no produto, veja formas de pagamento e envio na vitrine. A lista de meios aceitos não depende de ter desconto; parcelamento e valores exigem condições compatíveis com a compra.
Confira também Pix integrado e Pix manual, os diagnósticos PagBank e a configuração inicial da loja.
Receber pelas vendas e assinatura da plataforma
Os recebimentos dos compradores e a assinatura da plataforma são configurações separadas. Pagar a assinatura não conclui a configuração de recebimento. Os primeiros passos consultam se existe uma forma ativa e finalizada; desativá-la pode reabrir essa pendência.
Configuração salva não comprova credenciais válidas nem aprovação de transação. Pagamento pendente ou recusado continua com seu estado correspondente. Não é necessário fazer uma compra real para concluir a configuração inicial; quando precisar validar uma transação, use uma loja e credenciais próprias de teste do serviço.
Como mostrar o valor das parcelas no produto
Ao configurar um novo pagamento com cartão, o máximo já vem preenchido em 3 parcelas. Você pode salvar esse limite ou escolher outro, até 12. Cadastros existentes conservam suas condições, inclusive ao desativar e reativar o cartão. O padrão de 3x é apenas o limite inicial: não ativa 3x sem juros na conta do provedor.
No Mercado Pago e na Vindi, o campo de parcelas sem juros é opcional. Deixe vazio se ainda não confirmou essa condição; nesse caso a página informa o máximo, sem anunciar o valor da parcela. Ao informar a quantidade sem juros já habilitada, o sistema calcula os valores automaticamente para todos os produtos, sem preencher cada produto.
O Pagar.me usa as condições de cartão suportadas pelo checkout. O PagBank usa quem assume os juros e o limite inclusivo sem acréscimo. No Mercado Pago e na Vindi, confira a quantidade sem juros na conta do provedor e informe Parcelas sem juros já habilitadas na conta, em Parcelamento no cartão, logo abaixo dos meios aceitos. Não confunda esse campo com o máximo de parcelas.
Os cálculos aparecem nos vinte temas oficiais e acompanham o preço da variação e a parcela mínima, sem consulta externa a cada visita. Pix, boleto e carteira PicPay não recebem uma divisão fictícia em parcelas. Veja o passo a passo de Mercado Pago e Vindi. O cadastro não sincroniza automaticamente alterações nas contas externas.