/magento

Módulo de integração para Magento

Primary LanguagePHP

Módulo de integração PagSeguro para Magento


Descrição


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:

Requisitos


Instalação


  • 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 clone;
  • Copie as pastas app e skin para dentro do diretório de instalação do Magento. Caso seja informado da sobrescrita de alguns arquivos, você pode confirmar o procedimento sem problemas. Esta instalação não afetará nenhum arquivo do seu sistema, somente adicionará os arquivos do módulo PagSeguro;
  • Certifique-se de que as permissões das pastas e arquivos recém copiados sejam, respectivamente, definidas como 755 e 644;
  • Na área administrativa do seu sistema, acesse o menu System -> Cache Management -> Flush Magento Cache.

Configuração


Para acessar e configurar o módulo acesse o menu System -> Configuration -> Payment methods -> PagSeguro. As opções disponíveis estão descritas abaixo.

  • ativar módulo: ativa/desativa o módulo.
  • nome de exibição: define o nome que será utilizado para o meio de pagamento.
  • e-mail: e-mail cadastrado no PagSeguro.
  • token: token cadastrado no PagSeguro.
  • 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.
  • 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.
  • charset: codificação do seu sistema (ISO-8859-1 ou UTF-8).
  • log: ativa/desativa a geração de logs.
  • diretório: informe o local a partir da raíz de instalação do Magento 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.
  • checkout: especifica o modelo de checkout que será utilizado. É possível escolher entre checkout padrão e checkout lightbox.

Dúvidas?


Caso tenha dúvidas ou precise de suporte, acesse nosso fórum.

Changelog


2.2

  • Ajustes no tratamento das notificações, entre outros;

2.1

  • Correção de bugs;

2.0

  • Correção de bug ao finalizar compra quando a instalação possui mais de uma store;

1.9

  • Correção de bug ao finalizar compra quando o compilador do Magento está ativado;

1.8

  • Adicionado opção para utilização do Checkout Lightbox;

1.7

  • Ajustes no tratamento de endereços;

1.6

  • Code cleanup e correção de bug;

1.5

  • Armazenar no Magento o ID da transação feita no PagSeguro;

1.4

  • Verificar se o ambiente atende os requisitos;
  • Não utilizar URLs de localhost para notificação/redirecionamento;
  • Compatibilidade com OSC-Magento-Brasil;
  • Atualização da lib PagSeguro PHP;
  • Compatibilidade com Magetento 1.5.x e 1.6.x;

1.3

  • Remoção da janela intermediária de redirecionamento para o PagSeguro;
  • Agora é exibido uma mensagem amigável ao comprador caso ocorra algum erro com a compra;
  • Melhorando tratamento dos dados de endereço que são enviados ao PagSeguro.

1.2

  • Correção: Erro ao finalizar compra.

1.1

  • Adicionado: Integração com API de Notificação do PagSeguro.
  • Adicionado: Links para criação de conta e token.
  • Adicionado: Url padrão de retorno caso não seja informada.
  • Correção: Redefinição de envio do frete.
  • Correção: Ajuste no envio de taxas.

1.0

  • Versão inicial. Integração com API de Pagamento do PagSeguro.

Licença


Copyright 2013 PagSeguro Internet LTDA.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Notas


  • 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.

Contribuições


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.