Com o módulo instalado e configurado, você pode pode oferecer o PagSeguro como opção de pagamento em sua loja. O módulo utiliza as seguintes funcionalidades que o PagSeguro oferece na forma de APIs:
- Integração com a API de Pagamentos
- Integração com a API de Notificações
- PrestaShop 1.4.5.1 a 1.6.0.9
- PHP 5.4.27+
- SPL
- cURL
- DOM
- Certifique-se de que não há instalação de outros módulos para o PagSeguro em seu sistema;
- Baixe o repositório como arquivo zip ou faça um fork;
- Na área administrativa do seu sistema, acesse o menu Módulos -> Modules -> Add new module, aponte para o caminho do arquivo pagseguro.zip e faça o upload;
- Acesse a categoria Payments & Gateways, localize o módulo PagSeguro e faça a instalação.
Alternativamente, é possível fazer a instalação da seguinte maneira:
- Certifique-se de que não há instalação de outros módulos para o PagSeguro em seu sistema;
- Baixe o repositório como arquivo zip ou faça um fork;
- Copie a pasta pagseguro para dentro da pasta modules em sua instalação PrestaShop;
- Certifique-se de que as permissões das pastas e arquivos recém copiados sejam, respectivamente, definidas como 755 e 644;
- Acesse a categoria Payments & Gateways, localize o módulo PagSeguro e faça a instalação
Para acessar e configurar o módulo acesse o menu Módulos -> Modules -> Payments & Gateways -> PagSeguro -> Configure. As opções disponíveis estão descritas abaixo.
- configuração nesta tela são definidas as configurações para o funcionamento do módulo
- e-mail: e-mail cadastrado no PagSeguro.
- token: token cadastrado no PagSeguro.
- charset: codificação do seu sistema (ISO-8859-1 ou UTF-8).
- checkout: especifica o modelo de checkout que será utilizado. É possível escolher entre checkout padrão, checkout lightbox e checkout transparente.
- url de notificação: sempre que uma transação mudar de status, o PagSeguro envia uma notificação para sua loja ou para a URL que você informar neste campo. Obs.: Esta URL é informada automaticamente e você só deve alterá-la caso deseje receber as notificações em outro local.
- url de redirecionamento: ao final do fluxo de pagamento no PagSeguro, seu cliente será redirecionado automaticamente para a página de confirmação em sua loja ou então para a URL que você informar neste campo. Para ativar o redirecionamento ao final do pagamento é preciso ativar o serviço de Pagamentos via API. Obs.: Esta URL é informada automaticamente e você só deve alterá-la caso deseje que seus clientes sejam redirecionados para outro local.
- geração de log: ativa/desativa a geração de logs.
- diretório: informe o local a partir da raíz de instalação do PrestaShop onde se deseja criar o arquivo de log. Ex.: /logs/ps.log. Caso não informe nada, o log será gravado dentro da pasta ../PagSeguroLibrary/PagSeguro.log.
- transações abandonadas: ativa/desativa a pesquisa de transações que foram abandonadas no checkout do PagSeguro.
- conciliação: permite consultar as transações efetivadas no PagSeguro nos últimos 30. A pesquisa retornará um comparativo com o status das transações em sua base local e o status atual da transação no PagSeguro, desta forma você pode identificar e atualizar transações com status divergentes.
- dias: número de dias que devem ser considerados para a pesquisa de conciliação.
- abandonadas permite consultar as transações que foram abandonadas nos últimos 10 dias, desta forma você pode enviar email-s de recuperação de venda. O e-mail conterá um link que redirecionará o comprador para o fluxo de pagamento, exatamente no ponto onde ele parou.
- dias: defina a quantidade máxima de dias em que a transação foi abandonada. Ex.: se você definir 8, então somente as transações abandonadas nos últimos 8 dias serão exibidas.
- requisitos: exibe se os pré-requisitos básicos para o correto funcionamento do módulo estão sendo atendidos
| Dados do comprador | Tipo | Esperado |
|---|---|---|
| {Pattern - ^([a-zA-Z0-9_])+([@])+([a-zA-Z0-9_])+([.])+([a-zA-Z0-9_])} | email@email.em | |
| Name / Nome | {String} | Nome |
| Last Name / Sobrenome | {String} | Sobrenome |
| Company / Empresa | {String} | Empresa |
| Address / Endereço | {String, Integer} | Endereço, Numero |
| Address 2 / Bairro /Endereço (Linha 2) | {String} | Bairro |
| PostCode / CEP | {Integer or String} | 99999999 / 99999-999 |
| City / Cidade | {String} | Cidade |
| Country / País | {String} | País |
| State or Province / Estado | {String} | Estado |
| Aditional information / Informações adicionais | {String} | Complemento |
| Phone / Telefone residencial | {Integer} - {DDD+NUMBER} | 99999999999 |
| Cell Phone / Telefone celular | {Integer} - {DDD+NUMBER} | 99999999999 |
Caso tenha dúvidas ou precise de suporte, acesse nosso fórum.
2.2
- Adicionada opção para utilizar o Checkout Transparente. Obs.: Recomenda-se limpar o cache do PrestaShop antes da instalação desta versão.
- Ajustes e melhorias em geral.
2.1
- Possibilidade de consultar e solicitar o cancelamento de transações;
- Possibilidade de consultar e solicitar o estorno de transações;
- Possibilidade de definir descontos com base no meio de pagamento escolhido durante o checkout PagSeguro;
- Integração com Sandbox;
- Ajustes em geral;
- Obs.: As funcionalidades descritas acima ainda não estão disponíveis comercialmente para todos os vendedores. Em caso de dúvidas acesse nosso fórum.
2.0
- Não exibir botão de pagamento quando não houver email/token.
- Tradução enUS.
- Alinhamento de imagem na confirmação de pagamento nas versões 1.5.x.
1.9
- Mudanças no layout do painel de configuração.
- Melhorias no código.
- A versão do módulo agora é informada dentro da tela de configurações, abaixo da marca PagSeguro UOL.
- Ajustes em geral.
1.8
- Mudanças no layout do painel de configuração.
- Possibilidade de consultar transações no PagSeguro para conciliar os status com a base local.
- Adicionado opção para visualização de transações abandonadas, permitindo o envio de email com um link para que o comprador possa continuar o processo de compra de onde ele parou.
- Ajustes em geral.
1.7
- Adicionando opção para utilização do Checkout Lightbox. Obs.: Recomenda-se limpar o cache do PrestaShop antes da instalação desta versão.
1.6
- Atualização da lib PHP no módulo.
- Compatibilidade com a versão 1.4.5.1+ do PrestaShop.
- Verificar se a moeda Real esta ativa, para envio ao PagSeguro.
- Conclusão de pagamento em qualquer moeda.
- Cancelamento do carrinho caso ocorra erro durante checkout.
- Conformidade com PSR-2.
1.5
- Melhorias no tratamento de endereço.
- Ajustes de CSS.
- Não utilizar URLs de localhost para notificação/redirecionamento.
- Verificar se o ambiente atende os requisitos.
- Armazenamento do ID da transação gerada pelo PagSeguro.
1.4
- Compatibilidade com a versão 1.5.4.1 do PrestaShop.
1.3
- Tornando o código compliance com os requisitos do PrestaShop.
1.2
- A URL de notificação passa a ser enviada no parâmetro notificationURL.
- Atualização de biblioteca.
- Melhoria de layout.
- Correção: Remoção de lista de status quando o módulo é removido.
1.1
- Integração com API de Notificação do PagSeguro.
- Adequação da licença.
- Adição da funcionalidade de notificação.
- Adição de tratamento para duplo espaço no nome do comprador.
- Adição de link para fazer cadastro no Pagseguro.
- Alteração da finalização do pagamento. Agora, realizado dentro do ambiente do PagSeguro.
- Correção de quebra do layout padrão do Prestashop na confirmação da compra.
- Correção para recuperação de valores de embrulho e de descontos.
- Correção de redirecionamento de página para url rewrite do PrestaShop.
1.0
- Versão inicial. Integração com API de Pagamento do PagSeguro.
Este módulo inclui software desenvolvido por PagSeguro Internet LTDA (http://www.pagseguro.com.br), licenciado sobre os termos da Apache Software License 2.0.
Este módulo inclui software desenvolvido por PrestaShop SA (http://www.prestashop.com), licenciado sobre os termos da Academic Free License 3.0.
Este módulo inclui software desenvolvido por Nicola Hibbert (http://nicolahibbert.com/liteaccordion-v2), licenciado sobre os termos da MIT License.
- O PagSeguro somente aceita pagamento utilizando a moeda Real brasileiro (BRL).
- Certifique-se que o email e o token informados estejam relacionados a uma conta que possua o perfil de vendedor ou empresarial.
- Certifique-se que tenha definido corretamente o charset de acordo com a codificação (ISO-8859-1 ou UTF-8) do seu sistema. Isso irá prevenir que as transações gerem possíveis erros ou quebras ou ainda que caracteres especiais possam ser apresentados de maneira diferente do habitual.
- Para que ocorra normalmente a geração de logs, certifique-se que o diretório e o arquivo de log tenham permissões de leitura e escrita.
Achou e corrigiu um bug ou tem alguma feature em mente e deseja contribuir?
- Faça um fork.
- Adicione sua feature ou correção de bug.
- Envie um pull request no GitHub.