A partir do dia 01/07/2024 estará liberado na plataforma Flexy a integração com a versão 5 das APIs da Pagar.me. Saiba quais são as configurações necessárias para integrar com esta nova versão.
Começar a usar o Pagar.me é muito simples:
Passo 1. Solicite uma proposta comercial pelo canal de atendimento exclusivo para Clientes Flexy:
Passo 2. Após receber a proposta, crie uma conta na Pagar.me acessando https://www.stone.com.br/tipos-de-negocio/ecommerce e clicando em "Login", no canto superior direito da tela.
Passo 3. Após a criação da conta, será necessário realizar algumas alterações no painel da Pagar.me para que a integração com a Flexy funcione corretamente.
- 3.1 Entrar no painel da Pagar.Me, acessando o menu Configurações na barra lateral da esquerda;
- 3.2 Acessar o menu "Chaves", conforme imagem abaixo;
- 3.3 Na tela que será apresentada, crie uma chave atribuindo-se o nome que for mais conveniente para sua operação, após copie a informação.
- 3.4 No painel administrativo da Flexy, navegue até o menu "Gateways de Pagamento", selecione a Versão 5 e cole a chave no campo "Token de Acesso", salve as configurações.
- 3.5 Na mesma área de "Configurações", agora em "Meios de pagamento", se for de interesse a utilização do PIX como forma de pagamento, é necessário que a funcionalidade seja ativada também no painel da Pagar.Me.
- 3.6 Ainda sobre o PIX, para que ele funcione corretamente, é necessário que o tempo de expiração seja configurado com no mínimo 04 horas.
- 3.7 Para o correto funcionamento da atualização de status dos pedidos, será necessário realizar a configuração de webhook no painel da Pagar.Me, conforme abaixo:
- Status: Ativo
-
URL: dominio do site do cliente + /checkout/boleto/callback
Ex: (https://DOMÍNIO.com.br/checkout/boleto/callback) - Máximo tentativas: 3
- Habilitar autenticação: manter desativado
-
Eventos (somente os citados abaixo)
- Pedido
- order.canceled
- order.paid
- order.payment_failed
- Pedido
- Confirmar criação: utilize a senha do seu portal para confirmar.
É importantíssimo que a URL cadastrada esteja 100% correta conforme domínio do cliente.
Passo 4. Agora, para configurar as informações dos recebedores, tanto do marketplace quando das lojas (no caso de usar esse tipo de conta), é necessário criá-los no seguinte local:
- 4.1 Após a criação, utilize a informação destacada abaixo para configurar o "Merchant ID" na nossa plataforma. No caso de utilizar uma conta com do tipo marketplace, que comporta mais de uma loja, será necessário criar um recebedor para cada uma, mesmo que utilizem apenas uma loja.
- 4.2 A configuração no painel administrativo da sua conta na Flexy deverá ser nos seguintes locais, indicados abaixo. É fundamental que as chaves tenham o mesmo padrão de início da imagem apresentada abaixo.
Na conta do marketplace (configurações gerais > Flexypay:
Nas contas das lojas:
Considerações importantes:
- Atente-se para gerar a chave de integração no ambiente correto da Pagar.me, por padrão são disponibilizados dois ambientes, sendo um de homologação e outro de produção.
- A integração com a versão 4 das APIs permanecerá disponível na plataforma da Flexy, não haverá obrigatoriedade de migrar-se para uso da versão 5, no entanto, o uso da versão 5 é recomendado visto que possui uma estrutura mais robusta e segura e, também, que não haverá mais suporte para integração com a versão 4 após 01/07/2024.
Caso você utilize a funcionalidade de assinaturas, antes de utilizar a versão 5 das APIs, será necessário entrar em contato diretamente com a Pagar.me, sinalizando a intenção de utilizar a versão 5 das integrações. A equipe da Pagar.me fará então a migração dos registros de assinatura para a nova estrutura das integrações e somente então você estará apto para configurar a versão 5 na plataforma da Flexy.
Clientes marketplace que já utilizam a versão 4 e estão migrando para a versão 5, precisam garantir que todos os lojista tenham o Merchant ID (Código do Recebedor) atualizado com a versão 5, pois caso o marketplace configure para utilizar a versão 5 e os merchantId sejam da versão 4 haverá erro no processo de checkout.
Split financeiro
O split financeiro permite dividir o pagamento de um pedido entre os recebedores envolvidos na operação.
No FlexyPay, o percentual de comissão do split é definido manualmente pelo administrador do marketplace e pode ser configurado em duas camadas.
Percentual padrão
O campo Percentual de comissão define o percentual padrão de comissão do marketplace.
Esse percentual é aplicado a todas as lojas que não possuem uma comissão específica configurada.
Percentual por loja
É possível definir uma comissão diferente para cada loja por meio do botão:
$ Percentuais por loja
Ao acessar essa opção, é apresentada uma lista com todas as lojas do marketplace.
A lista apresenta:
- comissão padrão, somente para consulta;
- campo editável para definir uma comissão específica para cada loja.
Quando uma comissão específica é definida para uma loja, ela substitui o percentual padrão para aquela loja.
Importante: o botão $ Percentuais por loja aparece somente quando o split financeiro está ativado na conta.
Configuração em contas com lojas
Ao configurar o FlexyPay para uma loja específica dentro de um marketplace, a tela apresenta um aviso relacionado às credenciais.
Se a conta do Pagar.me utilizada for a conta do shopping, os campos de credenciais devem permanecer em branco na configuração da loja.
Na Versão 4, isso significa deixar em branco:
- Chave de API;
- Chave de criptografia.
Na Versão 5, deve ser deixado em branco:
- Token de Acesso.
As credenciais devem ser preenchidas na loja somente quando ela possuir uma conta própria e distinta junto ao Pagar.me.
Recorrência e assinatura
A funcionalidade de recorrência/assinatura está disponível somente na Versão 5 da integração.
Planos de assinatura criados anteriormente na Versão 4 não são mais suportados.
Caso sua loja tenha planos criados na V4, é necessário:
- Criar os planos novamente na V5;
- Vincular os produtos aos novos planos;
- Remover os planos antigos.
PIX na Versão 5
Para lojas que utilizam o FlexyPay na Versão 5, o tempo mínimo de expiração do PIX deve ser de 4 horas.
Essa configuração não é realizada na tela do FlexyPay.
Ela fica em:
Configurações → Formas de Pagamento
Antifraude
O antifraude utilizado com o FlexyPay é a integração com a ClearSale.
Essa configuração é realizada separadamente em:
Configurações → Antifraude
A ClearSale funciona em modo Realtime com gateways que processam cartão de crédito ou boleto, incluindo o FlexyPay.
Importante: não existe um campo de configuração de antifraude dentro da tela do FlexyPay.
O que esta tela não configura
Para facilitar a configuração, é importante diferenciar os recursos que pertencem ao gateway daqueles configurados em outras áreas do sistema.
Esta tela configura:
- Ativação ou desativação do FlexyPay;
- Versão da integração;
- Credenciais do Pagar.me;
- Merchant ID;
- Percentual de comissão, quando aplicável;
- Taxa do gateway, quando aplicável;
- Configuração de cálculo de split, quando aplicável.
Esta tela não configura:
- Parcelamento;
- Juros do cartão;
- Valor mínimo de parcelamento;
- Antifraude;
- Tempo de expiração do PIX.
Essas configurações ficam em outras áreas do sistema:
| Configuração | Onde configurar |
| Parcelamento | Configurações → Formas de Pagamento |
| Juros | Configurações → Formas de Pagamento |
| Valor mínimo | Configurações → Formas de Pagamento |
| Antifraude | Configurações → Antifraude |
| Expiração do PIX | Configurações → Formas de Pagamento |
Escopo da configuração
Algumas configurações do FlexyPay são específicas da conta do marketplace, enquanto outras estão relacionadas à integração de cada loja.
Conta do marketplace
Os seguintes campos são exclusivos da conta do marketplace:
- Percentual de comissão;
- Taxa do gateway;
- Configuração de Cálculo de Split;
- Percentuais específicos por loja.
Loja
A configuração da integração do gateway inclui as informações necessárias para conectar a loja ao Pagar.me.
Em lojas vinculadas a um marketplace, é importante observar a regra das credenciais: quando a conta do Pagar.me utilizada for a do shopping, as credenciais da loja devem permanecer em branco.
Perguntas frequentes
O FlexyPay processa cartão de débito?
Não. O FlexyPay processa cartão de crédito, boleto e PIX.
O FlexyPay aceita carteiras digitais, como Apple Pay e PicPay?
Não.
Onde configuro o parcelamento?
O parcelamento é configurado em Configurações → Formas de Pagamento, na configuração de Cartão de Crédito.
Onde configuro os juros?
Os juros também são configurados em Configurações → Formas de Pagamento.
Qual versão devo utilizar para trabalhar com assinaturas?
A Versão 5. A recorrência/assinatura não é mais suportada na V4.
Posso continuar utilizando planos de assinatura criados na V4?
Não. Planos criados na V4 não são mais suportados. É necessário criar novos planos na V5, vincular os produtos a eles e remover os planos antigos.
Onde encontro as credenciais da Versão 5?
O Token de Acesso e a Chave pública são utilizados na V5. A Chave pública fica disponível no painel do Pagar.me em Configurações → Chaves.
O FlexyPay possui antifraude?
O antifraude é disponibilizado por meio da integração com a ClearSale, configurada separadamente em Configurações → Antifraude. Não existe um campo de antifraude na configuração do FlexyPay.
Posso configurar o split por loja?
Sim. Quando o split financeiro está ativado, o administrador do marketplace pode utilizar o botão $ Percentuais por loja para definir uma comissão específica para cada loja.
O percentual de comissão é automático?
Não. O percentual é definido manualmente pelo administrador do marketplace.
O frete entra no cálculo da comissão do split?
Depende da configuração escolhida em Configuração de Cálculo de Split.
É possível calcular a comissão sobre Produtos + Frete ou somente sobre Produtos.
Uma loja individual pode configurar comissão, taxa do gateway e cálculo de split?
Não. Esses campos são disponibilizados somente para a conta do marketplace (shopping).
Qual é o tempo mínimo de expiração do PIX na V5?
Na Versão 5, o PIX deve ter um tempo mínimo de expiração de 4 horas.
Essa configuração fica em Configurações → Formas de Pagamento.
Suporte
Ficou com alguma dúvida ou precisa de ajuda? Entre em contato com o CSM da sua conta ou fale com nosso time de suporte pelo e-mail suporte@flexy.com.br.
Comentários
0 comentário
Artigo fechado para comentários.