Pular para o conteúdo
LojaVirtual.com.br Central de ajuda

Como configurar Pagar.me para Pix, cartão e boleto

A integração Pagar.me aceita Pix, cartão de crédito e boleto, conforme as modalidades habilitadas e as condições da sua conta.

Preencha a configuração

  1. Acesse Formas de pagamento > Pagar.me.
  2. Use o link Abrir painel do provedor na seção de chaves de acesso para abrir Chaves de autenticação da Conta Stone. O caminho manual é: Conta Stone → Nome no canto superior direito → Perfil → Chaves de autenticação. Nessa página, obtenha a chave pública e a chave secreta.
  3. Informe a chave pública e a chave secreta do mesmo ambiente.
  4. Ative as modalidades que deseja oferecer.
  5. Revise parcelamento, descontos específicos para Pix ou boleto e os campos adicionais disponíveis.
  6. Para boleto, confira tipo e instruções; salve e revise a apresentação no checkout.

Não misture uma chave de teste com outra de produção. A chave secreta deve ficar somente na configuração protegida do serviço.

Onde encontrar as chaves do Pagar.me

Abra Chaves de autenticação na Conta Stone. Para vendas reais, copie as chaves de produção: a chave pública começa com pk_ e a secreta com sk_. Chaves com pk_test_ e sk_test_ são de teste. Chaves antigas que começam com ak_ ou ek_ não servem neste formulário. O passo a passo completo também está em Como configurar?, na lista de Formas de pagamento e no topo da configuração.

Confira o valor final e a aprovação

Descontos configurados para uma modalidade devem ser conferidos no total final da compra. Os descontos de promoções têm regras próprias; não prometa acumulação sem conferir o resultado apresentado.

Gerar Pix ou boleto não confirma recebimento. A atualização do pedido depende da confirmação válida do pagamento. Em caso de pendência, confira a transação antes de orientar o cliente a pagar novamente. Para cartões, revise também a disponibilidade de parcelas e as condições da conta.

Teste as credenciais salvas

Depois de salvar, use Testar conexão. O teste consulta a API sem criar pagamento e usa somente os dados já gravados; alterações ainda digitadas no formulário não são enviadas. Ao ativar um cadastro inativo, a plataforma também verifica o acesso antes de habilitá-lo. Se houver falha, confira as credenciais ou tente novamente mais tarde.

Esse teste não comprova a tokenização do cartão nem a liberação de todos os meios pela sua conta. O checkout oferece até 12 parcelas sem juros, respeitando o limite e o valor mínimo configurados.

Cancelamento e estorno

Esta integração ainda não oferece o comando de estorno no detalhe do pedido. Solicite a operação no painel do provedor, quando disponível, e acompanhe a conciliação. Alterar o status comercial do pedido não devolve dinheiro automaticamente.

Veja também configuração de pagamentos e acompanhamento de pedidos.

Conexão, disponibilidade e salvamento

A tela separa a situação da conexão da ativação escolhida para a loja. Use Salvar alterações após editar e confira a confirmação. Para entender as chaves protegidas, a substituição e os estados apresentados, veja como usar a configuração dos provedores.

Assista ao passo a passo