Com o PagSeguro, o vendedor possui alguns métodos para receber as informações referentes às transações ocorridas em sua loja.

São eles:

- API de Notificação

- Retorno Automático de Dados

- Redirecionamento com Código da Transação

O PagSeguro garante o envio de todas as notificações que contém as informações completas das transações, porém mesmo em opções mais completas e automatizas como a API de Notificação e o Retorno Automático, podem aparecer alguns cenários onde não conseguiremos completar o contato com o seu servidor, por exemplo uma instabilidade em sua conexão que pode durar horas.

Em casos como esse, indicamos o uso da API de Consulta por Intervalo de Datas para que seja exibida uma lista das vendas que ocorreram em sua loja durante um período terminado.

Essa lista retornará os Códigos das Transações e através da API de Consulta de Transações por Códigos, serão exibidos todos os detalhes referentes à cada compra pesquisada.

Identificamos que um grande número de vendedores tem configurado em seu sistema apenas o Redirecionamento com Código da Transação. A criação desse método foi pensada na exibição de uma mensagem mais específica para o comprador, indicando as opções de pagamento e frete que ele usou e dando uma estimativa dos prazos de entrega.

Visto que é comprovado que o comprador tem o hábito de fechar o navegador após a informação que compra foi efetuada com sucesso, não recomendamos que o seu servidor dependa exclusivamente do redirecionamento do comprador para o seu site, pois nesses casos o seu servidor não receberá o código da transação.

É muito importante que você utilize as outras ferramentas de recebimento de notificações já citadas em conjunto com o Redirecionamento com Código.

Tem alguma sugestão ou encontrou algum erro no Guia de Integração ? Entre em contato com nosso suporte técnico

Ainda não possui uma conta PagSeguro? Cadastre-se, é grátis:

Muitas pessoas perguntam se é necessário criar uma nova conta no PagSeguro para administrar mais de uma loja virtual, já que no Painel de Controle não é possível configurar mais de uma URL para receber as notificações das transações. Mas isso não impede o vendedor de utilizar a mesma conta para quantos sites quiser. Ele só terá que identificar de qual loja virtual vem cada pagamento.

Ou seja, as informações relacionadas às vendas de todas as suas lojas serão centralizadas num único endereço e após o recebimento desses dados o seu sistema aplica um filtro e consegue identificar a origem de cada venda.

Identificando a transação:         

Se o método de integração utilizado for a API de Notificação, utilize o parâmetro abaixo:

<id>

Para mais informações, basta verificar em nosso guia de integração em API de Notificação

No caso de Retorno Automático:

<ProdID_x>:

Para mais informações, acesse em nosso guia de integração as informações sobre o Retorno Automático

Esses parâmetros são de presença obrigatória em seu código e eles identificam os itens da transação. Nesse campo é possível adicionar uma informação referente ao produto. Por exemplo: 0112

Onde 01 é o número identificador da loja e 12 é o número do produto à ser vendido.

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

Ainda não trabalha com o PagSeguro? Cadastre-se e comece suas vendas:

A fim de criarmos um padrão para os webservices, todos os parâmetros utilizados nas API’s do PagSeguro estão em Inglês, consequentemente as respostas e erros também ocorrerão em inglês. Mesmo se você não tiver familiaridade com o idioma, não se preocupe, criamos uma tabela informativa para lhe ajudar, mostrando os possíveis erros e como corrigir:

Para visualizar corretamente, basta clicar e dar zoom.

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

Essas duas palavras podem ser encontradas em diversas partes da documentação de integração do PagSeguro, mas o que são?

Podemos dizer que são dois métodos de transferência de dados para o protocolo (conhecido como HTTP). Utilizando um desses métodos, é possível transferir informações de uma aplicação para a outra.

No método GET, toda informação é enviada para o sistema de destino junto ao endereço do sistema. Já o método POST, a informação é enviada de forma mais escondida e não irá aparecer na URL.

Claro que existem mais diferenças entre ambos, o método GET pode enviar uma quantidade de dados muito limitada, já o POST pode enviar uma quantidade de informação consideravelmente grande, o POST é mais seguro que o GET, entre outros. Em nosso caso, precisamos apenas saber uma coisa: Quando o PagSeguro irá usar POST ou GET?

Não é necessário ler toda documentação para saber isso, abaixo estão pontos importantes: quando o sistema do vendedor faz a requisição e quando o PagSeguro faz a requisição:

Sistema do vendedor para PagSeguro

• Requisições de pagamento por código HTML – POST
• API de pagamento – POST
• API de consulta por código da transação – GET
• API de consulta por intervalo de datas – GET
• API de consulta por transações abandonadas – GET
• API de notificações – GET

PagSeguro para o sistema vendedor

• Retorno automático de dados – POST
• Notificações de transações – POST
• Pagina de redirecionamento – GET

Quando o sistema do vendedor envia os dados para o PagSeguro, não existe nenhuma particularidade, porém quando o PagSeguro envia alguma informação utilizando POST para o sistema do vendedor, esses dados são enviados sempre em uma sessão diferente da que o comprador está visualizando, ou seja, esses dados nunca poderão ser mostrados na tela no ato do recebimento.

Para visualizar esses dados recomendamos utilizar logs, que sempre que o PagSeguro enviar as informações, os dados ficarão registrados em algum lugar.

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

Após finalizar a integração, pode ocorrer um problema de acentuação na descrição de seus produtos exibida em nossa página de checkout, podendo causar uma desconfiança e insegurança no comprador, o que pode levá-lo à desistência da compra.

Veja abaixo o exemplo:

Para ilustrar esse problema de uma forma fácil, vamos imaginar duas pessoas onde cada um fala um idioma. Em uma conversa entre eles, algumas palavras não poderão ser compreendidas de forma correta, o que torna esse diálogo aberto a interpretações. Para evitar esse problema eles devem usar o mesmo idioma para se comunicar.

Com o PagSeguro e o seu sistema ocorre algo semelhante. Eles precisam falar um mesmo idioma afim de as informações aparecerem corretamente. Nesse caso, esse mesmo idioma seria o “encoding”, que é conhecido também como a “Codificação de Caracteres”.

O PagSeguro utiliza o encoding ISO-8859-1 para “entender” o que está escrito, alguns sistemas podem utilizar outro encoding e ao enviar essa informação para o PagSeguro irá resultar no erro mostrado na imagem acima.

A boa notícia é que você não precisa mudar todo o seu sistema para que ele “fale outro idioma”, basta informar para o PagSeguro o encoding que seu sistema utiliza usando o parâmetro de nome encoding.

Agora o PagSeguro exibirá toda acentuação da forma correta:

Acesse nosso guia do desenvolvedor e veja um exemplo do uso do Parâmentro Encoding

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

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.

• Para enviar uma mensagem, é necessário informar o e-mail, caso já seja cadastrado, é necessário informar a senha.

• Você deverá informar o assunto da mensagem. O PagSeguro irá mostrar uma lista de dúvidas relacionadas; caso não tenha uma dúvida parecida, você poderá enviar a mensagem.

É importante que ao abrir um atendimento na área do “Fale Conosco” filtre os campos certos referentes ao seu problema, para que assim ele seja direcionado a área responsável e o tratamento seja feito de forma direta e rápida.

É o PagSeguro pensando na sua comodidade e facilitando seu contato conosco

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.

O token deve pode ser gerado acessando: https://pagseguro.uol.com.br/integracao/token-de-seguranca.jhtml você dever estar logado na conta PagSeguro para o qual o código será gerado.

Utilize o log para mapear todos os processos.
Como o PagSeguro sempre envia os dados em background, não será possível visualizar nada na tela. Nesse caso a solução é usar logs.
Prefira utilizar log em texto, assim as chances de erro serão menores, uma vez que não irá precisar de um servidor de banco de dados ou algo do tipo.
Fique atento em testar o funcionamento do log antes de testar o recebimento dos dados.

Faça uma coisa de cada vez.
Ao invés de sair criando toda aplicação e só no final ver se tudo está funcionando, construa sua aplicação em etapas, assim ficará mais fácil de saber onde ocorre o erro. Como sugestão, primeiro veja apenas se está recebendo os dados, depois realize o tratamento da informação, assim evitará erros no tratamento e você acreditar que o erro está no não recebimento de dados.

Evite redirecionamentos.
Ao invés de redirecionar para outra pagina, configure na sua conta do PagSeguro uma URL que já irá realizar todo o procedimento. Ao redirecionar e não tomar cuidado correto com os dados pode haver perda de informação na transição de páginas e consequentemente a página de destino não obter a informação necessária.

Notificação de transações, Retorno automático de dados e Página de redirecionamento são coisas diferentes, utilize URLs diferentes.
Tratar todos esses serviços em um único arquivo muitas vezes pode fazer com que uma informação passe por uma instrução diferente da esperada, causando problemas no resultado final da sua lógica. Nesse caso tente evitar usar a mesma URL, para ambos.

Verifique bloqueios no seu servidor
Para que os dados sejam enviados corretamente, é necessário que a URL cadastrada não tenha nenhuma restrição de acesso, o PagSeguro realiza o envio de todas informações via robots, o que alguns servidores podem realizar bloqueios desse tipo.

Se depois de verificar todos esses procedimentos ainda continuar com problemas, entre em contato, que iremos lhe ajudar no que for possível.

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.

A Campus Party não é um lugar somente para computadores tradicionais, com teclado, cpu e monitor. A área de robótica mostra a criatividade e engenhosidade dos campuseiros engenheiros.

São mãos, cadeiras de rodas, braços inteligentes, miniaturas de casas movidas a energia eólica; entre outros. A Campus Party é um momento único, onde todos aprenderem uns com os outros, trocando informações e colaborando com projetos.

 Continue acompanhando as novidades da Campus Party no blog!