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:

Temos recebido dúvidas sobre o funcionamento do retorno automático. Neste post, esclarecemos algumas dúvidas e damos algumas dicas que auxiliarão no processo de recebimento das informações das transações.

Após o processo de compra e pagamento, o usuário é enviado de volta a seu site. Para isso, você deve configurar uma URL de retorno.

A URL configurada tem duas funções distintas. São elas: redirecionar o comprador de volta para sua loja após o término da compra na página de checkout do PagSeguro e enviar os dados da transação e alteração de status da transação via POST para o seu servidor.

Se o pagamento entrou em análise ou se o usuário pagou usando boleto bancário, o status será “Em Análise” ou “Aguardando Pagamento”. Nesses casos, quando a transação for confirmada (o que pode acontecer alguns dias depois) a loja receberá outro POST, informando o novo status.

Cada vez que a transação muda de status, um POST é enviado:

1) A transação se inicia quando a sua loja envia ao PagSeguro um POST com os dados do pedido:

2) O PagSeguro envia um POST para a URL de retorno que você configurou, com os dados da transação, acrescido do status.

3) Por segurança, o seu sistema deve confirmar os dados recebidos. Para isso, retorne o POST, acrescido do Token de segurança e o parâmetro “comando” validar (comando=Validar).

O PagSeguro recebe sua confirmação e confere se os dados trocados são válidos. Os valores retornados para essa validação são VERIFICADO ou FALSO. Isso garante a integridade da comunicação do retorno automático.

4) Com a validação do POST, você terá o último status da transação atualizado.

Exemplo de informações que foram enviadas via POST e validadas:

Dicas sobre Retorno Automático:

• O envio do POST é automático ao final da transação e quando ocorre uma alteração no status da transação, ambos em background, abre uma nova sessão no seu site.
• Não é possível imprimir nenhum campo do post no momento do recebimento (echo, print, Response.Write, etc).
• As informações deverão ser salvas em seu banco de dados, arquivo texto ou XML no momento do recebimento.
• É necessário que o site e a URL de Retorno estejam hospedados em um domínio válido.
• Não poderá ser uma aplicação local (você não conseguirá receber os dados em um ambiente local, como “localhost” por exemplo).
• O código de NPI (Notificação de Pagamento Instantâneo) não conseguirá ler valores de Sessions ou Cookies, porque assim que o PagSeguro envia o POST para o seu web site, é aberta uma nova sessão (conforme mencionado acima).
• Não há restrições de saída no PagSeguro, mas caso você não esteja recebendo nenhum dado do PagSeguro, libere em seu firewall os seguintes IP’s de POST do NPI: 200.221.19.20 e IP de Redirecionamento simples: 200.221.19.4.
• Servidor configurado em uma porta da 80 (HTTP) ou 443 (HTTPS).
• A programação do retorno automático deve enviar de volta para o PagSeguro todos os campos recebidos no POST, mais o comando=validar e o token=”Seu Token”.
• Use o token de segurança para validação da transação.
• Retorne os dados para validação sem nenhuma conversão, exatamente da maneira como recebeu (verifique se a sua string está sendo enviada com Encode, por exemplo: “%20” ou o sinal de adição “+” substituindo o espaço, etc).
• É muito importante sempre colocar um debug em seu código, salvando o erro do debug no seu banco de dados para analisar onde e porque ocorreu o erro no momento do retorno.
• O script em nossa página é apenas ilustrativo, cada desenvolvedor altera de acordo com o próprio sistema.

Links úteis:

Defina a URL que receberá as informações das transações: Retorno Automático

Configure o endereço de redirecionamento: Página de Redirecionamento

Crie um Token para sua conta PagSeguro: Token

Observe todos esses itens, e se ainda você não conseguir receber o POST, 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:

Nossa Equipe de Suporte à Integração recebe quase que diariamente dúvidas à respeito do Frete e por esse motivo, decidimos elaborar esse post explicando quais são o métodos disponíveis e assim, evitar erros que podem ser facilmente corrigidos.

 Frete Fixo

Como funciona? Utilize-o para cobrar sempre o valor de frete especificado. Para mais de um item, o valor fixo do frete será multiplicado pelo número de itens. Esta opção não oferece desconto caso o cliente compre mais de um item.

Exemplo: Seu cliente comprou 3 itens. O custo do frete especificado para cada item é de R$ 10,00. Neste caso, o cliente pagará R$ 30,00 de frete pelos 03 itens (R$10,00 vezes 3).

Frete por Peso

Como funciona? Utilize-o para cobrar o frete de acordo com o peso do produto, com base na tabela dos Correios e no CEP informado pelo cliente. Seu cliente poderá optar por Encomenda econômica (PAC) ou Sedex. O limite estabelecido pelos Correios é de até 30kg ou R$10.000,00.

Exemplo:  Seu cliente comprou 3 itens. Os pesos especificados para os itens são: 1kg, 3kg e 5kg. Neste caso, o cliente pagará pelo envio de 9kg, de acordo com a tabela de preços dos Correios. Esta opção oferece ao cliente o valor exato do frete.

 Frete Adicional com Valor Fixo

Como funciona? Recomendado em casos em que você deseja cobrar o frete do item que tiver o valor mais alto no carrinho e cobrar um valor adicional fixo para cada item extra. Não será cobrado frete algum para itens que tenham frete grátis (nem mesmo o valor extra). Esta opção oferece ao cliente desconto no frete dos itens adicionais

Exemplo: O cliente comprou 3 itens. Os fretes especificados para os itens são: R$10,00, R$15,00 e R$20,00 respectivamente. O valor do frete para itens extra é de R$5,00. Neste caso, o cliente pagará R$30,00 de frete pelos 03 itens (R$20,00 + R$5,00 + R$5,00).

Obs: Os valores de frete por peso calculados pelo PagSeguro são apenas uma estimativa obtida junto aos Correios e devem ser confirmados no ato da postagem.

 Como integrar?

Mostraremos abaixo um exemplo de integração utilizando nossa API de Pagamentos, que é o método de integração mais recomendado por nós.

Nos parâmetros HTTP abaixo, você pode passar o endereço para onde o produto será enviado. Isso torna o fluxo de pagamento no PagSeguro mais simples e rápido:

 &shippingAddressStreet=Av. Brig. Faria Lima

&shippingAddressNumber=1384

&shippingAddressComplement=5o andar

&shippingAddressDistrict=Jardim Paulistano

&shippingAddressPostalCode=01452002

&shippingAddressCity=Sao Paulo

&shippingAddressState=SP

&shippingAddressCountry=BRA

Além do endereço, você pode passar as informações relacionadas ao custo do frete, respeitando a modalidade de frete configurada no seu menu de preferências de frete. Caso as informações não sejam passadas o PagSeguro entende como frete grátis. Veja como funciona:

Frete fixo e Adicional com valor fixo

Caso tenho configurado em sua conta um desses dois tipos de frete, basta adicionar junto às demais informações de cada item, o parâmetro abaixo. No caso de não haver frete, basta deixar o valor igual à Zero:

&itemShippingCost1=10.00

Frete por peso

Ao optar por esta modalidade de frete, você deverá passar por parâmetro o peso de cada item. Caso não queira utilizar o frete, basta deixar o valor igual à Zero:

&itemWeight1=1000

Como não cobrar Frete?

Para isso, basta passar os parâmetros abaixo zerados e de acordo como foi configurada a opção de Frente em sua conta do PagSeguro:

Se você esclheu Frete fixo e Adicional com valor fixo:

&itemShippingCost1=00.00

No caso de Frete por Peso:

&itemWeight1=0000

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

Ainda não tem uma conta PagSeguro?

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.

Para atrair mais compradores, o PagSeguro oferece aos vendedores a opção de venda parcelada sem juros. Essa ferramenta tornará suas ofertas mais atraentes e você continuará recebendo em uma única parcela 14 dias após aprovação da transação e também é possível oferecer descontos à vista.

Logado em sua conta PagSeguro, acesse no menu à esquerda as opções: Preferências > Parcelamento. Nesta tela poderão ser configurados:

• Quantidade de parcelas oferecidas – Neste item as opções irão de 2 a 18 vezes
• Se ocorrerá ou não descontos para transações à vista – Nesta opção você optará por oferecer descontos à vista ou não
• Data de início e término da promoção – Período da promoção. A promoção deve ser agendada com 24 horas de antecedência.
• Valores mínimos e máximos da transação. – Aqui você estipulará para quais valores serão ofertados o desconto.

Mais abaixo você tem disponível um simulador, que é possível verificar os valores de taxa de parcelamento e da taxa de intermediação do PagSeguro.

Estando tudo ok, basta clicar em Agendar promoção e ela estará agendada com sucesso. Lembramos que não é possível agendar duas promoções no mesmo período. Para verificar as promoções já criadas, basta acessar a Listagem de promoções .

O PagSeguro oferece ferramentas para ajudar o vendedor a alavancar suas vendas. Caso tenha alguma dúvida ou sugestão basta entrar em contato conosco utilizando nossa central de atendimento.

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.

Agora você pode utilizar o PagSeguro na palma da sua mão. O PagSeguro lançou o novo site versão mobile onde você pode ter muito mais facilidade na hora de realizar suas compras em qualquer lugar, apenas com seu celular.

O Brasil possui mais de 230 milhões de celulares, sendo que mais de 19 milhões são smartphones, um número que cresce a cada ano. Com o novo checkout, fica muito mais rápido e facil comprar, além de quem vende ter uma conversão maior nas vendas realizadas pelo celular, onde o comprador pode realizar a transação a qualquer momento e em qualquer lugar.
A versão mobile está disponível para smartphones touchscreen com sistema operacional que possa rodar javascript como IPhone, Android, Nokia Symbian/MeeG, entre outros.

Muito mais praticidade e rapidez para você fazer suas compras na internet, sempre contando com a segurança que só o PagSeguro proporciona.

Esse erro ocorre quando o sistema não consegue ler um padrão de mensagem qualquer (Geralmente mensagens em XML).

As principais causas desse erro são a falta de algum caractere ou até mesmo quando o sistema que está lendo o XML utiliza um charset diferente do sistema que enviou a mensagem.

Veja abaixo um exemplo de um XML faltando caracteres, que pode ocasionar o erro:

Veja agora um XML com caracteres “Quebrados”

Ambos os exemplos acima podem gerar erros quando o sistema foi interpretar esses dados, causando erros em todo resto da aplicação o qual iria precisar da informação presente no XML.

A API do PagSeguro envia todas informações utilizando o padrão XML, e em muitos casos, esse erro pode estar presente nos sistemas que usam “analisador” XML para manipular todas inforamçõeos e informam um charset diferente do utilizado ao criar o XML.

Se seu sistema está ocorrendo esse erro ao tentar utilizar qualquer API do PagSeguro, baixe a versão atualizada da nossa biblioteca o qual já prever eventos como esse e muitos outros.

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