Configuração do plugin

Pré-requisitos

Usuário do Backoffice com poder administrativo.

Checkout flow group e limitações

O SAP Commerce (Hybris) trabalha com a arquitetura “Checkout Flow”. Os fluxos de checkout são usados pelo SAP Commerce para controlar o fluxo da tela da web.

O grupo de checkout padrão contém as informações de diferentes etapas do checkout, resultados de validação, comportamentos especificos, e configuração da barra de progresso (breadcrumb).

O fluxo padrão do SAP Commerce segue os passos descritos abaixo:

O cliente seleciona ou cria o endereço de envio.
O cliente seleciona o método de envio.
O cliente seleciona o método de pagamento e o endereço de cobrança.
O cliente finaliza a revisão final do pedido e o pagamento é iniciado, usando o método de pagamento selecionado.

Conforme pode ser visto na imagem abaixo:

Para customização, podemos seguir algumas maneiras como criar um novo fluxo de checkout, e/ou alterar o processo de checkout. O processo de checkout pode ser adaptado aos requisitos do projeto, modificando o fluxo definido nos arquivos correspondentes. As definições de etapas, validadores, resultados de validação e redirecionamentos no fluxo de checkout também podem ser adicionados, modificados ou removidos.

No caso do plugin da Pagaleve, em que se trata de uma adição de um meio/tipo de pagamento, a melhor maneira é apenas alterar o processo de checkout, isto é, o fluxo de checkout que você utiliza em seu SAP Commerce pode (e deve) continuar sendo o mesmo, sem que a adição da Pagaleve influencie nos demais meios de pagamento já existentes. A Pagaleve é mais um tipo/meio de pagamento que irá ser adicionado, e trabalha independente dos demais meios existentes.

As vitrines (Storefronts) de projetos SAP Commerce (Hybris) costumam variar muito.

Geralmente a vitrine (que também podemos chamar de front-end da loja) nunca seguiram o padrão do SAP Commerce. Além disso, todas as vitrines eram diferentes. Assim sendo, o plugin não é “Plug-And-Play” por estes motivos, porém o plugin contém todos os arquivos necessários para funcionamento completo do fluxo de pagamento Pagaleve, e é perfeitamente possível utilizar os códigos presentes no plugin para integrar o meio de pagamento Pagaleve em sua solução de pagamento, com algumas customizações, já que o principal objetivo do plugin é realizar redirecionamentos entre o SAP Commerce x Pagaleve, não utilizando qualquer tecnologia ou framework como ponte para tal.

Junto ao plugin, há um fluxo de checkout (checkout flow) que pode ser usado para testar o checkout da Pagaleve em conjunto ao checkout flow padrão do SAP Commerce. Este fluxo de checkout também pode servir de guia para a implementação do meio/tipo de pagamento Pagaleve em sua solução (ex: Gateway) de pagamentos, nossa documentação para testar o checkout da Pagaleve em conjunto ao checkout flow padrão do SAP Commerce também demonstra a localização dos arquivos de teste que podem ser utilizados como guia de consulta para implementação do meio/tipo de pagamento Pagaleve.

Configuração

A configuração do plugin Pagaleve é feita no Backoffice. Dentro do Backoffice há um menu especifico para a Pagaleve, dentro da “Loja Base”.

Para ter acesso ao menu via Backoffice fazemos:

1 - Acesse a página de login do Backoffice, e faça o login.
OBS: Trocar "siteAdministrativoCommerce" pela URL correta.

2 - Selecionar menu “Comércio Base”, e em seguida selecionar o menu “Loja Base”.

3 - Escolha a loja base desejada, veja que há uma aba chamada “PAGALEVE”, clique sob ela. Uma tela com diversas configurações se abrirá.

Há 4 seções nesta tela, sendo:

Configurações da conta

Aqui realizamos as configurações de gerenciamento do plugin.

Pagaleve - Integração está ativa? —> Marcamos com “verdadeiro” ou “falso” para ativar o meio/tipo de pagamento Pagaleve.
Pagaleve modo de teste —> Marcamos com “verdadeiro” ou “falso” para ativar o modo de testes do meio/tipo de pagamento Pagaleve (fará requisições à endpoints de testes);
Merchant account —> Preencher com o nome da sua loja (que irá realizar a transação na Pagaleve)

Configurações da API

Aqui realizamos as configurações de token da API:

Clique no botão “GERAR TOKEN”, você será direcionado para a tela de login da Pagaleve.

Faça o login, copie o seu token e cole no campo “Pagaleve API Token”;
Agora clique em “Salvar”

Configurações da API para ambiente de testes

Aqui realizamos as mesmas configurações que a seção acima, porém, para o ambiente de testes.

Clique no botão “GERAR TOKEN”, você será direcionado para a tela de login da Pagaleve;

Faça o login, copie o seu token e cole no campo “Pagaleve API Token”;
Agora clique em “Salvar”

Configurações da API para os pedidos

Aqui realizamos as configurações de status do pedido Pagaleve após a aprovação ou falha/cancelamento.

Selecione na opção "Status do pedido Pagaleve após aprovação" a opção "Pagamento autorizado"
Agora clique em “Salvar”

Configurações de administração

Na secção "Desvincular" no campo "Grupo de fluxo de check-out" preencha com o valor "pagaleveResponsiveCheckoutGroup"
Agora clique em “Salvar”