Magento 2: Total, Total Garantido e Application
Magento 2: Total, Total Garantido and Application
Introdução
Nesta seção, explicaremos como implementar o plugin Magento 2 em sua plataforma conforme o produto contratado.
Introduction
In this section, we will explain how to implement the Magento 2 plugin on your platform as per the contracted product.
Pré-Requisitos
Ter instalado em sua loja o Magento na versão 2.0 ou superior.
Utilizar padrão de endereço brasileiro com 4 campos (rua, número, bairro e complemento).
Crons habilitadas.
Checkout padrão do Magento.
Template (theme) desenvolvido utilizando as boas práticas segundo documentação do Magento.
Sempre utilizar a última versão do módulo Clearsale
Salientando que módulos de terceiros podem impactar no funcionamento do módulo da Clearsale, ou vice versa.
Não nos responsabilizamos nestes casos e não possuímos suporte à fornecedores terceiros.
Instalar o plugin conforme o produto contratado (Total, Total Garantido ou Application).
Clique aqui para fazer o download do arquivo de instalação do plugin.
Prerequisites
Magento 2.2.0 or higher installation.
Install the plugin according to the contracted product (Total, Total Garantido or Application).
Instalação
Basta descompactar o conteúdo zipado do módulo dentro da pasta do projeto.
Para ter certeza de que o Magento está reconhecendo o módulo, vá ao terminal na pasta do seu projeto e rode o comando:
bin/magento module:status
Para habilitar o módulo, os seguintes comandos devem ser executados no terminal:
php bin/magento module:enable Clearsale_Base Clearsale_Fingerprint Clearsale_Total --clear-static-content
php bin/magento setup:upgrade
Installation
Only unzip the zipped contents of the module into the project folder.
To make sure that Magento is recognizing the module, go to the terminal in your project folder and run the command:
bin/magento module:status
To enable the module, the following commands must be executed at the terminal:
php bin/magento module:enable Clearsale_Base Clearsale_Fingerprint Clearsale_Total --clear-static-content
php bin/magento setup:upgrade
Configuração
O módulo do Magento 2 para os produtos Total, Total Garantido e Application é composto por 3 sub-módulos. São eles:
- Clearsale Base v.1.0.15
- Clearsale Total v 1.0.18
- Clearsale Fingerprint v.1.0.2
Juntos esses sub-módulos fazem a integração completa do produto Clearsale bem como as ferramentas complementares para a prevenção de fraude em sua loja.
Para acessar as configurações você poderá acessar: Lojas -> Configuração -> Clearsale -> Base
Base
Base - Mapeamento de Endereço
Atributo de rua: Para mapear qual campo é utilizado para informar o logradouro do endereço em seu checkout.
Atributo de número: Para mapear qual campo é utilizado para informar o número do endereço em seu checkout.
Atributo de bairro: Para mapear qual campo é utilizado para informar o bairro do endereço em seu checkout.
Atributos de complemento: Para mapear qual campo é utilizado para informar o complemento do endereço em seu checkout.
Base - Mapeamento das formas de pagamento
Forma de pagamento por cartão de crédito: Campo para mapear quais meios de pagamento da loja correspondem com Cartão de Crédito.
Forma de pagamento por cartão de débito: Campo para mapear quais meios de pagamento da loja correspondem com Cartão de Débito.
Forma de pagamento por paypal: Campo para mapear quais meios de pagamento da loja correspondem com PayPal.
Forma de pagamento por transferência bancária: Campo para mapear quais meios de pagamento da loja correspondem com Transferência Bancária.
Forma de pagamento por boleto: Campo para mapear quais meios de pagamento da loja correspondem com Boleto Bancário.
Forma de pagamento por depósito bancário: Campo para mapear quais meios de pagamento da loja correspondem com Depósito Bancário.
Forma de pagamento por PIX: Campo para mapear quais meios de pagamento da loja correspondem com PIX.
Total – Configurações
Total – Gerenciar Status
Total - Mapeamento dos métodos de pagamento
Total - Configurações do cron
Fingerprint
O módulo do fingerprint é responsável por identificar e detectar o dispositivo que está sendo utilizado para realizar a compra na loja.
Notificação de Atualização de Status
Sempre que ocorrer alteração no status de um pedido, o Webhook da Clearsale irá enviar uma notificação para um URL.
Essa configuração funciona da seguinte forma:
URL_DA_LOJA + /clearsale_total/webhook/index
Exemplo:
http://lojadeteste.com.br/clearsale_total/webhook/index
Encaminhe essa URL para a equipe de integração através do e-mail integracao@clear.sale para que essa URL seja configurada na base da Clearsale.
Marcação de Chargeback
Na tela dos pedidos existem 2 abas, uma delas é responsável pela marcação de chargeback de um pedido já integrado e aprovado na Clearsale.
Exemplo:
Atualização de Status
A outra aba da tela de pedidos se refere a atualização de status de pagamento.
Caso em sua regra de negócio o processamento do pagamento ocorrer depois do envio do pedido e decisão da Clearsale é possível que nos informe qual foi finalização do mesmo através deste serviço.
Exemplo:
Configuration
The Magento 2 module for Total, Total Garantido and Application products consists of 3 submodules. Are they:
Together these submodules make the complete integration of the Clearsale product as well as the complementary fraud prevention tools in your store.
To access the settings you will be able to access: Lojas -> Configuração -> Clearsale -> Base
Base
Base - Address Mapping
Atributo de rua: To map which field is used to inform the address of your checkout address.
Atributo de número: To map which field is used to enter the address number at your checkout.
Atributo de bairro: To map which field is used to inform the neighborhood of the address at your checkout.
Atributos de complemento: To map which field is used to enter the address complement in your checkout.
Base - Payment methods mapping
Forma de pagamento por cartão de crédito: Field to map which store payment methods correspond with Credit Card.
Forma de pagamento por cartão de débito: Field to map which store payment methods correspond with Debit Card.
Forma de pagamento por paypal: Field to map which store payment methods correspond with PayPal.
Forma de pagamento por transferência bancária: Field to map which store payment methods correspond with Bank Tranfer.
Forma de pagamento por boleto: Field to map which store payment methods correspond with Bank Slip.
Forma de pagamento por depósito bancário: Field to map which store payment methods correspond with Bank Deposit.
Total - Configuration
Total - Manage Status
Total - Payment methods mapping
Total - Cron settings
Fingerprint
The fingerprint module is responsible for identifying and detecting the device being used for in-store purchase.
Status Update Notification
Whenever an order status changes, Clearsale Webhook will send a notification to a URL.
This setting works as follows:
STORE_URL + /clearsale_total/webhook/index
Example:
http://lojadeteste.com.br/clearsale_total/webhook/index
Forward this URL to the integration team at integracao@clear.sale to set this URL at the Clearsale base.
Chargeback Marking
In the order screen there are 2 tabs, one of which is responsible for chargeback marking of an order already integrated and approved by Clearsale.
Example:
Status Update
The other tab of the ordering screen refers to the payment status update.
If in your business rule payment processing occurs after the order has been submitted and Clearsale's decision, You may let us know how it was completed through this service.
Example: