Atenção: caso você já tenha uma loja criada e em uso na Maxipago e seja o primeiro uso para Conector na VTEX é necessário pedir para seu contato comercial (Cash/Gerente/Especialista) solicitar para a central de Atendimento a configuração da loja para VTEX, enviando o dado de merchantKey do cliente no chamado.
Como acessar a MerchantKey (chave de API): https://www.maxipago.com/developers/esqueci-a-chave-de-estabelecimento-merchant-key/
1. Credenciamento do Boleto Itaú
Esse processo funciona exclusivamente para BOLETO ITAÚ, demais bancos seguir pelo fluxo com alinhamento com comercial/cash.
A primeira etapa é a geração de credenciais do Boleto, para isso siga o passo a passo abaixo junto com o seu Cash/Ponto focal comercial:
Passo 1: Informe a Chave Pública Abaixo para seu Cash e ele irá te retornar com as chaves de integração, é necessário que as credenciais sejam criptografadas.
Para a criação das credenciais serem efetuadas com sucesso é necessário que compartilhe e reforce com o comercial a chave pública abaixo. As quebras de linhas devem se manter igual no exemplo abaixo.
Atenção: somente credenciais CRIPTOGRAFADAS geradas a partir dessa chave pública serão válidas no ambiente da Maxipago
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoy0MfqgRWW5+UY+W1BmE
H/DodonktCrUxcTOysrNFfUdZlc+4u62DtbXr6GvxYfmJ/t6UoVT6TS+KO6Ve6ks
pLCAubeZPeqhbyrYs3zDbH6GjXTd8EhJNDG8rz8ECZQ4gE3HGlneAfJ/rcgCkgRG
pIx53QPsbSeXxF8fjfl2+70M55NW6ZKy5XjdNK8Cb38WVEIswXSGDoImvoKqu6cY
HXxZ/AyZTcZuVZciPO7M+FcT5UaW9gTvINIB0uJdjDYJeppkT2vmHMHVf4uKE3sm
XkqpvV7egVDtR9dgXLYKAE80PU18NnbGehh16S1ViyZMgRSkDl8xSGhGWmWa9Uoj
mQIDAQAB2. Inclusão das Credenciais na Maxipago
As credenciais de Boleto chegam por e-mail do remetente: Itaú Unibanco – API Governança <itau@itau.com.br> no modelo abaixo com os dados necessários para cadastro:
  Olá! Tudo bem? Que bom ter você aqui, no Itaú Empresas. Atendendo à sua solicitação, seguem as credenciais para geração de certificado dinâmico. O token é válido por 7 dias, após esse prazo, deve ser solicitado novo cadastro. Razão Social: {Nome do Cliente} CNPJ: {00.000.000/0000-00} ClientId (Criptografado): {clientId} Token Temporário (Criptografado): {token} Chave de Sessão: {chave} Importante: não compartilhe este e-mail com ninguém, ele é para o seu uso exclusivo e deve ser utilizado somente para gerar o seu certificado de acesso às APIs do Itaú Empresas. Para mais informações sobre como utilizar os dados acima, acesse a documentação disponível aos desenvolvedores. |
De posse da suas credenciais do Boleto Itaú você deverá acessar o Portal do Lojista da maxiPago:
Ambiente de Produção: https://portal.maxipago.net/vpos/VPOS
1. Acesse o Portal com suas credencias (enviadas no e-mail de boas-vindas)
2. Acesse a aba: Admin – no menu superior (apenas disponível para perfil SuperUser)
3. Acesse a aba: Boleto
4. Acesse o submenu: Credencias – inclua as suas informações de Agência, Conta e Digito e depois informe Client ID, Token Temporário e Chave de Sessão (Enviados por E-mail pelo seu Cash)
Atenção: Nos campos de Agência e Conta, não utilize pontuações como: “:‘”, “;“, “.“, etc. Utilze somente números.
Assim que as credenciais forem registradas, clique em salvar credenciais.
3. Configuração das Credenciais na Maxipago
Acesse o Portal da sua loja na VTEX
Na aba lateral esquerda clique em “Provedores“
Clique em “Novo provedor“
Pesquise por “MaxiPagoV4” para iniciar a configuração do conector
“Chave de aplicação” coloque o seu “merchantID” – é o número da sua loja na Maxipago, pode ser encontrado após o logar no Portal Maxipago no canto superior direito, ou seguindo a rota a seguir: Admin>Configurações>Geral>Id da Loja (Merchant ID)
“Token de aplicação” coloque a sua “merchantKey” – seguindo a rota a seguir: Admin>Configurações>Geral>merchantKey
Em “Informações básicas” e “Nome”: escreva um nome para identificar o conector da Maxipago, ele será importante para encontra-lo nas próximas etapas
Após a configuração de credenciais Maxipago na VTEX é necessário fazer a configuração do Boleto dentro da VTEX
Para isso vá na Aba Lateral>Configuração da Loja>Pagamentos>Configurações>Clique no Botão de Adicionar “+” no canto superior direito
Caso seja a primeira configuração para uso do Boleto, desça a página até a opção de “Boleto Bancário”
Se já tiver algum provedor de boleto cadastrado, siga para o próximo passo e apenas faça a troca do conector.
Em “Status” deixe a opção como “Ativa’
Procure pelo conector que foi adicionado anteriormente e o nome salvo em “Informações básicas” e “Nome”
Na opção de “Adicionar condição especial” configure regras que deseje para o Boleto e clique em “Salvar“
