Introdução

Nesta seção, explicaremos como implementar o plugin Magento 1 em sua plataforma conforme o produto contratado.

Introduction

In this section, we will explain how to implement the Magento 1 plugin on your platform as per the contracted product.

Pré-Requisitos

Instalação do Magento 1.9.0 ou superior.

Instalar o plugin conforme o produto contratado (Realtime decision).


Clique aqui para fazer o download do arquivo de instalação do plugin.

Prerequisites

Magento 1.9.0 or higher installation.

Install the plugin according to the contracted product (Realtime decision).


Click here to download plugin installation file.

Instalação

Basta descompactar os arquivos do módulo na raiz da sua instalação da Loja Magento.

Installation

Only unzip the module files to the root of your Magento Store installation.

Resolução de Problemas

Página 404 ao acessar a configuração no admin: Efetuar a limpeza de cache, efetuar logout e fazer novamente o login no painel administrativo.

Caso não apareça as configurações do módulo: Verificar se a estrutura de pastas foi criada corretamente e se em sua configuração o módulo está ativo.

Caso esteja ativo e mesmo assim o módulo não apareça verifique as permissões nos arquivos instalados.

Troubleshooting

Page 404 when accessing configuration in admin: Clear cache, log out, and log back in to the admin panel.

If no module settings appear: Verify that the folder structure has been created correctly and that in its configuration the module is active.

If it is active and yet the module does not appear check the permissions on the installed files.

Configuração

O módulo do Magento 1 para os produto Realtime é composto por 5 sub-módulos. São eles:


    Base

    Profiler (Account Integration)

    RealTime Decision

    Fingerprint

    Mapper


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: Sistema -> Configuração -> Clearsale -> Base


Base


Ambiente: Ambiente da Clearsale para onde os pedidos serão enviados.

Selecione “Produção” para o envio de pedidos reais realizados em sua loja.

Cod Integração Clearsale produção: Nesse campo você deverá inserir o nome de usuário de integração da loja fornecido pela Clearsale.

Senha de Integração de Produção: Nesse campo você deverá inserir a senha de integração fornecida pela Clearsale.

Habilitar Log: Habilita ou não o registro de logs (Recomendável habilitar).

Atributo CPF/CNPJ: Campo para mapear qual atributo do Magento é utilizado para informar o CPF/CNPJ do cliente.

Mapeamento de Endereço


Atributo de rua: Campo para mapear qual campo é utilizado para informar o logradouro do endereço em seu checkout.

Número: Campo para mapear qual campo é utilizado para informar o número do endereço em seu checkout.

Complemento: Campo para mapear qual campo é utilizado para informar o complemento do endereço em seu checkout.

Bairro: Campo para mapear qual campo é utilizado para informar o bairro do endereço em seu checkout.

Filtros


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 boleto: Campo para mapear quais meios de pagamento da loja correspondem com Boleto Bancário.

Forma de pagamento por paypal: Campo para mapear quais meios de pagamento da loja correspondem com PayPal.

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 transferência bancária: Campo para mapear quais meios de pagamento da loja correspondem com Transferência Bancária.

Fingerprint

O módulo do fingerprint é responsável por identificar e detectar o dispositivo que está sendo utilizado para realizar a compra na loja.


Google Tag Manager: Campo para ativar o Google Tag Manager caso você o possua em sua loja.

Nome do App: Campo onde é preenchido o código do app do Fingerprint fornecido pela Clearsale.

Mapper

O módulo do Mapper é responsável por mapear o comportamento de navegação do usuário nas páginas da loja.


App code: Campo onde é preenchido o código do app do Mapper fornecido pela Clearsale. Esse código é o mesmo do fingerprint

Realtime Decision


Habilitar: Habilita ou não o módulo Clearsale RealTime Decision.

Métodos de pagamento: Campo para escolher quais meios de pagamento o módulo irá permitir ser realizada a análise.

Status das ordens a serem aprovadas: Campo para escolher qual será o status do pedido enquanto está na fila para ser aprovado pela Clearsale.

Status do pedido após ser aprovado: Campo para escolher qual será o status do pedido após a aprovação da Clearsale.

Frequência da cron: Campo para alterar a frequência de execução da cron de envio de pedidos para análise.

Nome do método de pagamento por cartão de crédito: Campo para escolher qual meio de pagamento da loja representa a forma de pagamento Cartão de crédito.

Nome do método de pagamento por Boleto: Campo para escolher qual meio de pagamento da loja representa a forma de pagamento por Boleto.

Nome do método de pagamento por Débito Bancário: Campo para escolher qual meio de pagamento da loja representa a forma de pagamento Débito bancário.

Nome do método de pagamento por Débito por dinheiro: Campo para escolher qual meio de pagamento da loja representa a forma de pagamento Débito por dinheiro.

Nome do método de pagamento por Débito por cheque: Campo para escolher qual meio de pagamento da loja representa a forma de pagamento Débito por cheque.

Nome do método de pagamento por Transferência: Campo para escolher qual meio de pagamento da loja representa a forma de pagamento Transferência.

Nome do método de pagamento por Sedex a cobrar: Campo para escolher qual meio de pagamento da loja representa a forma de pagamento Sedex a cobrar.

Nome do método de pagamento por Cheque: Campo para escolher qual meio de pagamento da loja representa a forma de pagamento Cheque.

Nome do método de pagamento por Dinheiro: Campo para escolher qual meio de pagamento da loja representa a forma de pagamento Dinheiro.

Nome do método de pagamento por Financiamento: Campo para escolher qual meio de pagamento da loja representa a forma de pagamento Financiamento.

Nome do método de pagamento por Cupom: Campo para escolher qual meio de pagamento da loja representa a forma de pagamento Cupom.

Nome do método de pagamento por Fatura: Campo para escolher qual meio de pagamento da loja representa a forma de pagamento Fatura.

Nome do método de pagamento por Multicheque: Campo para escolher qual meio de pagamento da loja representa a forma de pagamento Multicheque.

Nome do método de pagamento por Vale: Campo para escolher qual meio de pagamento da loja representa a forma de pagamento Vale.

Nome do método de pagamento por Débito parcelado: Campo para escolher qual meio de pagamento da loja representa a forma de pagamento Débito parcelado.

Nome do método de pagamento por Vale desconto: Campo para escolher qual meio de pagamento da loja representa a forma de pagamento Vale desconto.

Profiler

O módulo do Profiler é responsável pelo envio dos eventos realizados na conta do usuário na loja como criação e alteração dos dados do cadastro, login/logout e reset de senha.


Nome do campo de cpf/cnpj Campo para mapear qual atributo do Magento é utilizado para CPF/CNPJ para cliente.

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.


    URL_DA_LOJA + /clearsaleRealTimeDecision/index/notificate


Exemplo:

    http://sitedaloja.com.br/clearsaleRealTimeDecision/index/notificate


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.


   


   

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 você nos informe qual foi a finalização do mesmo através deste serviço.


Configuration

The Magento 1 module for Realtime product consists of 5 submodules. Are they:


    Base

    Profiler

    RealTime Decision

    Fingerprint

    Mapper


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: Sistema -> Configuração -> Clearsale -> Base


Base


Ambiente: Clearsale environment where orders will be shipped.

Select "Production" to ship actual orders placed in your store.

Cod Integração Clearsale produção: In this field you must enter the store integration username provided by Clearsale.

Senha de Integração de Produção: In this field you must enter the integration password provided by Clearsale.

Habilitar Log: Enables or disables logging (Recommended to enable).

Atributo CPF/CNPJ: Field to map which Magento attribute is used to inform the client's CPF / CNPJ.

Address Mapping


Rua: Field to map which field is used to inform the address of your checkout address.

Número: Field to map which field is used to enter the address number at your checkout.

Complemento: Field to map which field is used to enter the address complement in your checkout.

Bairro: Field to map which field is used to inform the neighborhood of the address at your checkout.

Filters


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 boleto: Field to map which store payment methods correspond with Bank Slip.

Forma de pagamento por paypal: Field to map which store payment methods correspond with PayPal.

Forma de pagamento por depósito bancário: Field to map which store payment methods correspond with Bank Deposit.

Forma de pagamento por transferência bancária: Field to map which store payment methods correspond with Bank Tranfer.

Fingerprint

The fingerprint module is responsible for identifying and detecting the device being used for in-store purchase.


Google Tag Manager: Field to enable Google Tag Manager if you have it in your store.

Nome do App: Field where Fingerprint app code provided by Clearsale is populated.

Mapper

The Mapper module is responsible for mapping user browsing behavior on store pages.


App code: Field where the Mapper app code provided by Clearsale is populated. This code is the same as the fingerprint.

Realtime Decision


Habilitar: Enables or disables the Clearsale RealTime Decision module.

Métodos de pagamento: Field to choose which means of payment the module will allow to perform the analysis.

Status das ordens a serem aprovadas: Field to choose what will be the order status while queuing to be approved by Clearsale.

Status do pedido após ser aprovado: Field to choose what will be the order status after Clearsale approval.

Frequência da cron: Field to change how often the order submission cron runs for analysis.

Nome do método de pagamento por cartão de crédito: Field to choose which store payment method represents the payment method Credit Card.

Nome do método de pagamento por Boleto: Field to choose which store payment method represents the form of payment by Boleto.

Nome do método de pagamento por Débito Bancário: Field for choosing which store payment method represents the payment method Bank debit.

Nome do método de pagamento por Débito por dinheiro: Field to choose which store payment method represents the payment method Debit for cash.

Nome do método de pagamento por Débito por cheque: Field to choose which store payment method represents the form of payment Debit by check.

Nome do método de pagamento por Transferência: Field for choosing which store payment method represents the Transfer payment method.

Nome do método de pagamento por Sedex a cobrar: Field to choose which store payment method represents the Sedex payment method to charge.

Nome do método de pagamento por Cheque: Field to choose which store payment method represents the payment method Check.

Nome do método de pagamento por Dinheiro: Field to choose which store payment method represents the payment method Money.

Nome do método de pagamento por Financiamento: Field to choose which store payment method represents the payment method Funding.

Nome do método de pagamento por Cupom: Field to choose which store payment method represents the Coupon payment method.

Nome do método de pagamento por Fatura: Field to choose which store payment method represents the Invoice payment method.

Nome do método de pagamento por Multicheque: Field to choose which store payment method represents the Multicheque payment method.

Nome do método de pagamento por Vale: Field for choosing which store payment method represents the Vale payment method.

Nome do método de pagamento por Débito parcelado: Field to choose which store payment method represents the payment method Debit in installments.

Nome do método de pagamento por Vale desconto: Field to choose which store payment method represents the payment method Discount voucher.

Profiler

The Profiler module is responsible for sending the events held in the store user account as creation and modification of registration data, login/logout and password reset.


Nome do campo de cpf/cnpj Field to map which Magento attribute is used for CPF/CNPJ for client.

Status Update Notification

Whenever an order status changes, Clearsale Webhook will send a notification to a URL.


    STORE_URL + /clearsaleRealTimeDecision/index/notificate


Exemplo:

    http://sitedaloja.com.br/clearsaleRealTimeDecision/index/notificate


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.


   


   

Status Update

The other tab of the ordering screen refers to the payment status update.

If in your business rule payment processing occurs after order submission and decision Clearsale, you may let us know how it was completed through this service.