Essa é a versão mais atualizada de integração com Pagar.me na qual o seller acessa o dashboard Pagar.me na versão 2.0.
1. Como ativar a integração:
1.1 Acesse as configurações da loja > Pagamentos > Cartão de crédito.
1.2 Clique nos três pontinhos e selecione a opção "Editar os dados":
1.3 Nesta próxima tela, preencha os seguintes dados:
Valor mínimo da parcela;
Descontos por parcela (caso possua);
Número máximo de parcelas;
Número máximo de parcelas sem juros;
Taxa de juros para parcelamento;
Bandeiras aceitas: preencha com as bandeiras que serão aceitas pelo adquirente;
Confirmar Pedidos Automaticamente (caso queira, marque o campo ao lado);
Descrição na fatura: insira o nome da loja.
Clique em "Enviar";
👉 Instalação do aplicativo
Volte em "Editar os dados", e no canto superior direito da tela de configurações, clique em "Criar credenciais";
Você será direcionado para a tela de login da Pagar.me. Logue com seus dados de acesso e finalize a instalação;
Lembre-se de selecionar todas as opções disponíveis em "Métodos de Pagamento" - Cartão de crédito, Pix e Boleto.
Após concluir estes passos, os tokens serão cadastrados em nossa plataforma.
1.4 Após a criação das credenciais em Cartão de Crédito, para as demais formas de pagamento basta ativá-las no admin e preencher as configurações adicionais. Não é necessário realizar a criação das credenciais em cada uma das formas.
Configurações adicionais em Boleto: acesso em /admin/config/pagamentos/boleto
Código do banco: 198 (Pagar.me) - essa é a opção padrão, se o seller preferir pode escolher outra.
Instruções do boleto: pode ficar em branco (inserir um espaço [ ], pois atualmente o campo não salva se não houver nenhum caractere)
Número que identifica...: pode ficar em branco (inserir um espaço [ ], pois atualmente o campo não salva se não houver nenhum caractere)
Tipo de espécie do boleto: DM (Duplicata mercantil)
2. Pontos de Atenção!
2.1 Caso todos os dados estejam corretos, e ainda assim não esteja conseguindo finalizar o pedido, é necessário conferir o campo "Domínios", no painel da Pagar.me em Configurações > Conta.
Esse campo precisa estar em branco. Caso hajam outros domínios cadastrados (como os domínios da plataforma atual do seller, por exemplo) será necessário inserir a url de CDN e a de produção da loja.
Obs: pode validar o CDN indo no Who.is
Atualização 02/10/2024: o campo precisa estar preenchido com url da loja e CDN.
Exemplo:
Com estes domínios cadastrados os pedidos poderão ser finalizados.
2.2 No painel Vnda em Configurações > Dados da loja deve revisar o campo "Nome" para que não ultrapasse 13 caracteres.
Se esse campo não estiver de acordo com esse formato deve ocorrer um erro na transação de "soft descriptor invalid (tamanho máximo 13 caracteres), conforme imagem:
2.3 Depois de realizar os passos acima, o time de N2 precisa fazer a liberação da loja dentro da Cloudflare. Para isso, é preciso:
Entrar nesse link: https://flags.vnda.io/projects/default/features/CHECKOUT_USES_PAY_API
Clicar em "production" > "edit strategy" > "targeting" > "edit constraint"
No campo de "values" inclua o shophost da loja. Por exemplo: em https://www.yuool.com.br/ o ambiente de testes é yuool2.vnda.dev, portanto o shophost é yuool2.
3.4 Se todas as configurações estiverem de acordo, e ainda assim o pagamento não for autorizado, desinstale o aplicativo da Vnda no HUB da Pagar.me e refaça essa etapa.
3.4.1 Exclusão do app no HUB Pagar.me
Essa etapa deve ser realizada em dois cenários:
Quando for identificada alguma inconsistência na integração.
Quando o cliente tiver cadastrado inicialmente apenas uma forma de pagamento (Pix, cartão ou boleto) e desejar adicionar outras posteriormente.
Como realizar
Acesse o menu "Minhas Integrações" — ele pode ser encontrado a partir do botão "Criar credenciais".
Localize o aplicativo vinculado à Olist Vnda.
Clique em "Excluir" ao lado do app.
Confirme a exclusão quando solicitado.
Refaça a criação das credenciais selecionando todas as formas de pagamento desejadas, seguindo essa etapa.