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. Informe a chave pública e a chave secreta do mesmo ambiente.
  3. Ative as modalidades que deseja oferecer.
  4. Revise parcelamento, descontos específicos para Pix ou boleto e os campos adicionais disponíveis.
  5. 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.

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 credenciais salvas. 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.