Guia de Instalação SAP Hybris
# Configuração do plugin<h1>
# Pré-requisitos<h2>
Usuário do Backoffice com poder administrativo.
# Checkout flow group e limitações<h2>
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:
1. O cliente seleciona ou cria o endereço de envio.
2. O cliente seleciona o método de envio.
3. O cliente seleciona o método de pagamento e o endereço de cobrança.
4. 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:
<Image title="teste.png" alt={1920} src="https://files.readme.io/829208d-teste.png">
Fluxo padrão do SAP Commerce
</Image>
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](https://www.notion.so/b229d194a3694c97a1bb0e66468ce552). 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](https://www.notion.so/b229d194a3694c97a1bb0e66468ce552) 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. 1 - Acesse a [página de login do Backoffice](https://siteAdministrativoCommerce/backoffice), e faça o login.\
*OBS: Trocar "siteAdministrativoCommerce" pela URL correta.*
1. 2 - Selecionar menu “**Comércio Base**”, e em seguida selecionar o menu “**Loja Base**”.
1. 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.
1. **Pagaleve - Integração está ativa?** —> Marcamos com “verdadeiro” ou “falso” para ativar o meio/tipo de pagamento Pagaleve.
2. **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);
3. **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:
1. Clique no botão “**GERAR TOKEN**”, você será direcionado para a tela de login da Pagaleve.
<Image title="teste.png" alt={918} src="https://files.readme.io/74f07a9-teste.png">
Tela de login da Pagaleve
</Image>
2. Faça o login, copie o seu token e cole no campo “**Pagaleve API Token**”;
3. 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.
1. Clique no botão “**GERAR TOKEN**”, você será direcionado para a tela de login da Pagaleve;
<Image title="teste.png" alt={918} src="https://files.readme.io/e4cee21-teste.png">
Tela de login da Pagaleve
</Image>
2. Faça o login, copie o seu token e cole no campo “**Pagaleve API Token**”;
3. 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.
1. Selecione na opção "**Status do pedido Pagaleve após aprovação**" a opção "**Pagamento autorizado**"
2. Agora clique em “**Salvar**”
## Configurações de administração
1. Na secção "**Desvincular**" no campo "**Grupo de fluxo de check-out**" preencha com o valor "**pagaleveResponsiveCheckoutGroup**"
2. Agora clique em “**Salvar**”Updated 22 days ago