Como configurar o Conector Mundipagg no Admin
A configuração do Mundipagg é feita no Admin em 3 etapas:
1ª Etapa: Configuração do Webhook e Chaves na Mundipagg;
2ª Etapa: Formas de Pagamento;
3ª Etapa: Grupos de Pagamento e Parcelamentos.
Confira o passo a passo das configurações dentro das suas respectivas etapas.
1ª Etapa - Configuração do Webhook e Chaves na Mundipagg
Dentro da plataforma da Mundipagg, você deverá fazer as configurações abaixo para que a integração funcione corretamente:
Em Configurações >>Webhooks >>Criar Webhook, você deverá cadastrar a URL (https://gateway-postback.fbits.net/api/Mundipagg), preencher o campo "Número Máximo de Tentativas" com "3" e habilitar todos os eventos relacionados à Cobrança.
Feito isso, salve as alterações.
Em Desenvolvimento >> Chaves é necessário copiar a Chave Pública (Public Key) e a Chave Secreta (Secret Key), pois as mesmas serão utilizadas na configuração da plataforma da Wake Commerce.
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.
Assim que receber a confirmação de que todas as configurações foram concluídas e testadas na MundiPagg, será hora de realizar as configurações no admin da loja virtual.
Para as lojas que já estão no checkout atual, todas as formas de pagamento são configuradas no Novo Admin. A configuração da MundiPagg é feita em 4 etapas: Formas de Pagamento, Antifraude, Parcelamento e Grupos e Parcelamentos.
Confira, agora, o passo a passo da configuração no admin.
2ª Etapa - Formas de Pagamento
Clique em Pagamentos >> Conectores de Pagamento>> MundiPagg >> "+ Nova Configuração".
O campo abaixo vai abrir um pop-up onde se configurara um novo método de pagamento.
Cadastre um nome para a configuração e selecionar o seu tipo, sendo Transparente (cartão) ou Boleto.
Em seguida, cadastre a "Public Key (Chave Pública)" e a "Private Key (Chave Secreta)" da loja, copiadas do painel da MundiPagg. No caso de boleto, será preciso cadastrar também o código do banco gerador do boleto, o prazo de vencimento e o prazo de cancelamento automático do pedido, caso o pagamento não seja identificado. O prazo de cancelamento deverá ser sempre superior ao prazo de vencimento. 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.
Para a opção de Cartão de Crédito, existem campos diferenciados: "Merchant Category Code" e "Payment Method Code" que devem ser preenchidos com “zero”, a Para a opção de Cartão de Crédito, existem campos diferenciados: "Merchant Category Code" e "Payment Method Code" que devem ser preenchidos com “zero”, a "Preencha o campo 'Descrição' com o nome da loja, sem caracteres especiais como siglas e acentos, e com no máximo 20 caracteres. O recurso deve ser compatível com a adquirente utilizada." Caso utilize a ClearSale, deverá selecioná-la no campo "Antifraude". Caso utilize a ClearSale, deverá selecioná-la no campo "Antifraude".
A chave "Voucher" é referente apenas aos cartões VR benefícios, Sodexo e Alelo, então deve ficar inativa.
Voucher
No início do artigo comentamos que trabalhar com múltiplas formas de pagamento reflete diretamente na satisfação do cliente, aumentando é claro a proporção de vendas no site, uma vez que trata-se de mais facilidade para os clientes. Mas o que você não sabia é que ter a opção voucher disponível para forma de pagamento, traz infinitas possibilidades, e para você lojista que trabalha no ramo alimentício ou cultural, por exemplo, pode ainda oferecer o diferencial de pagamento com vale cultura, vale alimentação, refeição entre outros.
Informamos que este recurso aceita qualquer tipo de benefício disponibilizado pelas bandeiras (VR benefícios, Sodexo e Alelo).
Para utilizar a opção voucher é necessário criar uma nova forma de pagamento do tipo transparente, conforme mencionado acima. O antifraude não deve ser cadastrado para este tipo de pagamento e o parcelamento deve ser sempre em 1x.
Antifraude
Caso a loja não utilize 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.
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
Serviço cujo as transações são atualizadas imediatamente, em tempo real, assim que o pagamento é confirmado.
Após obter as chaves e realizar o processo de ativação, é necessário realizar a configuração no Painel Administrativo Wake, confira o passo a passo a seguir:
Em seguida, preencha os campos conforme abaixo:
- Nome da Configuração: informe o nome da configuração;
- Public Key (Chave Pública): chave encontrada no painel da Mundipagg;
- Private Key (Chave Secreta): chave encontrada no painel da Mundipagg;
- Minutos para Expiração do QRCode: tempo em minutos que o QRCode ficará ativo para o pagamento. Após este tempo, o pedido será cancelado;
- Descrição: descrição que será exibida ao ler o QRCode. Por padrão, será apresentado o nome da sua loja e caso você opte em deixar o campo vazio, será apresentado a palavra PIX;
- Editor HTM: as informações inseridas serão exibidas na tela de fechamento. (Obs: Este modo deve ser desenvolvido por alguém que possua conhecimento em programação).
Informações importantes sobre o PIX
Conta para Transacionar PIX
A integração com o PIX, utilizando a Mundipagg, requer que você tenha uma conta transacional com a Pagar.Me, conforme consta na documentação do PIX Mundipagg.
Entre em contato com a Pagar.me, por meio deste link, solicitando a abertura de uma conta para transacionar PIX Mundipagg na Plataforma Wake Commerce.
Taxa de utilização do PIX MundiPagg
O custo da utilização do Gateway Mundipagg, deve ser negociado junto à solicitação da ativação do PIX quando contrato direto.
Já para clientes que utilizam o contrato Mundipagg via Wake Commerce, não há alteração.
Pagar.me
O custo das transações é negociado individualmente entre cliente e Pagar.me no momento da ativação da conta.
Ativação do PIX na MundiPagg
Com conta já criada na Pagar.Me, acesse o painel da adquirente e copie as chaves da API e da Criptografia e siga os passos a seguir, indo de acordo com o contrato que você possui com a Mundipagg.
Contrato MundiPagg via Wake Commerce
Copie as duas chaves exibidas na tela e, em seguida, envie um chamado para o nosso suporte, utilizando nossos canais de atendimento.
Após a abertura do chamado enviaremos suas chaves de API a Mundipagg, sendo ela responsável por ativá-las. Após a ativação, retornaremos o chamado com as informações necessárias para que você configure a forma de pagamento PIX da Mundipagg na Plataforma Wake Commerce.
Contrato Próprio com a MundiPagg
Copie as duas chaves exibidas na tela e, em seguida, envie um chamado para a Mundipagg, essa por sua vez irá ativar suas chaves PIX. Após o retorno da Mundipagg, é só configurar a forma de pagamento PIX da Mundipagg na Plataforma Wake Commerce.
Configuração do PIX na Plataforma Wake Commerce
Após a conclusão dos passos anteriores é possível configurar a forma de pagamento PIX na Plataforma.
Ajustes 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.
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.
3ª Etapa - Grupos de Pagamento e Parcelamentos
Após as primeiras configurações, você deverá clicar em Pagamentos >> Gerenciamento de pagamentos e seguir o passo a passo completo no artigo Grupos de Pagamento.
Recomendações Gerais
- Realize um pedido teste com um cartão válido para verificar se o pagamento transacionará corretamente na MundiPagg;
-
Faça o mesmo pedido teste no Boleto MundiPagg, para verificar se o boleto será gerado corretamente, caso vá utilizar essa forma de pagamento;
-
Cancelar os pedidos manualmente na plataforma não estornará os pagamentos na MundiPagg. Isso significa que você deverá cancelar os pedidos também no painel da MundiPagg para que os pagamentos sejam realmente cancelados;
-
Por padrão, a adquirente E-Rede não tem a função de identificação em fatura (nome da loja) habilitada. Você deve solicitar a adquirente que habilite a função ou deixar o campo "Descrição" em branco, caso contrário, os pedidos poderão não transacionar corretamente na adquirente;
- Com a Mundipagg possuímos uma validação em tempo real para aprovação ou reprovação do pedido. Se informado um cartão inválido ou sem saldo, será exibido um pop-up para que os dados informados sejam revisados.