/pagseguro-php-sdk

Biblioteca de integração em PHP

Primary LanguagePHP

Biblioteca de integração PagSeguro para PHP

Code Climate Total Downloads Minimum PHP Version Latest Stable Version Latest Unstable Version

Caso você deseje usar uma versão abaixo do PHP 7.1.3 por favor consulte o branch https://github.com/pagseguro/pagseguro-php-sdk/tree/5.x.x

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:

Requisitos

Instalação

Nota: Recomendamos a instalação via Composer. Você também pode baixar o repositório como arquivo zip ou fazer um clone via Git.

Instalação via Composer

Para baixar e instalar o Composer no seu ambiente acesse https://getcomposer.org/download/ e caso tenha dúvidas de como utilizá-lo consulte a documentação oficial do Composer.

É possível instalar a biblioteca pagseguro-php-sdk(pagseguro/pagseguro-php-sdk) via Composer de duas maneiras:

  • Executando o comando para adicionar a dependência automaticamente 
    php composer.phar require pagseguro/pagseguro-php-sdk

OU

  • Adicionando a dependência ao seu arquivo composer.json 
    {
    "require": {
       "pagseguro/pagseguro-php-sdk" : "^6.0"
    }
}

Instalação manual

  • Baixe o repositório como arquivo zip ou faça um clone;
  • Descompacte os arquivos em seu computador;
  • Execute o comando php composer.phar install no local onde extraiu os arquivos.

Como usar

O diretório public contém exemplos das mais diversas chamadas à API do PagSeguro utilizando a biblioteca (pagamento, assinatura, notificação) e o diretório source contém a biblioteca propriamente dita (código fonte).

Configuração

Para fazer uso real da biblioteca, é preciso fazer algumas configurações. Para saber mais sobre como configurar a biblioteca acesse a documentação.

Dúvidas?

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

Changelog

Para consultar o log de alterações acesse o arquivo CHANGELOG.md.

Licença

Copyright 2016 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.

Dúvidas?

Em caso de dúvidas acesse nosso fórum.

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 (git checkout -b my-new-feature)
  • Commit suas mudanças (git commit -am 'Added some feature')
  • Rode um push para o branch (git push origin my-new-feature)
  • Envie um Pull Request
  • Obs.: Adicione exemplos para sua nova feature. Se seu Pull Request for relacionado a uma versão específica, o Pull Request não deve ser enviado para o branch master e sim para o branch correspondente a versão.