pagseguro / pagseguro-modulo-prestashop

Módulo de Checkout Transparente para integração com PrestaShop 1.6, 1.7 e 8.0 - Oficial PagBank
Open Software License 3.0
50 stars 92 forks source link
pagbank pagseguro prestashop prestashop-1-6 prestashop-1-7 prestashop-8 prestashop-module prestashop-payment

PagBank - Checkout Transparente - v.1.7.2

Taxas Reduzidas!

Dúvidas, Sugestões, Suporte

Você está com dúvidas, gostaria de sugerir algum novo recurso ou precisa de suporte técnico?

Enviar mensagem

Novo Módulo disponível!

O módulo PagSeguroPro foi descontinuado e substituído pelo novo módulo PagBank. Para atualizar o módulo em sua loja basta seguir o passo-a-passo de instalação e em seguida desativar o módulo PagSeguroPro.

Introdução

Através do módulo PagBank oferecemos total integração da sua loja PrestaShop com a melhor solução de pagamentos do Brasil.

Este módulo foi desenvolvido rigorosamente dentro dos padrões de segurança PCI DSS (Padrão de Segurança de Dados da Indústria de Pagamento com Cartão) e boas práticas de desenvolvimento recomendadas pela PrestaShop, com o objetivo de simplificar e agilizar o processo de Checkout. Não importa o seu ramo de atividade, este módulo irá potencializar suas vendas otimizando a experiência de compra do seu cliente em sua loja virtual.

Compatibilidade

Instalação ou Atualização

Extraia o arquivo "pagseguro-modulo-prestashop-master.zip" em seu computador.

Acesse a Aba "Módulos > Gerenciador de Módulos", clique em "Enviar um módulo", e envie o arquivo "pagbank.zip".

Pronto, o módulo está instalado!

Dica:

Sempre que você instalar ou atualizar o módulo, acesse a tab "Parâmetros Avançados > Desempenho" e clique em "Limpar Cache". Isso irá garantir que todos os arquivos sejam atualizados no cache da PrestaShop.

Ao atualizar o módulo não é preciso refazer a Configuração de Cadastro/Adesão App, durante a atualização as configurações salvas no módulo ficam intactas.

Configuração

1 - Cadastro/Adesão App

O cadastramento no App é o primeiro passo para tornar a sua integração funcional. São três opções disponíveis para cadastro:

O processo de adesão é muito simples, basta clicar em "Cadastrar" e seguir o passo-a-passo indicado.


2 - Configurações do App

Após se cadastrar no(s) App(s) desejado(s), marque a opção "Ambiente de Produção" como SIM e no campo "Tipo de Credencial" selecione qual App deve validar e processar os pagamentos.


3 - Configurações de Pagamento

O módulo disponibiliza três opções de pagamento via Checkout Transparente:

3.1 - Cartão de Crédito

Marque a opção "Cartão de Crédito" como SIM para ativar o meio de pagamento e visualizar as configurações relacionadas.

3.1.1 - Cartão de Crédito - Compra com 1 Click

Na opção "Compra com 1 Click", o cliente poderá salvar o Cartão de Crédito para futuras compras. O Cartão é criptografado e armazenado pelo PagBank através do processo de Tokenização.

Após realizar a primeira compra com o cartão salvo ele ficará disponível para seleção na tela de checkout, exemplo:

3.1.2 - Cartão de Crédito - Tipo de Captura - Automática ou Manual (Pré-autorização)

Na opção de Captura Automática o valor total da transação é debitado imediatamente do saldo do cartão de crédito, todo o processo é automatizado.

Na opção de Captura Manual (Pré-autorização) o valor total da transação fica reservado no saldo do cartão de crédito, aguardando uma ação para processar um valor parcial ou total da transação. Por exemplo, se o valor total da transação for R$ 1.000,00 e você decidir capturar R$ 800,00 os R$ 200,00 restantes será devolvido automaticamente para o saldo do cartão de crédito.

Com o pedido gerado na loja, com o status de Pagamento Autorizado, é só acessar o histórico do pedido e informar um valor parcial ou total que você deseja debitar do cartão de crédito, exemplo:

3.2 - Boleto Bancário

Marque a opção "Boleto Bancário" como SIM para ativar o meio de pagamento e visualizar as configurações relacionadas.

Nota:

Não esqueça de configurar a Tarefa Cron para o cancelamento do Boleto.

3.3 - PIX

Marque a opção "PIX" como SIM para ativar o meio de pagamento e visualizar as configurações relacionadas.

Nota:

Não esqueça de configurar a Tarefa Cron para o cancelamento do PIX.

3.4 - Opções de Descontos

No Cartão e Crédito o desconto é calculado e exibido na primeira parcela.


4 - Status de Pedido - Mapeamento

Para facilitar o gerenciamento do pedido disponibilizamos a opção de mapeamento de Status. Desta forma você poderá criar status customizados que servirão especificamente para essa finalidade.

Após criar os Status customizados na PrestaShop - no Menu "Compras > Status" - basta acessar a configuração do módulo para fazer a associação.

Os Status disponíveis são:


5 - Debug & Logs

5.1 - Debug para soluções de problemas

Para uma análise técnica mais aprofundada, a fim auxiliar no desenvolvimento ou identificar eventuais conflitos de JavaScript na loja virtual, marque a opção "Exibir parâmetros no Console do navegador?" como SIM.

Dica:

Sempre que você instalar ou atualizar o módulo, acesse a tab "Parâmetros Avançados > Desempenho" e clique em "Limpar Cache". Isso irá garantir que todos os arquivos sejam atualizados no cache da PrestaShop.

5.2 - Registro de Transações & Gerenciamento de Logs

Marque a opção "Gerar LOGs completos?" como SIM para que o módulo registre tudo o que é enviado e recebido entre a sua loja e o PagBank.

Para vistualizar os registros de Logs acesse "PagBank > PagBank - Logs", clique em "Ver" para analisar detalhes do que foi enviado e recebido entre a sua loja e o PagBank.

Dica:

O Código de Referência da transação no PagBank é composto pelo ID do Carrinho + APP utilizado + Número randômico, exemplo:

Código de Referência: 78895.TAX.177850

Nota:

  • Dados sensíveis ao cliente como endereço, nome e sobrenome ou razão social, cpf/cnpj e telefone ou celular não são armazenados em Log.
  • Todas as transações via Cartão de Crédito são Tokenizadas e não são armazenadas em Log.

Para maiores detalhes a respeito do pedido acesse "PagBank > PagBank - Transações", clique em "Ver". As mesmas informações também estão disponíveis no histórico do pedido (consulta em tempo real entre a sua loja e o PagBank).

5.3 - Limpeza do Banco de Dados

A opção "Apagar tabelas do banco?" deve permanecer sempre desativada. Apenas marque a opção como SIM caso deseje desinstalar o módulo.

Com esta opção ativa todos os registros de transações (informações básicas sobre o pedido, como: ID do pedido na loja e PagBank, ID cliente, ID carrinho, etc.) e principalmente o registro de Logs (todo o registro técnico da comunicação entre a loja e API do PagBank) serão completamente removidos do Banco de Dados da sua loja.

Este recurso serve para evitar a perda de dados ao desinstalar o módulo por acidente ou durante uma atualização da própria loja.


6 - Tarefa CRON

A Tarefa Cron serve para cancelar os pedidos que não forem pagos dentro do prazo estipulado para Boleto Bancário e Pix, também é útil para o seu gerenciamento de estoque. Para configurar a Tarefa Cron entre em contato com o suporte técnico do seu servidor de hospedagem e informe as URLs geradas para a sua loja.


7 - Extra - Estorno Parcial ou Total de um Pedido

Na PrestaShop, no menu "Compras ou Pedidos", acesse o pedido a ser estornado, role a página até localizar "DADOS DO PEDIDO (PAGBANK)". Ao clicar em "Estornar Transação no PagBank", em tempo real, o módulo transmitirá a requisição para o PagBank.

Após realizar o estorno, dentro de alguns segundos, o pedido receberá uma notificação para a troca de status. Pedidos com estorno Total recebem o status mapeado como Cancelado e para estorno Parcial recebe o status mapeado como Estornado.

Para mais detalhes sobre o pedido estornado acesse a sua conta no PagBank, no menu, "Extratos e Relatórios > Extrato de Transações".

Ao acessar a transação role a página para localizar "Extrato de movimentações da transação".

Link de acesso

https://minhaconta.pagseguro.uol.com.br/meu-negocio/extrato-de-transacoes

Atenção

Só é possível realizar o estorno se o pedido estiver em um destes status:


CHANGELOG

v.1.0.0

v.1.1.0

v.1.2.0

v.1.3.0

v.1.3.1

v.1.4.0

v.1.5.0

v.1.5.1

v.1.5.2

v.1.5.3

v.1.6.0

v.1.6.1

v.1.7.0

v.1.7.1

v.1.7.2