Guia do usuário Módulo Stone V2
Sumário Apresentação 3 Quais são os pré-requisitos? 3 Como configurar? 3 Configurações Gerais do Módulo Stone 4 Stone Cartão de Crédito 5 Boleto Stone 8 Perguntas frequentes 9 Quais bandeiras são suportadas pelo módulo? 9 O módulo possibilita testes com ambiente sandbox da Stone? 9 Não possuo as chaves necessárias para a configuração do código e chave, o que devo fazer? 9 O módulo permite emitir segunda via do Boleto? 9 Este módulo possui conciliação bancária (quando o boleto for pago o status do pedido muda)? 9 Este módulo permite comprar pelo Admin? 9 Este módulo exibe o link de boleto na página de sucesso de compra? 9 Quais versões do Magento são suportadas? 9 Posso utilizar o mesmo módulo em várias lojas? 10 O que é capturar x autorizar? 10 Por que devo utilizar a opção Capturar? 10 Por que devo utilizar a opção Autorizar? 10 E se eu habilitar o anti fraude da Stone? 10
Apresentação O módulo Stone para Magento versão 1.x, permite que você integre sua loja Magento com a adquirente/gateway Stone e venda utilizando Cartão de Crédito e Boleto. O módulo possui conciliação das transações, ou seja, assim que seu cliente pagar um Boleto, sua loja será notificada do pagamento. Além disso, permite que compras através do painel administrativo sejam efetuadas bem como cancelamentos diretamente pelo Admin de sua Loja. A versão 2 do módulo, além de adicionar a opção de pagamento com boleto, integra também as informações do pedido junto a plataforma da Stone para operar com a opção de Anti Fraude, funcionalidade lançado pela Stone no início de 2017. Quais são os pré-requisitos? Você precisa do Merchant Key, enviados pela Stone após a contratação do mesmo, caso não o receba, solicite. Para obter essas informações, você precisa contratar os serviços da Stone: http://www.stone.com.br/ Como configurar? Para configurar acesse: Admin -> Sistema -> Configuração -> Vendas -> Meios de Pagamento Configurações Gerais do Módulo Stone
Ambiente: - Escolha o ambiente que se encontra sua conta, em Produção ou Testes (Desenvolvimento); Merchant Key: - Merchant Key passado pela Stone quando aprovado seu cadastro para poder realizar a integração; Antifraude: - Caso tenha contratado o plano de antifraude da Stone, você pode habilitar esta opção para enviar as informações do pedido para a Stone e utilizar o fluxo de aprovação do pedido automático pelo Antifraude; Rua: - Campo de endereço do Magento para ser enviado como Rua para o antifraude; Número: - Campo de endereço do Magento para ser enviado como Número para o antifraude; Complemento: - Campo de endereço do Magento para ser enviado como Complemento para o antifraude; Bairro: - Campo de endereço do Magento para ser enviado como Bairro para o antifraude; CPF/CNPJ: - Campo do cadastro do Cliente do Magento para ser enviado como CPF/CNPJ para o antifraude; Telefone: - Campo de endereço do Magento para ser enviado como Telefone para o antifraude; Celular: - Campo de endereço do Magento para ser enviado como Celular para o antifraude; Telefone do Trabalho: - Campo de endereço do Magento para ser enviado como Telefone do Trabalh para o antifraude;
Stone Cartão de Crédito Habilitado: - Habilita ou desabilita a compra com cartão de crédito;; Título: - O título que será mostrado ao cliente na finalização da compra; Bandeiras de cartão: - Escolha quais bandeiras serão permitidas para sua Loja (pressione a tecla CTRL para a escolha de mais de uma bandeira, ao clicar); Descrição na Fatura: - Nome customizado que aparecerá na fatura do cliente nas transações de cartão (máximo 35 caracteres); Número máximo de parcelas: - Até quantas parcelas sua loja irá permitir a compra; Valor mínimo para cada parcela: - Lembre-se de verificar com a Stone se há valor mínimo de parcelas para compra;
Operação: - Está opção está relacionada ao fluxo de compra: - Capturar: Com essa opção selecionada, ao finalizar o pedido, o mesmo será capturado imediatamente direto do cartão de crédito do cliente; - Autorizar: Com essa opção, é apenas reservado o valor de compra no cartão do cliente, porém sem capturar. Isso permite que você cancele o pedido sem problemas ou capture horas depois, caso tenha passado por um processo de validação do pedido. Ao gerar a fatura (invoice) no painel do Magento, a captura online será realizado, registrando assim a compra no cartão de crédito do cliente; - Observação 1 : Se você utilizar a opção Autorizar, você terá que realizar a captura da compra no cartão de crédito manualmente, utilizando a opção de Faturar (online) o pedido no painel administrativo do Magento ou realizar o Cancelamento do pedido pelo painel do Magento; - Observação 2 : Quando a opção antifraude está habilitada, automaticamente o pedido seguirá o seguinte passo: Autorizar a transação -> Verificar no Antifraude a compra -> Capturar a compra ou Cancelar a compra. Ou seja, fará o mesmo que a configuração Autorizar, porém de forma automática.
Boleto Stone Habilitado: - Habilita ou desabilita a compra com Boleto Stone; Título: - O título que será mostrado ao cliente na finalização da compra; Dias Vencimento: - Dias adicionais que será gerado a data de vencimento do Boleto Stone; Instruções: - Uma frase que será apresentada ao cliente com instruções sobre o Boleto, como por exemplo sobre prazos de validade ou impressão.
Perguntas frequentes - Quais bandeiras são suportadas pelo módulo? - R: As bandeiras suportadas pela Stone são VISA e MASTERCARD. - O módulo possibilita testes com ambiente sandbox da Stone? - Sim, veja as Configurações Gerais do módulo para saber como habilitar essa opção. - Não possuo as chaves necessárias para a configuração do código e chave, o que devo fazer? - Você deve entrar em contato com a Stone para obter tais informações, como a Merchant Key (obrigatória para funcionamento da integração). - O módulo permite emitir segunda via do Boleto? - Sim, quando um cliente efetua uma compra via Boleto, o link de impressão é apresentado na finalização da compra e enviado para o cliente via e-mail, sendo possível a impressão a qualquer momento. Apresenta também o link do Boleto no painel administrativo, dentro do pedido, porém sem alterar a data de vencimento do boleto. - Este módulo possui conciliação bancária (quando o boleto for pago o status do pedido muda)? - Sim, ao receber a notificação de que o Boleto foi pago, o status do pedido no Magento receberá o status Aprovado, bem como um comentário do Pagamento. O mesmo ocorre para transações de cartão de crédito. - Este módulo permite comprar pelo Admin? - Sim, as formas de pagamento habilitadas do módulo Stone aparecerão ao criar um pedido pelo painel administrativo. - Este módulo exibe o link de boleto na página de sucesso de compra? - Sim, o módulo adiciona o bloco de informações de pagamento na página de sucesso, incluindo o link de Boleto. Porém, deve-se tomar cuidado com a compatibilidade do tema, caso não exibir link do boleto, você deverá pedir para seu desenvolvedor corrigir ou informá-lo para adicionar o seguinte código no success.phtml: <?php echo Mage::app()->getLayout()->createBlock( trezo_stone/onepage_success', 'trezo_stone', array('template' => 'trezo_stone/success.phtml'));?> - Observação : É recomendável que seja customizado o layout do link de boleto, já que é exibido sem estilo na página. - Quais versões do Magento são suportadas? - O módulo foi testado com as versões 1.7.x, 1.8.x, 1.9.x, porém versões inferiores podem ser suportadas. Vale ressaltar que este módulo é NÃO é compatível com versões 2.x do Magento.
- Posso utilizar o mesmo módulo em várias lojas? - Não. Cada loja precisa de uma licença. Portanto, é necessário comprar um módulo para cada loja Magento. Leia nossas regras: - https://www.mageup.com/termos-e-condicoes - O que é capturar x autorizar? - Nas opções de compra com cartão de crédito há 2 fases da compra: 1. Autorização : Momento que é verificado se o cartão é válido, seguido pela verificação do limite do cartão de crédito se é o suficiente para a compra, terceiro é utilizado como uma reserva da compra. Porém, nesse momento, ainda não existe a transação e a compra não é exibida na fatura do cliente, dessa forma, permitindo cancelar a transaão sem dor de cabeça ou seguir para o próximo passo que é a captura. 2. Captura : Nesse momento, após a autorização da compra, é possível você capturar a transação do cartão de crédito, tornando-a oficial e registrando a compra na fatura do cartão. Sabendo disso, no fluxo de compra, você pode optar pela opção de capturar automáticamente após a autorização da compra (opção Capturar do módulo) ou realizar a captura posterior (manualmente) utilizando-se da opção Autorizar do módulo. - Por que devo utilizar a opção Capturar? - Essa opção é recomendada quando não há a necessidade de verificação ou validação da compra antes de realizar a captura. Digamos que você venda para um público específico já pré-aprovado com cadastro ou venda um produto que impossibilita a tentativa de fraude. - Por que devo utilizar a opção Autorizar? - No mercado brasileiro, principalmente, há um indíce de fraude e tentativa de compras com cartões clonados/roubados muito grande, com isso, há a necessidade de se precaver com uma verificação da compra, utilizando algum serviço de anti-fraude (como o clearsale start, por exemplo). Dessa forma, você permite que o cliente realize a compra mas sem registrar em sua fatura, após uma verificação minuciosa, seja manual ou por algum serviço de antifraude, você então gera manualmente a fatura do pedido pelo admin, consequentemente realizando a captura da compra. - E se eu habilitar o anti fraude da Stone? - No caso de você habilitar o anti fraude da Stone, as suas transações serão automaticamente de autorizar, independente se sua configuração estiver como capturar, pois dessa forma o anti fraude da Stone avaliará a compra e se não aprovada realizará o cancelamento, sem necessidade de estorno, ou realizará a captura se aprovado.