O PagSeguro está com uma novidade para desenvolvedores. Nossa equipe de integração recebe muitas solicitações de desenvolvedores que preferem uma área de desenvolvimento em inglês, por estarem habituados a ambientes, linguagens e documentações neste idioma.  Por isso, estamos disponibilizando uma versão da documentação em inglês de nossa API. (clique aqui e veja aqui a versão em português em nosso site)

Essa documentação inicialmente conta com as duas APIs básicas; API de pagamentos e a API de notificações. Com essas elas é possível realizar a integração da maior parte dos sistemas que necessitam um modulo de pagamento.

Clique aqui e baixe a versão em inglês da documentação.

Tem alguma sugestão ou viu algum erro no Guia de Integração ? Entre em contato.

Algo muito importante no fluxo de um sistema de vendas é saber o momento em que o comprador pagou a compra, a fim de despachar a encomenda ou até liberar o Download. Atualmente esse processo pode ser realizado de forma automatizada utilizando a API de notificações, que irá notificar o sistema sempre que ocorrer uma alteração no status de pagamento de alguma transação.

O funcionamento da API é muito simples, sempre que o PagSeguro tiver novidades sobre o pagamento da transação o seu sistema será notificado por uma URL previamente cadastrada, logo seu sistema solicita detalhes para o PagSeguro sobre a notificação e o PagSeguro mostra os detalhes da transação em questão. Veja o fluxo na imagem abaixo:

Com os detalhes da transação basta atualizar toda informação no seu sistema e seguir com o fluxo da sua loja.

Para que o sistema funcione corretamente é necessário que em sua conta esteja cadastrada uma URL para receber os dados. Isso pode ser feito na pagina de configurações de notificação de transações do PagSeguro.

Como mostrado no item 2 do fluxo, inicialmente o PagSeguro irá enviar um código da notificação (notificationCode) e o tipo dessa notificação (notificationType), essas informações serão enviadas via POST para o seu sistema. Com esse código seu sistema consegue solicitar detalhes da transação relacionada à notificação em questão.

Tenha em mente que esse código não é o mesmo que o código de transação, caso tentar utilizar um código de transação o PagSeguro irá retornar um erro informando que o código da notificação é inválido.

Exemplo de resposta

Para realizar consultar a transação referente a notificação enviada, é necessário 3 dados, e-mail, token e o código da notificação.

Lembrando que o e-mail e token devem ser correspondentes a conta que recebeu a notificação.

Veja abaixo um exemplo de requisição, utilizando o método GET para fazer envio dos parâmetros (as linhas foram quebradas para facilitar a leitura).

https://ws.pagseguro.uol.com.br/v2/transactions/notifications

/766B9C-AD4B044B04DA-77742F5FA653-E1AB24

?email=suporte@lojamodelo.com.br

&token=95112EE828D94278BD394E91C4388F20

Exemplo de resposta

Caso os dados estejam todos corretos o PagSeguro irá retornar um XML contendo os detalhes da transação, o qual deverá ser similar ao abaixo:

Para saber o que significa cada parâmetro recebido acesse o link e Consulte a notificação de transação

Tem alguma sugestão, dúvida ou viu algum erro no Guia de Integração? Entre em contato.

Sempre que cadastrar uma URL para receber notificações de transações ou o retorno automático de dados, devem ser seguidos alguns passos importantes, afim de não ocorrerem problemas no recebimento, ou em alguns casos, não receber a notificação da transação.

Verifique se a URL cadastrada está correta.
Quando se copia e cola uma URL pode faltar algum pedaço do link ou algo semelhante, fazendo com que o PagSeguro envie os dados para o local errado, resultando na perca total de informações.

Utilize portas padrões na sua URL

Sempre que for configurar uma URL, procure utilizar as portas convencionais. Evite utilizar portas especificas para que não ocorram problemas na entrega das informações. Veja um exemplo de URL inválida: http://exemplo.com.br:8585/notificacao. URL válida: http://exemplo.com.br/notificacao

Verifique suas credenciais.

Se você estiver utilizando a API de notificações será necessário informar o e-mail e token para consultar detalhes da transação, verifique se o e-mail foi digitado corretamente, e se o token é o último gerado. Caso não tenha certeza, gere um novo. No caso do retorno automático de dados, você irá precisar do token para fazer a verificação de dados, verifique-o. Leia mais…;

Utilizando por base a calculadora de parcelamento do PagSeguro, você poderá reproduzir os mesmos números em seu sistema.

Antes de montar a lógica do calculo utilizado, precisamos primeiro entender que a parcela mínima é de 5 reais, ou seja, não será possível dividir 6 reais em duas vezes, por exemplo.
Outro ponto importante é atentar o número máximo de parcelas para cada bandeira. No caso:12x – Visa

• 12x – MasterCard
• 12x – Diners
• 15x – American Express
• 12x – Hipercard
• 18x – Aura
• 12x – Elo
• 3x – PLENOCard
• 3x – Personal Card

Bom, de posse das regras, apenas para calcular o número de cada parcela, é necessário um fator multiplicador. O PagSeguro disponibilizou o fator multiplicador na última coluna da tabela (veja na tabela abaixo)

Veja que para cada quantidade de parcelas temos um fator diferente. Então para acharmos o valor da parcela se o comprador dividir a transação em 6 vezes por exemplo, você poderá pegar o fator correspondente a 6 parcelas e multiplicar pelo valor total a ser pago.

No exemplo da compra em 6 vezes de um produto que custa R$ 1000.00 pegamos o fator correspondente ao numero de parcelas (no caso 6 parcelas, fator 0,17847)  e multiplicamos pelo valor total (R$ 1000.00), ficaria 1000.00 * 0.17847 = 178.47. Nesse caso o número de cada parcela irá ser de R$ 178.47.

O PagSeguro é um intermediador de pagamentos completo e de fácil manuseio, que incentiva os desenvolvedores a aproveitar as funcionalidades. No Guia do Desenvolvedor você encontra cada detalhe necessário para a integração do sistema PagSeguro em seu site de comércio eletrônico com tudo que você precisa para que seu cliente comece a vender na internet, com carrinho próprio, retorno automático, cálculo de frete e criação de botões de doação.

Mantemos com o iMasters um Fórum exclusivo para solucionar questões que aparecem naturalmente no desenvolvimento. E agora, para atender diretamente às suas questões, entre em contato através do e-mail desenvolvedores@pagseguro.com.br. O canal funciona de segunda a sexta, das 9h às 18h, apenas para dúvidas técnicas.

Quando um comprador por algum motivo abandonava a tela de pagamento do PagSeguro, era muito difícil identificá-lo, para que o vendedor pudesse interagir com ele para saber por que abandonou o carrinho. Pensando nisso, o PagSeguro criou a API de Consulta por Transações Abandonadas.

O funcionamento é muito simples:

Sempre que um comprador chega em nossa página de checkout e não finaliza o pagamento, o PagSeguro identifica esse cliente e o separa em uma lista de transações abandonadas. Assim, é possível descobrir quem desistiu de alguma transação no fluxo de pagamento e realizar alguma ação de marketing, algum tratamento em especial, como dar algum desconto, para tentar converter esse cliente ou mesmo efetuar modificações em sua loja e assim torna-la mais atrativa.

A requisição dos dados dessa API é semelhante à API de consulta por intervalo de datas, onde você informa os parâmetros para a busca e o PagSeguro lhe retorna todas as transações abandonadas referentes à esses parâmetros.

Veja abaixo um exemplo de requisição, utilizando método GET para fazer envio dos parâmetros (as linhas foram quebradas para facilitar a leitura).

https://ws.pagseguro.uol.com.br/v2/ transactions/abandoned
?initialDate=2012-02-02T00:00
&finalDate=2012-02-02T00:00
&email=suporte@lojamodelo.com.br
&token=95112EE828D94278BD394E91C4388F20

Além dos parâmetros citados, você poderá especificar o número máximo de resultado por página e o número da página em questão. Acesse a consulta de transações abandonadas no nosso guia de integração.

Exemplo de resposta:

Como resposta o PagSeguro retornar um XML contendo as transações no intervalo solicitado, veja um exemplo do XML gerado abaixo:

Para saber o que significa o parâmetro recebido acesse:

https://pagseguro.uol.com.br/v2/guia-de-integracao/consulta-de-transacoes-abandonadas.html#v2-item-consulta-de-transacoes-abandonadas-parametros-resposta

Tem alguma sugestão, dúvida ou viu algum erro no Guia de Integração? Entre em contato.

Utilizando a API de consulta por intervalo de datas, é possível conciliar todos os status de todas as transações em um determinado período, evitando que o seu sistema fique com algum status de pagamento desatualizado por perder alguma notificação em uma manutenção de programada do servidor.
Para o correto funcionamento, é preciso informar para o PagSeguro com qual e-mail você realizará a pesquisa e o token referente a conta em questão (por questões de segurança, evitando que pessoas não autorizadas consultem as transações da sua conta), e por último a data inicial e final para a consulta.
Enviando esses dados o PagSeguro retornará todas transações desse período.

Veja abaixo um exemplo de requisição, utilizando método GET para fazer envio dos parâmetros (as linhas foram quebradas para facilitar a leitura).

https://ws.pagseguro.uol.com.br/v2/transactions
?initialDate=2011-01-01T00:00
&finalDate=2011-02-28T00:00
&email=suporte@lojamodelo.com.br
&token=95112EE828D94278BD394E91C4388F20

 

Além dos parâmetros citados, você poderá especificar o número máximo de resultado por página e o número da página em questão. Para consultar detalhes sobre todos esses parâmetros acesse: Parâmetros de consulta

Exemplo de resposta

 
Como resposta o PagSeguro retornará um XML contendo as transações no intervalo solicitado, veja um exemplo gerado abaixo:

Para saber o que significam os parâmetros recebidos acesse: Parâmetros de resposta

Tem alguma sugestão, dúvida ou viu algum erro no Guia de Integração? Entre em contato.

A língua utilizada nos parâmetros apresentados na nova API do PagSeguro foi alterada para o inglês, tanto para facilitar a manutenção do código como também pelo inglês se tratar do idioma universal na programação.

Comparativo entre os parâmetros:

Leia mais…;

O primeiro passo para integrar seu sistema é direcionar o comprador para o site do PagSeguro, onde ele fará o pagamento dos produtos que ele quer comprar utilizando o meio que lhe for mais conveniente. A cada vez que você direciona o comprador para realizar um pagamento, o PagSeguro cria uma transação. Após o processamento da transação, o valor correspondente será creditado na sua conta PagSeguro.

O PagSeguro oferece duas alternativas para fazer a integração com o recebimento de pagamentos:

API de Pagamentos: Recomendado para lojas ou aplicações que podem executar scripts diretamente em seu servidor. Para este tipo de integração, é necessário ter conhecimento em linguagens de programação, como por exemplo: PHP, .NET, JAVA entre outras.

Pagamento via HTML: Recomendado para páginas que utilizam apenas HTML simples. Não é necessário conhecimento em linguagens de programação para fazer a integração.

Fluxo da API de Pagamentos: Esta opção oferece maior controle e flexibilidade sobre o processo de pagamento, porém exige conhecimentos de programação ou o uso de algum componente de integração.

Leia mais…;

Esta configuração permite que você receba, na URL de redirecionamento, o código da transação que acaba de ser criada pelo pagamento. Isso pode ser bastante útil, pois permite que você obtenha dados sobre a nova transação enquanto o comprador ainda está interagindo com o fluxo de pagamento.

Com o código da transação, você pode consultar os dados da mesma no PagSeguro e mostrar uma mensagem bem específica para o comprador, indicando as opções de pagamento e frete que ele usou e dando uma estimativa dos prazos de entrega.

Leia mais…;