PHPackages                             shulyak/pagseguro - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. shulyak/pagseguro

ActiveLibrary[Payment Processing](/categories/payments)

shulyak/pagseguro
=================

Biblioteca de integração com o PagSeguro

v1.0(5y ago)09.0kApache License 2.0PHPPHP &gt;=5.4.27

Since Aug 27Pushed 5y ago1 watchersCompare

[ Source](https://github.com/shulyak/pagseguro)[ Packagist](https://packagist.org/packages/shulyak/pagseguro)[ RSS](/packages/shulyak-pagseguro/feed)WikiDiscussions master Synced yesterday

READMEChangelog (1)Dependencies (3)Versions (3)Used By (0)

Biblioteca de integração PagSeguro para PHP
===========================================

[](#biblioteca-de-integração-pagseguro-para-php)

[![Code Climate](https://camo.githubusercontent.com/92769fb26f915159da11cb8c4b96c9100d4454d5f65116cd5d0c0a0d711746c9/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f70616773656775726f2f7068702f6261646765732f6770612e737667)](https://codeclimate.com/github/pagseguro/php)

Descrição
---------

[](#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ções de pagamentos](https://pagseguro.uol.com.br/v2/guia-de-integracao/api-de-pagamentos.html)
- Criar [requisições de assinaturas](http://download.uol.com.br/pagseguro/docs/pagseguro-assinatura-automatica.pdf)
- Cancelar [assinaturas](http://download.uol.com.br/pagseguro/docs/pagseguro-assinatura-automatica.pdf)
- Consultar [assinaturas](http://download.uol.com.br/pagseguro/docs/pagseguro-assinatura-automatica.pdf)
- Consultar [transações por código](https://pagseguro.uol.com.br/v3/guia-de-integracao/consulta-de-transacoes-por-codigo.html)
- Consultar [transações por intervalo de datas](https://pagseguro.uol.com.br/v2/guia-de-integracao/consulta-de-transacoes-por-intervalo-de-datas.html)
- Consultar [transações abandonadas](https://pagseguro.uol.com.br/v2/guia-de-integracao/consulta-de-transacoes-abandonadas.html)
- Receber [notificações](https://pagseguro.uol.com.br/v3/guia-de-integracao/api-de-notificacoes.html)

Requisitos
----------

[](#requisitos)

- [PHP](http://www.php.net/) 5.4.27+
- [SPL](http://php.net/manual/en/book.spl.php)
- [cURL](http://php.net/manual/en/book.curl.php)
- [DOM](http://php.net/manual/en/book.dom.php)

Instalação
----------

[](#instalação)

- Baixe o repositório como arquivo zip ou faça um clone;
- Descompacte os arquivos em seu computador;
- 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 e o diretório *PagSeguroLibrary* contém a biblioteca propriamente dita. Caso queira importar somente a biblioteca, faça upload do diretório *PagSeguroLibrary* e inclua a classe *PagSeguroLibrary.php* em seu projeto. Essa classe se encarregará de importar todas as funcionalidades da biblioteca no seu sistema.

Instalação via Composer

- Alternativamente, é possível utilizar o [Composer](https://getcomposer.org) para carregar a biblioteca ([pagseguro/php](https://packagist.org/packages/pagseguro/php)).

```
{
    "require": {
       "shulyak/pagseguro": "@stable"
    }
}
```

Configuração
------------

[](#configuração)

Para fazer uso real da biblioteca, é preciso fazer algumas configurações no arquivo 'PagSeguroConfig.php', que encontra-se no diretório 'config'. As opções disponíveis estão descritas abaixo.

- **environment**: aceita os valores *production* e *sandbox*. Para utilizar o *sandbox*, é preciso criar uma conta em .
- **email**: e-mail cadastrado no PagSeguro.
- **token production**: token gerado no PagSeguro.
- **token sandbox**: token gerado no Sandbox.
- **appId production**: aplicacao gerada no PagSeguro.
- **appId sandbox**: aplicacao gerada no Sandbox.
- **appKey production**: token da aplicacao no PagSeguro.
- **appKey sandbox**: token da aplicacao no Sandbox.
- **charset**: codificação do seu sistema (ISO-8859-1 ou UTF-8).
- **log**: ativa/desativa a geração de logs.
- **fileLocation**: local onde se deseja criar o arquivo de log. Ex.: /logs/ps.log.

Mais informações estão disponíveis na [documentação oficial](https://pagseguro.uol.com.br/v2/guia-de-integracao/tutorial-da-biblioteca-pagseguro-em-php.html).

Dúvidas?
--------

[](#dúvidas)

---

Caso tenha dúvidas ou precise de suporte, acesse nosso [fórum](http://forum.pagseguro.uol.com.br/).

Changelog
---------

[](#changelog)

2.7.1

- Possibilidade de definir parcelamento sem juros.
- Ajustes em geral.

2.7.0

- Integração com serviço de consulta de Assinaturas (PreApproval) por código de notificação.

2.6.0

- Env Variables para integração com Laravel 5 #0a2c2ba
- Wrapper para o arquivo de configuração #c1b0985
- Implementação da API de assinaturas #7cd8147
- Integração com serviço de solicitação de cancelamento.
- Ajustes em geral.
- Obs.: Algumas das funcionalidades descritas ainda não estão disponíveis comercialmente para todos os vendedores. Em caso de dúvidas acesse nosso [fórum](http://forum.pagseguro.uol.com.br/).

2.5.0

- Possibilidade de definir descontos por meio de pagamento durante a requisição do código de checkout - Ver exemplo createPaymentRequest.php

2.4.0

- Integração com serviço de consulta de transações/autorizações por código de referência.
- Integração com serviço de modelo de aplicações.
- Integração com serviço de solicitação de estorno.
- 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](http://forum.pagseguro.uol.com.br/).

2.3.0

- Adicionado classes e métodos para utilização do [Checkout Transparente](https://pagseguro.uol.com.br/receba-pagamentos.jhtml#checkout-transparent).
- As consultas por código de notificação e por código da transação passam a utilizar a nova versão das APIs.

2.2.4

- Adicionado método setEnvironment na classe PagSeguroConfig
- Melhorias na documentação/comentários do código
- Ajustes diversos

2.2.3

- Ajustes no código

2.2.2

- Adicionando environment *sandbox*

2.2.1

- Ajuste no tratamento do XML retornado em requisições feitas ao PagSeguro

2.2.0

- Ao registrar a transação é possível obter apenas o código do checkout para utilização em um checkout lightbox (ver exemplo createPaymentRequestLightbox.php). Obs.: Esta funcionalidade ainda não está disponível comercialmente para todos os vendedores.

2.1.9

- Melhorias "estéticas" no código, como identação/formatação.

2.1.8

- Atualização dos códigos de meios de pagamento.
- Melhoria na identificação dos requisitos mínimos para funcionamento.
- Melhoria no tratamento de dados relacionados a endereço.

2.1.7

- Adicionado: Classes para manipulação de metadados e parâmetros genéricos.

2.1.6

- Adicionado: Classe para manipulação de documentos do sender, ex. CPF.

2.1.5

- Adicionado: Funcionalidade de envio de url de notificação via requisição de checkout.
- Adicionado: Novas funcionalidades para tratamento de dados no helper.
- Correção: Tratamento de duplo espaço no sender name da requisição de checkout.

2.1.4

- Adicionado: Classe para manipulação de moedas permitidas nas transações com o PagSeguro.

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

2.0.0 - 2.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.

Licença
-------

[](#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

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

[](#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.
- Para a utilizar o checkout transparente, é necessária a solicitação de ativação junto com a equipe do PagSeguro, maiores informações podem ser encontradas em [Como receber pagamentos pelo PagSeguro](https://pagseguro.uol.com.br/receba-pagamentos.jhtml#checkout-transparent).

Dúvidas?
--------

[](#dúvidas-1)

Em caso de dúvidas acesse nosso [fórum](http://forum.pagseguro.uol.com.br/).

Contribuições
-------------

[](#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.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

2084d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b11a45a824825162ff2f9c9c4dc7c489cf2fbc64b36f414f71f52f642a7b9fd3?d=identicon)[shulyak](/maintainers/shulyak)

---

Top Contributors

[![sh00lik](https://avatars.githubusercontent.com/u/64553941?v=4)](https://github.com/sh00lik "sh00lik (4 commits)")

### Embed Badge

![Health badge](/badges/shulyak-pagseguro/health.svg)

```
[![Health](https://phpackages.com/badges/shulyak-pagseguro/health.svg)](https://phpackages.com/packages/shulyak-pagseguro)
```

###  Alternatives

[pagseguro/pagseguro-php-sdk

Biblioteca de integração com o PagSeguro

312456.6k14](/packages/pagseguro-pagseguro-php-sdk)[oxid-esales/paypal-module

This is the PayPal module for the OXID eShop.

36513.5k2](/packages/oxid-esales-paypal-module)[bestit/amazonpay4oxid

This is the Amazon Pay module for the OXID eShop.

11276.2k1](/packages/bestit-amazonpay4oxid)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
