ti-unoesc/java

Biblioteca de integração em Java

Biblioteca de integração PagSeguro em Java

---

Descrição

---

A biblioteca PagSeguro em Java é um conjunto de classes de domínio que facilitam, para o desenvolvedor Java, 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 checkouts
• Criar requisições de pagamentos
• Consultar transações por código
• Consultar transações por intervalo de datas
• Consultar transações abandonadas
• Receber notificações

Requisitos

---

• Java 1.5+

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 pagseguro-api e o pagseguro-api-example. O diretório pagseguro-api-example contém exemplos de chamadas utilizando a API e o diretório pagseguro-api contém a biblioteca propriamente dita. Você pode adicionar a biblioteca como dependência do seu projeto de duas formas:
• incluindo o jar pagseguro-api-x.x.x.jar como dependência de seu projeto atual;
• importando o diretório pagseguro-api como um novo projeto em sua IDE, e incluí-lo como dependência do seu projeto atual.
• Opcionalmente você também pode importar o diretório pagseguro-api-example como um novo projeto em sua IDE para visualizar a utilização das classes da biblioteca de acordo com cada funcionalidade disponível. Obs: em alguns poucos casos é necessário fazer a exportação do certificado existente na página https://ws.pagseguro.uol.com.br e/ou https://ws.sandbox.pagseguro.uol.com.br e em seguida importar para sua JVM. Em caso de dúvida acesse nosso fórum.

Configuração

---

Para facilitar sua integração e permitir um maior controle sobre suas configurações, centralizamos todas as configurações da biblioteca em um único arquivo 'pagseguro-config.properties' localizado no diretório src do projeto 'pagseguro-api'. Nele você pode configurar:

• Credenciais para as chamadas à API do PagSeguro;
• Ativação e configuração de logs das chamadas ao PagSeguro.

Mais informações estão disponíveis na documentação oficial.

Dúvidas?

---

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

Changelog

---

2.5.2

• Ajustes na ApplicationCredentials

2.5.1

• Ajuste nos parsers.

2.5.0

• Adicionado suporte ao modelo de aplicações.

2.4.0

• Adicionada nova funcionalidade que permite a busca de notificação de solicitação de pagamento.

2.3.0

• Adicionada nova funcionalidade que permite criação e consulta de solitações de pagamentos.
• Refatoração das classes de Checkout para suporte a Solicitação de Pagamento.

2.2.0

• Adicionado classes e métodos para utilização do Checkout Transparente.

2.1.2

• Adicionando environment sandbox. Obs.: Para utilizar o ambiente de testes é preciso cadastrar uma conta em https://www.sandbox.pagseguro.uol.com.br e alterar o environment no arquivo pagseguro-config.properties

2.1.1

• Correções de bugs.

2.1.0

• Compatibildiade com Java 1.5+.
• Remoção de arquivos desnecessários.
• Alterado método de envio para HTTP.
• Adicionado possibilidade de envio de SenderCPF, MetaData e Parameter Generics.
• Correções de bugs.

2.0.4

• Atualização dos códigos de meios de pagamento.

2.0.3

• Correção: Tratamento de exceção.
• Adicionado: Classe para manipulação de documentos do sender, ex. CPF.
• Adicionado: Agora é possível definir uma URL de notificação na requisição do checkout.
• Atualização dos meios de pagamentos.

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

---

Copyright 2014 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 do projeto.
• Faça checkout no branch desenvolvimento.
• Adicione sua feature ou ajuste.
• Envie um pull request no GitHub.
• Obs.: Nao serão aceitos PR no repositório master.