*********** Biblioteca de integração PagSeguro em PHP v.2.1.3 *********** = Descrição = A biblioteca PagSeguro em PHP é um conjunto de classes de domínio que facilitam, para o desenvolvedor PHP, a utilização das funcionalidades que o PagSeguro oferece na forma de APIs. Com a biblioteca instalada e configurada, você pode facilmente integrar funcionalidades como: - Criar requisição de pagamento; - Consultar transações por código; - Consultar transações por intervalo de datas; - Receber notificações; = Requisitos = A biblioteca PagSeguro em PHP é compatível com a versão 5.1.6 (ou superior) do PHP. = Instalação = 1. Faça o download da Biblioteca PagSeguro em PHP; 2. Descompacte os arquivos em seu computador; 3. Dentro do diretório 'source' existem dois diretórios, o 'examples' e o 'PagSeguroLibrary'. O diretório 'examples' contém exemplos de chamadas utilizando a API para que você possa se basear e o diretório 'PagSeguroLibrary' contém a biblioteca propriamente dita. Caso queira importar somente a biblioteca ao seu sistema, faça upload do diretório 'PagSeguroLibrary' e inclua a classe 'PagSeguroLibrary.php'. Essa classe se encarregará de importar todas as funcionalidades da biblioteca no seu sistema. Caso queira importar a biblioteca juntamente com os exemplos, faça o upload de todos os arquivos descompactados. Não se esqueça de incluir a classe 'PagSeguroLibrary.php' encontrada no diretório 'PagSeguroLibrary' ao seu projeto para que você possa fazer uso da API em seu sistema; 4. Faça o upload dos arquivos descompactados para o diretório público do seu servidor. Os nomes mais comuns para este diretório são: htdocs, www ou o mesmo nome do domínio de seu website. = Configuração = - A biblioteca possui um arquivo de configurações que deve ser configurado para que se possa fazer real uso da mesma. Esse arquivo chama-se 'PagSeguroConfig.php' e encontra-se em no diretório config da biblioteca; - Nele são configurados: - ambiente; - credenciais de acesso composta por email e token; - Caso ainda não possua token, ele pode ser gerado na seguinte url: https://pagseguro.uol.com.br/integracao/token-de-seguranca.jhtml; - codificação: - ISO-8859-1 ou - UTF-8. - log: - ativo ou não; - diretório de geração do log das transações do sistema com o PagSeguro. Informações adicionais podem ser obtidas em: https://pagseguro.uol.com.br/v2/guia-de-integracao/tutorial-da-biblioteca-pagseguro-em-php.html = Changelog = v2.1.3 Correção: A requisição era abortada se a geração de log estivesse ativa e o usuário não possuisse arquivo para geração de log nem permissão de escrita e leitura para o arquivo; v2.0.0 - v2.1.2 Classes de domínios que representam pagamentos, notificações e transações; Criação de checkouts via API; Controller para processar notificações de pagamento enviadas pelo PagSeguro; Módulo de consulta de transações. = NOTAS = - 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.