A configuração da MaxiPago by Rede é feita no Admin (Administrador da plataforma) em 4 etapas:
1ª etapa: Formas de Pagamento;
2ª etapa: Antifraude;
3ª etapa: Webhook;
4ª etapa: Grupos de Pagamento e Parcelamento.
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, como mostrado abaixo:
Depois se direcionar ao conector em >> MaxiPago by Rede >> "Adicionar Configuração":
Cadastre um nome para a configuração e selecione o seu tipo: Cartão, PIX ou Boleto:
Descrições dos campos dos métodos de pagamentos disponíveis
CARTÃO
Nome da Configuração: Identificação interna da configuração. Não será o nome apresentado ao consumidor (cliente final);
AccessToken: Id da loja que identifica o estabelecimento informado como "merchantId" no dashboard da MaxiPago;
PublicKey: Chave associada ao ID da loja informada como "merchantKey" no dashboard da MaxiPago;
ProcessorId: Código da adquirente que irá processar a transação:
Simulador de teste = 1 | Rede = 2 | GetNet = 3 | Cielo = 4 | Stone = 9
Ref: https://www.maxipago.com/developers/apidocs/maxipago/cartao-de-credito/autorizacao/
Antifraude: Antifraude utilizado pelo Lojista: Manual/Próprio ou Clearsale;
Sandbox: Habilitar sandbox da Maxipago para relaizar testes.
BOLETO
Nome da Configuração: Identificação interna da configuração. Não será o nome apresentado ao consumidor (cliente final);
AccessToken: Id da loja que identifica o estabelecimento informado como "merchantId" no dashboard da MaxiPago;
PublicKey: Chave associada ao ID da loja informada como "merchantKey" no dashboard da MaxiPago;
ProcessorId: Código da adquirente que irá processar a transação:
Boleto Itaú = 207 | Boleto Bradesco = 12 | Boleto Santander = 15
Ref: https://www.maxipago.com/developers/apidocs/maxipago/boleto-bancario/
DiasCalendario: Prazo de vencimento do boleto em dias;
Sandbox: Habilitar sandbox da Maxipago para relaizar testes.
PIX
Nome da Configuração: Identificação interna da configuração. Não será o nome apresentado ao consumidor (cliente final);
AccessToken: Id da loja que identifica o estabelecimento informado como "merchantId" no dashboard da MaxiPago;
PublicKey: Chave associada ao ID da loja informada como "merchantKey" no dashboard da MaxiPago;
ProcessorId: Código da adquirente que irá processar a transação:
Simulador de teste = 1 | Rede = 2 | GetNet = 3 | Cielo = 4 | Stone = 9
Ref: https://www.maxipago.com/developers/pix/
HorasCalendario: Tempo em horas em que o QR Code ficará válido para pagamento;
Sandbox: Habilitar sandbox da Maxipago para relaizar testes;
Editor HTML: Campo para inserir texto de instrução, campos ou informações em formato HTML (código de marcação geralmente criada por um desenvolvedor ou pela agencia). Essas informações serão apresentadas no Checkout, na opção de Pagamento Pix.
Ajuste de Layout
A configuração 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 pagamentos 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 pagamentos no 'Minha Conta'
Por padrão, a exibição do QR Code vem desabilitada. Saiba como ajustar acessando o artigo Detalhes do Minha Conta.
2ª Etapa - Antifraude
O Conector Maxipago permite trabalhar com 2 antifraude disponíveis hoje na plataforma.
Abaixo listamos quais são e como funcionam:
Antifraude Clearsale: Nossa plataforma tem integração direta com a Clearsale e permite que seus pedidos pagos com cartão de crédito passem pela análise de fraude. Para configurar, basta inserir o código App e a Chave da Clearsale na plataforma;
Antifraude Manual: Funciona como um antifraude manual, permitindo que os pedidos pagos com cartão de crédito sejam processados em 2 passos (Autorização e Captura). No primeiro passo, o pagamento será apenas Autorizado junto a Maxipago e, após a aprovação manual do pedido, será capturado junto a Maxipago.
Com este antifraude, o pedido será atualizado para “Autorizado” na plataforma quando a Maxipago retornar com a autorização. Após a análise manual, o pedido deve ser alterado via API Pública ou via Admin para o status 14 “Pedido Aprovado Análise”, para que a captura do pagamento seja realizada na Maxipago.
Você também pode definir um valor mínimo, fazendo com que somente os pedidos acima desse valor passem pelo Two-steps (Autorização e Captura). Pedidos abaixo sejam Capturados automaticamente.
3ª Etapa - Soft Descriptor
Finalizada a etapa de configuração acima é importante que verifique se é necessário na sua loja ativar o botão “Soft Descriptor”.
O que é Soft Soft Descriptor?
O Soft Descriptor da MaxiPago é um recurso que permite personalizar o nome que aparecerá na fatura do cartão de crédito do cliente para identificar a compra realizada. Em vez de exibir o nome genérico do processador de pagamento ou um código difícil de reconhecer, o Soft Descriptor permite mostrar o nome da loja.
Benefícios:
Reconhecimento da Compra: Facilita que o cliente reconheça a transação na fatura do cartão, reduzindo disputas ou estornos por desconhecimento.
Confiança e Transparência:
Uma descrição clara na fatura ajuda a melhorar a percepção de confiabilidade do lojista ou prestador de serviço.
Considerações Técnicas:
Após ativado na Wake, precisamos que seja configurado diretamente na integração da loja com a MaxiPago, caso contrário, as transações serão automaticamente canceladas."
4ª Etapa - Webhook
Após as configurações da forma de pagamento, Antifraude e Soft Descriptor é necessário cadastrar nossa URL de Callback na MaxiPago conforme orientado pela Maxipago na Documentação Serviço de Notificação (webhook).
Orientação Maxipago:
Para funcionamento do Webhooks, a URL de callback deve ser criada e ficar online constantemente. Essa URL precisa ser informada ao time de Suporte e Integração para validação (suporte.mp@userede.com.br) e posterior publicação no ambiente de produção.
Segue abaixo nossa URL de Callback para atualização de status de pagamentos: https://gateway-postback.fbits.net/api/MaxiPago
5ª Etapa - Grupos de Pagamento e Parcelamento
Após as primeiras configurações, você deverá clicar em Pagamentos >> Gerenciamento de pagamento >> Parcelamentos e seguir o passo a passo completo no artigo Grupos e Pagamentos.
Recomendações Gerais
- 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.
- Realize um pedido teste com um cartão válido para verificar se o pagamento transacionará corretamente na Maxipago;
- Faça um pedido teste com Boleto Maxipago, para verificar se o boleto será gerado corretamente, caso vá utilizar esta forma de pagamento;
- Faça um pedido teste com PIX Maxipago, 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 da Maxipago. Para orientações sobre o desbloqueio, confira o conteúdo Gerenciar Políticas de Segurança.
- Para utilizar o ambiente de teste da Maxipago, ative a chave “Sandbox” dentro das configurações. Utilizando o ambiente Sandbox, não será necessária a inclusão do ProcessorId nas configurações.