Conectores de Pagamento - Como configurar o Conector Pagar.me 2.0 no Admin

A configuração do Pagar.me 2.0 é feita no Admin em 4 etapas:

1ª Etapa: Formas de Pagamento;
2ª Etapa: Antifraude;
3ª Etapa: Configurar Webhook;
4ª Etapa: Grupos de Pagamento e Parcelamentos.

Confira o passo a passo das configurações dentro das suas respectivas etapas.

1ª Etapa - Formas de Pagamento

No painel administrativo da plataforma acesse o menu Pagamentos >> Conectores de Pagamento >> PagarMe 2.0 >> "Adicionar Configuração".

Cadastre um nome para a configuração e selecione o seu tipo: Transparente (cartão), PIX ou Boleto.

Em seguida, cadastre a "Public Key (Chave Pública)" e a "Private Key (Chave Secreta)" da loja, copiadas do painel da Pagarme 2.0.

Observação: Informamos que, para garantir a segurança das suas informações, os campos de chaves sensíveis serão agora mascarados em nosso sistema. Essa medida reforça a proteção contra acessos não autorizados e mantém suas integrações ainda mais seguras.

Boleto

Ele abrirá um pop-up inicial, para as primeiras configurações do seu método de pagamento:

Inserir o nome da configuração, por exemplo “Boleto” e clique em salvar.

Após salvar, a tela abrirá os campos seguintes para inserir o prazo de vencimento do boleto e o prazo para cancelamento, em seguida, clique em “Fechar”:

A tela seguinte ficará dessa forma, para que seja inserida as chaves fornecidas pelo Pagar.me, inserindo as chaves, clique em “Salvar”, as chaves ficarão com este formato criptografado:

No caso de boleto, será necessário cadastrar também o código do banco gerador, que é repassado pelo banco emissor, além do prazo de vencimento, que será a data refletida no boleto, e o prazo de cancelamento automático do pedido, caso o pagamento não seja identificado. O prazo de cancelamento deve sempre ser superior ao prazo de vencimento.

O prazo de vencimento indica quando o boleto vence, mas isso não resulta no cancelamento imediato do boleto. Por exemplo: vencimento em 5 dias + cancelamento em 2 dias. A plataforma sempre adiciona mais 1 dia ao prazo de cancelamento, totalizando 8 dias para que o pedido seja cancelado na plataforma.

A chave "Sandbox", por padrão, deve permanecer desativada, pois é utilizada apenas em modo de teste.

O campo Instruções você pode editar como preferir.

Cartão de crédito

Para a opção de Cartão de Crédito (Transparente), cadastre a "Public Key (Chave Pública)" e a "Private Key (Chave Secreta)".

O "Merchant Category Code" e "Payment Method Code" devem ser preenchidos com “zero”, a "Descrição", pode ser preenchido o nome da Loja, da forma que desejar que conste na fatura do cliente, desde que esse recurso seja compatível com a adquirente utilizada.

Para utilizar a ClearSale, selecione-a no campo 'Antifraude’

Caso sua loja deseje utilizar a autenticação 3D Secure (3DS) nas transações de cartão de crédito, é necessário ativar a opção "Autenticação 3Ds" nas configurações do conector de pagamento. Uma vez ativa, o sistema passará a solicitar a autenticação do cliente junto ao banco emissor do cartão, adicionando uma camada extra de segurança ao processo de pagamento.

Pontos importantes:

• A Fetaure é válida somente para Pagarme Hub
• É necessário solicitar a ativação da feature dentro da Pagame via chamado
• Após a ativação de feature é necessário a atualização do seu App no Hub Pagar.me, para maiores informações acesse a documentação do parceiro
• Feature compativél com dois cartões Pagarme hub
• Feature compatível com o checkout 1.0 e 2.0

Antifraude

Todos os clientes do Pagar.me possuem o Antifraude Pagar.Me ativados por default em sua conta Pagar.me, podendo desabilitar a qualquer momento para utilizar com outro Antifraude do Mercado, como a Clearsale. Neste caso, a loja deverá desabilitar a funcionalidade no Pagar.me e configurar na Wake seguindo a orientação abaixo.

Se a loja não utilizar a ClearSale para a análise dos pedidos, esta etapa pode ser ignorada.

Se sim, existem duas configurações de acordo com a modalidade da ClearSale contratada:

• Aprovação automática: preencher o Código de App (opcional) e Chave (obrigatório) fornecidos pelo ClearSale. A chave Manual deve ficar inativa;
• Aprovação manual: preencher o Código de App (opcional) e Chave (obrigatório) fornecidos pelo ClearSale. A chave Manual deve ficar ativa.

No painel administrativo acesse o menu Pagamentos >> Antifraude.

Lembrando que:

• Aprovação automática: a ClearSale fará a análise e retornará a aprovação ou cancelamento do pedido. Quando aprovado, o pedido seguirá o fluxo de pagamento até retornar com o status de Pago;
• Aprovação manual: o lojista deverá acessar o painel da ClearSale e aprovar ou reprovar a análise. Se aprovado, o pedido seguirá o fluxo de pagamento. Se reprovado, será cancelado na plataforma. 

Em casos de recusa pelo antifraude da Clearsale, a Wake disponibiliza uma request para garantir que o pedido seja cancelado na Pagarme. Essa funcionalidade assegura que os pedidos rejeitados sejam cancelados de forma eficaz em ambas as plataformas, evitando complicações futuras e mantendo a integridade das operações financeiras.

Pix

Para a opção PIX, será necessário entrar em contato com o Pagarme, solicitando a liberação para este meio de pagamento.

Cadastre a "Public Key (Chave Pública)" e a "Private Key (Chave Secreta)".

O campo "Minutos Expiração QRCode", é o tempo em minutos em que o QR Code ficará válido para pagamento neste campo é permitido o máximo de 5 caracteres.
O campo "Descrição" é referente ao texto que será exibido ao ler o QR Code no aplicativo que fará o pagamento.

Após clicar em salvar vai apresentar uma tela com a opção integrar ou fechar, você irá clicar em Fechar.

Ajuste de layout

A configuração do Pix necessita de alguns ajustes de Layout, uma delas é a exibição do botão "Copiar Código", que está no código-fonte da página de Fechamento, por padrão, vem configurado como display:none

Como são ajustes mais técnicos que necessitam de profissionais especializados, sugerimos que verifique com a sua agência esse e outros ajustes de layout necessários para que a experiência de pagamento com PIX seja completa.

E-mail transacional

Disponibilizamos algumas tags para enviar os dados do PIX nos e-mails transacionais, confira qual tag utilizar no artigo Como editar os e-mails transacionais.

Atenção: informamos que caso a imagem do QR Code seja no formato svg, o Gmail não exibirá pois esse formato não é suportado pelo Gmail.

Exibição do QRCode para pagamento no Minha Conta

Por padrão, a exibição do QR Code vem desabilitada. Saiba como ajustar acessando o artigo Detalhes do Minha Conta.

Finalizado os passos necessários, vamos para a configuração no painel administrativo.

Ainda no menu de Pagamento >> Conectores de Pagamento F-Gateway >> Pagar.me 2.0 >> "Adicionar Configuração", selecione a opção PIX e preencha os seguintes campos:

• Nome da configuração: nome utilizado para a Configuração do PIX;
• PublicKey: utilize o mesmo token da configuração do Cartão;
• PrivateKey: utilize o mesmo token da configuração do Cartão;
• Minutos Expiração QRCode: para informar os minutos que o código Pix deve expirar;
• Descrição: Descrição que será exibida ao ler o QRCode com no máximo 50 caracteres (Ex. Nome da loja)
• Editor Html: campo destinado a receber as informações que serão apresentadas no fechamento, logo pode ser adicionado o conteúdo de sua preferência. 

3ª Etapa - Configurando Webhook

Para que os status dos pedidos sejam atualizados conforme notificação de pagamento, é necessário que seja configurado o Webhook via painel Pagar.Me.

Realize a configuração acessando o menu Configurações >> Webhooks >> Criar Webhook,em seguira, cadastre a URL (https://gateway-postback.fbits.net/api/PagarMeV5), preencha o campo "Número Máximo de Tentativas" com "1" e habilite todos os eventos relacionados à Cobrança.

Feito isso, basta salvar as alterações e os status serão atualizados conforme notificação de pagamento.

4ª Etapa - Grupos de Pagamento e Parcelamentos

Após as primeiras configurações, você deverá clicar em Grupos e Parcelamentos >> Parcelamentos e seguir o passo a passo completo no artigo Grupos e Pagamentos.

Recomendações gerais

• Realize um pedido teste com um cartão válido para verificar se o pagamento transacionará corretamente no Pagar.Me 2.0;
• Faça um pedido teste com Boleto Pagar.Me 2.0, para verificar se o boleto será gerado corretamente, caso vá utilizar esta forma de pagamento;
• Faça um pedido teste com PIX PagarMe 2.0, para verificar se o QR Code será gerado corretamente, caso vá utilizar esta forma de pagamento;
• Ao tentar realizar o pedido, o sistema de segurança da plataforma poderá bloquear as URLs externas do Pagar.Me. Para orientações sobre o desbloqueio, confira o conteúdo  Gerenciar Políticas de Segurança.

Atenção: cancelar os pedidos manualmente na plataforma não estorna os pagamentos no PagarMe. Ou seja, você deverá cancelar os pedidos também no painel do Pagar.Me para que os pagamentos sejam realmente cancelados, nessas situações.

Para informações sobre Split de Pagamento do Pagar.Me 2.0, clique aqui.