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

---

Lembre-se: Caso você esteja utilizando a versão 1.0 do Pagar.me e precise realizar a migração para a versão 2.0, é necessário seguir um procedimento específico para garantir que o processo ocorra corretamente.

       Primeiramente, entre em contato com o suporte abrindo um ticket no topo desta tela de artigo ou pelo e-mail suporte@wake.tech ou com o time de Customer Success. Esses profissionais irão auxiliá-lo no processo de migração, garantindo que todas as etapas sejam realizadas de forma segura e eficiente.
Após a conclusão da migração para a versão 2.0, você estará apto a proceder com as configurações necessárias na nova plataforma que esta neste instrutivo.

---

Como ativar o App da Wake no Hub do Pagar.me

       O App da Wake no Hub do Pagar.me foi criado para tornar o processo de integração com o Pagar.me mais ágil, seguro e prático. Siga os passos abaixo para ativar a configuração em poucos cliques e simplificar suas operações.

Passo a passo da configuração

Você vai configurar o App da Wake no Admin da plataforma em 3 etapas:

1. Formas de Pagamento
2. Antifraude
3. Grupos de Pagamento e Parcelamentos

Vamos ver cada etapa em detalhes:

 

1ª Etapa - Formas de Pagamento

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

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

 

Configurações dos métodos de pagamentos

Passo 1: Deixar as chaves de acesso em branco

• Public Key e Private Key: Esses campos devem ficar em branco inicialmente. Não é necessário preenchê-los agora.

Passo 2: Preencher as informações dos métodos de pagamento

• Preencha as informações para os seguintes métodos de pagamento:
  • Boleto
  • Transparente (Cartão)
  • Pix
• Depois de preencher todas as informações, clique em “Atualizar”.

Detalhes dos campos

• Cada método de pagamento tem campos específicos que devem ser preenchidos. Esses campos estão detalhados mais abaixo nesta documentação.

Iniciar a integração com o Pagar.me via APP

• Depois de preencher todas as informações dos métodos de pagamento, você estará pronto para iniciar a integração com o Pagar.me através do APP.

 

Integrando com o Pagar.me via App da Wake

       Esta integração serve para os três métodos de pagamento (Boleto, Transparente e Pix), integraremos todas somente uma vez seguindo o passo a passo abaixo:

Passo 1: abra o Conector em qualquer uma dos Métodos de Pagamento;

Passo 2: clique no botão "Integrar com o Pagar.me". Você será redirecionado(a) para o Hub de apps do Pagar.me para fazer a autorização.

Passo 3: caso você não esteja logado, você precisará inserir seus dados de acesso do Pagar.me, são os mesmos dados de acesso utilizados para acessar seu Dashboard do Pagar.me. Caso você já esteja logado, você será direcionado para a tela de Seleção de Loja para instalar o App.

Passo 4: selecione a loja que você deseja instalar o App. 

Para utilizar uma loja de teste, basta alterar para o ambiente de teste e selecionar a loja de teste do Pagar.me.

Passo 5: uma lista de ações e eventos utilizados por nosso app será apresentada solicitando a autorização de acesso. Clique em "Autorizar". Você será redirecionado de volta para o Admin da Wake Commerce.

Como desfazer a integração via App?

• Nome da Configuração: identificação interna da configuração. Não será o nome apresentado ao consumidor;
• PublicKey: chave pública informada no dashboard do Pagar.me. Na integração via APP esse campo não precisa ser preenchido; 
• PrivateKey: chave privada informada no dashboard do Pagar.me. Na integração via APP esse campo não precisa ser preenchido;
• Banco emissor: no caso de boleto, será preciso cadastrar também o código do banco gerador do boleto;
• Vencimento do boleto em dias: prazo de vencimento do boleto em dias;
• Cancelamento do boleto em dias: prazo de cancelamento automático do pedido em dias, caso o pagamento não seja identificado. O prazo de cancelamento deverá ser sempre superior ao prazo de vencimento;
• Instruções: o campo Instruções você pode editar como preferir.
• Sandbox: a chave "Sandbox", por padrão, deve permanecer desativada, pois é utilizada apenas em modo de teste. (Ignore este campo);
• Integrar com o Pagar.me / Visualizar integração com Pagar.me: botão de atalho para fazer a integração ou editar/excluir a integração da sua loja no Pagar.me com a Plataforma.

TRANPARENTE (Cartões)

• Nome da Configuração: Identificação interna da configuração. Não será o nome apresentado ao consumidor;
• PublicKey: chave pública informada no dashboard do Pagar.me. Na integração via APP esse campo não precisa ser preenchido;
• PrivateKey: chave privada informada no dashboard do Pagar.me. Na integração via APP esse campo não precisa ser preenchido;
• Descrição: descrição da cobrança na fatura do cliente com no máximo 13 caracteres (ex.: nome da loja). É importante verificar se esse recurso é compatível com a adquirente utilizada;
• Antifraude: todos os clientes da Pagar.me tem o Antifraude da ClearSale ativados por padrão (Ignore este campo);
• Merchant Category Code: valor padrão é 0 (zero). Este valor muda de acordo com a configuração da loja no dashboard do Pagar.me;
• Payment Method Code: valor padrão é 0 (zero). Este valor muda de acordo com a configuração da loja no dashboard do Pagar.me. 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;
• Integrar com o Pagar.me / Visualizar integração com Pagar.me: botão de atalho para fazer a integração ou editar/excluir a integração da sua loja no Pagar.me com a Plataforma.

Antifraude

       Todos os clientes do Pagar.me possuem o Antifraude Pagarme 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. 

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. 

PIX

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

• Nome da Configuração: identificação interna da configuração. Não será o nome apresentado ao consumidor;
• PublicKey: chave pública informada no dashboard do Pagar.me. Na integração via APP esse campo não precisa ser preenchido;
• PrivateKey: chave privada informada no dashboard do Pagar.me. Na integração via APP esse campo não precisa ser preenchido;
• Expiração do QRCode em minutos: tempo em minutos em que o QR Code ficará válido para pagamento.;
• Descrição: descrição que será exibida ao ler o QRCode com no máximo 50 caracteres (ex.: nome da loja);
• Integrar com o Pagar.me / Visualizar integração com Pagar.me: botão de atalho para fazer a integração ou editar/excluir a integração da sua loja no Pagar.me com a Plataforma.

 

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 e, por padrão, vem configurado como display:none de forma nativa.

       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 QR Code 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 >> 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. Na integração via APP esse campo não precisa ser preenchido;
• PrivateKey: utilize o mesmo token da configuração do Cartão. Na integração via APP esse campo não precisa ser preenchido;
• 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 - Grupos de Pagamento e Parcelamentos

       Após as primeiras configurações, você deverá clicar em Pagamentos >> Gerenciamento de pagamento 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 PagarMe 2.0;
• Cancelamento / Estorno de Pagamentos: a opção de Cancelamento do pedido está disponível em nossa API Pública, assim como a opção de Estorno total ou parcial . Essas ações devem ser feitas por uma aplicação externa usando nossa API Pública.
• Faça um pedido teste com Boleto PagarMe 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 PagarMe. Para orientações sobre o desbloqueio, confira o conteúdo Gerenciar Políticas de Segurança.
• Para utilizar o ambiente de teste integrando com o App da Wake no Pagar.me, você deverá “excluir” a loja do app da Wake no Hub Pagar.me e integrar com uma loja de teste.