Módulo 1.6

Introdução

Através do módulo PagSeguroPro 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 para a Indústria de Cartões de Pagamento) 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

  • Este módulo não utiliza Override;
  • Compatível com o todas as versões da série 1.6.x da PrestaShop;
  • Testado e desenvolvido com base na API v.2 e v.3 do PagSeguro;
  • Compatível com PHP 5.4.x à 7.4.33;
  • Requer a biblioteca cURL ativa na hospedagem.
  • Obrigatório o uso de certificado SSL com o protocolo TLS 1.2 ou superior;

Instalação

Extraia o arquivo .ZIP em seu computador e envie a pasta do módulo desejado para o diretório /modules/ no FTP da sua loja.

Em seguida, acesse a Aba Módulos, localize o módulo pesquisando por "pagseguropro" e clique no botão "Instalar".

"Instalação - Módulo PagSeguroPro")

1368

Configuração


1 - Ativação

E-mail & Token

A Ativação, E-mail & Token são os primeiros passos para tornar a sua integração funcional. Após se cadastrar e formalizar a contratação do serviço junto ao PagSeguro, você receberá um Token que será utilizado para referenciar a sua conta e validar os pagamentos processados.

Com os dados em mãos basta marcar a opção Ambiente de Produção como SIM e em seguida, no campo Tipo de Credenciais, selecionar a opção Padrão (E-mail + Token) e copiar e colar o seu E-mail de cadastro e o seu Token nos campos indicados abaixo.

"Configuração - Ativação, E-mail & Token - Módulo PagSeguroPro")

1368
Parceria (Recebimento em 14 ou 30 dias)

Você também pode optar por utilizar o modelo de parceria. O processo de adesão é muito simples, basta clicar em "Assine Já!" e seguir o passo-a-passo indicado.

"Configuração - Ativação, E-mail & Token - Parceria - Módulo PagSeguroPro")

1368

Passo-a-passo de Adesão

"Configuração - Ativação, E-mail & Token - Parceria - Módulo PagSeguroPro")

1368

Após assinar uma ou as duas parcerias oferecidas, nas configurações do módulo, vá até o campo Tipo de Credenciais e selecione qual das parcerias deve validar e processar os pagamentos.

"Configuração - Ativação, E-mail & Token - Parceria - Módulo PagSeguroPro")

1368

2 - Opções de Pagamento

O módulo disponibiliza 3 opções de pagamento via Checkout Transparente:

  • Cartão de Crédito

"Configuração - Opções de Pagamento - Cartão de Crédito - Módulo PagSeguroPro")

814
  • Boleto Bancário

"Configuração - Opções de Pagamento - Boleto Bancário - Módulo PagSeguroPro")

79
  • Débito Online

"Configuração - Opções de Pagamento - Débito online - Módulo PagSeguroPro")

301

Marque a opção como SIM para ativar o meio de pagamento em sua loja:

"Configuração - Opções de Pagamento - Módulo PagSeguroPro")

1368

❗️

Atenção:

Não se esqueça de verificar se o meio de pagamento está ativo em sua conta no PagSeguro.

https://pagseguro.uol.com.br/preferences/receiving.jhtml

3 - Configurações de Pagamento: Parcelamento

  • Defina o máximo de parcelas aceitas pela loja, coloque 1 para à vista ou de 2 até 12 parcelas.

  • Defina a quantidade de parcelas sem juros, coloque de 1 até 12 parcelas.

  • Defina o valor da parcela mínima aceita pela loja.

  • Defina o comportamento da parcela mínima aceita pela loja.

"Configuração - Parcelamento - Módulo PagSeguroPro")

1368

Observação:

A taxa de juros pode variar de acordo com o teto de faturamento da loja ou a sua negociação contratual junto ao PagSeguro.


4 - Configurações de Pagamento: Desconto no Boleto Bancário

Na opção "Desconto no Boleto Bancário?" você pode definir se o Boleto Bancário irá receber um desconto em percentual ou valor fixo, além da opção "Nenhum Desconto".

"Configuração - Desconto no Boleto Bancário - Módulo PagSeguroPro")

1368

Após definir o tipo de desconto aplicado no Boleto Bancário basta definir o valor, exemplo: 5.00.


5 - 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:

  • Pagamento Autorizado
  • Pedido Cancelado
  • Pedido Estornado
  • Pagamento em Análise
  • Aguardando Pagamento do Boleto

"Configuração - Status de Pedido - Módulo PagSeguroPro")

❗️

Atenção:

Existem 02 formas de cancelar um pedido:

a) Na PrestaShop, no menu "Compras ou Pedidos", acessando o pedido em questão, role a página até localizar "DADOS DO PEDIDO (PAGSEGURO)". Clique no botão "Cancelar Pedido" e em tempo real o módulo transmitirá a requisição para o PagSeguro.

b) Diretamente em sua conta no PagSeguro em "Extrato de Transações". Ao cancelar o pedido o PagSeguro irá transmitir para a sua loja a requisição de cancelamento que receberá o Satus Mapeado no módulo.

https://pagseguro.uol.com.br/transaction/search.jhtml

6 - Debug para soluções de problemas

Para determinar se o módulo está funcional, sem nenhum tipo de problema de JavaScript, marque a opção "Exibir parâmetros no Console do navegador?" como SIM.

"Configuração - Debug para soluçoes de problemas - Módulo PagSeguroPro")

1368

Após a checagem acima vá até a tela de Checkout da Loja, acesse o Inspetor de Elementos do
Navegador pressionando “CTRL+Shift+i” ou F12.

Ao abrir o Inspetor de Elementos, clique na tab “Console” e verifique se estão presentes as
seguintes informações:

  • SessionID
  • SenderHash
  • paymentMethods
  • installments
  • valorPedido

Com as 05 informações disponíveis no Console do Inspetor de Elementos do Navegador,
significa que não houve problemas de conflitos interferindo no funcionamento do JavaScript
do módulo, e a Loja está pronta para processar pagamentos.

Observações:

a) Demais informações como “Token do Cartão de Crédito” não estão disponíveis por
motivos de segurança.

b) Para consultar o valor do pedido comece a digitar “valorPedido”, vide print do
exemplo abaixo.

Exemplo na Prática:

"Configuração - Debug para soluçoes de problemas - Módulo PagSeguroPro")

1312

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

1024

Marque a opção como SIM para que o módulo registre tudo o que é enviado e recebido entre a sua loja e o PagSeguro.

"Configuração - Registro & Gerenciamento de Logs - Módulo PagSeguroPro")

1368

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

"Configuração - Registro & Gerenciamento de Logs - Módulo PagSeguroPro")

1024

Para maiores detalhes a respeito do pedido acesse "Compras > PagSeguro - 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 PagSeguro).

"Configuração - Registro & Gerenciamento de Logs - Módulo PagSeguroPro")

1024

8 - 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 PagSeguro, 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 PagSeguro) 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.

"Configuração - Limpeza do Banco de Dados - Módulo PagSeguroPro")

1368

9 - 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 (PAGSEGURO)". Ao clicar em "Estornar Transação no PagSeguro", em tempo real, o módulo transmitirá a requisição para o PagSeguro.

Após realizar o estorno, para mais detalhes acesse a sua conta no PagSeguro, 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:

  • 3 - Pagamento confirmado
  • 4 - Valor disponível
  • 5 - Em disputa

CHANGELOG

v.1.0.0

  • Lançamento;

v.1.1.0

  • Add modelo de aplicação para adesão de parceria;
  • Add opção para estorno integral e parcial do pagamento já aprovado;

v.1.1.1

  • Melhorias diversas e correções gerais de bugs;

v.1.1.2

  • Correções gerais de bugs;

v.1.1.3

  • Fix Bug renderView AdminPagSeguroProController;
  • Fix Bug GetInstallments/installmentValue;

v.1.1.4

  • Fix Bug templateVars updateOrderStatus;
  • Fix Bug callback updateOrderStatus p/ Boleto Pendente (Status 2 - Aguardando Pgto);
  • Fix data_pedido (sql) p/ formato 24hs;
  • Add novo Logo do PagSeguro;

v.1.1.5

  • Fix Bug callback updateOrderStatus p/ Boleto Pendente (Status 2 - Aguardando Pgto);

v.1.1.6

  • Fix Bug cancelTransaction;
  • Fix Bug refundTransaction;
  • Add opção p/ mapear o status de reembolso (Status 6 - Reembolsado);

v.1.1.7

  • Ajustes, melhorias e correções no layout Back/Front - Desk/Mobile;
  • Add status fixo de "Boleto Bancário" para o Cliente/Comprador;
  • Add verificador para orientações sobre UF e SandBox;
  • Add novo Logo do PagSeguro (Versão Final);

v.1.1.8

  • Fix GetInstallments/maxInstallmentNoInterest;

v.1.2.0

  • Maior compatibilidade com padrões de cadastros de CPF;
  • Add opção de Parcela Mínima aceita no cartão;
  • Melhorias e correções gerais de bugs;
  • Fix jQuery CVE-2020-11023;

v.1.3.0

  • Correções gerais de bugs;
  • Add opção p/ definir o comportamento da Parcela Mínima aceita no cartão;
  • Add tutorial para orientar o lojista durante o setup inicial da loja, c/ validações e informações gerais sobre o cadastro do cliente, configurações diversas, etc;
  • Melhorias na validação e criação de histórico local de pedidos que receberem reembolso parcial ou total;
  • Revisão detalhada, melhorias e otimizações na validação dos dados para a interação com o cliente na opção de pagamento via Cartão de Crédito;

v.1.4.0

  • Revisão da modalidade débito online e remoção do banco HSBC;
  • Melhorias e correções;

v.1.5.0

  • Revisão e melhorias no mecanismo de Logs, otimização p/ os métodos Get & Callback;
  • Correção do status duplicado p/ o Boleto Bancário (Status 1 - Aguardando Pgto.);

v.1.5.1

  • Correções gerais de bugs;

v.1.5.2

  • Correções gerais de bugs de Notificação;

v.1.6.0

  • Reformulação da interface de configuração no BackOffice & atualização da Doc;
  • Correção do registro de Logs para Callback pós transacional;
  • Fix deprecated e testes de compatibilidade para o PHP 7.4.33;