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:
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.
Antes de iniciar o fluxo de pagamentos, você pode utilizar o carrinho de compras do PagSeguro. Dessa maneira, você permite que o comprador altere o pedido ou mesmo retorne à sua loja para adicionar mais itens, antes de fechar o pedido e prosseguir com o pagamento. Com o carrinho de compras, os dados do pedido permanecerão na sessão do navegador. Essa solução é ideal para lojas mais simples, que não possuem tal funcionalidade.
O exemplo abaixo mostra um formulário HTML semelhante ao exemplo anterior, porém ilustrando o uso do carrinho de compras:
<!– Declaração do formulário –>
<form target=”pagseguro” method=”post”
action=”https://pagseguro.uol.com.br/v2/checkout/cart.html?action=add“>
<!– Campos obrigatórios –>
<input type=”hidden” name=”receiverEmail” value=”suporte@lojamodelo.com.br“>
<input type=”hidden” name=”currency” value=”BRL”>
<!– Itens do pagamento (ao menos um item é obrigatório) –>
<input type=”hidden” name=”itemId” value=”0001″>
<input type=”hidden” name=”itemDescription” value=”Notebook Prata”>
<input type=”hidden” name=”itemAmount” value=”2430.00″>
<input type=”hidden” name=”itemQuantity” value=”1″>
<input type=”hidden” name=”itemWeight” value=”1000″>
<!– Código de referência do pagamento no seu sistema (opcional) –>
<input type=”hidden” name=”reference” value=”REF1234″>
<!– submit do form (obrigatório) –>
<input type=”image” name=”submit”
src=”https://p.simg.uol.com.br/out/pagseguro/i/botoes/pagamentos/120×53-pagar.gif“
alt=”Pague com PagSeguro”>
</form>
Observe que as informações de frete e os dados do comprador não são necessários. Além disso, você deve informar o endereço da página de carrinho de compras no PagSeguro, adicionando um novo item ao carrinho:
https://pagseguro.uol.com.br/v2/checkout/cart.html?action=add
Você também poderá inserir uma opção “Ver carrinho” na sua loja. Assim, o comprador irá ver os itens que já foram adicionados ao pedido. Copie e cole o código em seu site. Escolha um lugar em sua página onde o comprador o encontre facilmente.
<a href=”https://pagseguro.uol.com.br/v2/checkout/cart.html?action=view“>
<img src=”https://p.simg.uol.com.br/out/pagseguro/i/botoes/pagamentos/99×61-carrinho-assina.gif” alt=”Ver carrinho”/>
</a>
Se você preferir, utilize as seguintes imagens dos botões criadas pelo PagSeguro:
Tem alguma dúvida sobre como integrar o PagSeguro? Entre em contato.
O que é?
Um dos erros mais comuns que alguns desenvolvedores tem ao integrar o PagSeguro é na validação das informações recebidas no Retorno Automático.
Isso normalmente ocorre quando há uma divergência na codificação de caracteres (encoding, charset) do sistema se comparada à utilizada pelo PagSeguro, no caso ISO-8859-1. Ou seja, é como se o sistema utilizado estivesse preparado para tratar as informações apenas em UTF – 8 e ao receber dados contendo uma codificação diferente, os caracteres aparecem “quebrados”, o que impede a interpretação correta dessas informações.
Veja o exemplo abaixo:
Como a palavra “Cartão de Crédito” possui caracteres especiais, no caso acentos, a informação referente a essa transação não foi validada devido ao erro de encoding.
Como corrigir?
Para corrigir o erro de acentuação, o sistema deverá trabalhar utilizando a mesma codificação utilizada pelo PagSeguro (ISO-8859-1) ou converter os dados antes da manipulação dessas informações.
Uma forma simples de evitar erros de validação é utilizando a API de Notificações, pois o código enviado para o seu sistema não possui acentuação, o que facilita a integração, gerando mais segurança.
A API de Notificação funciona de forma parecida com o Retorno Automático de Dados, porém a etapa de verificação é realizada por um código que não possui acentuação, evitando o problema acima, além de possuir mais campos referentes à transação. Com isso você terá informações mais detalhadas e precisas sobre a venda de seus produtos.
Veja documentação sobre a API de Notificação.
Com o PagSeguro, você pode trabalhar com três tipos de frete: por valor fixo, por peso ou frete adicional com valor fixo.
Você também pode disponibilizar para seus clientes a ferramenta de cálculo de frete, para que saiba exatamente o quanto pagará pelo envio da mercadoria.
Para utilizar um desses tipos de frete, você precisa configurá-lo na página de Frete no Menu Preferências em sua conta.
Além disso, é possível disponibilizar também a forma de envio em sua loja. Seus produtos podem ser enviados apenas por SEDEX ou Encomenda normal (PAC), ou se preferir, você pode utilizar as duas formas de envio e deixar a escolha por parte do comprador.
Frete fixo:
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.
Frete por peso:
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.
Atenção: Se o somatório dos pesos dos itens ultrapassar o limite de 30Kg, ou se o valor total ultrapassar R$10.000,00, o frete não será calculado no PagSeguro, e deverá ser cobrado à parte, diretamente com seu cliente.
Frete adicional com valor fixo:
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.
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.
Saiba como integrar o frete em sua loja virtual, acesse: http://zip.net/bxcgs5
“Transação inválida. Sempre inicie transações a partir de sites confiáveis”.
Algumas vezes, ao implantar o sistema do PagSeguro para realizar suas vendas, aparece a seguinte mensagem:
Por que isso ocorre?
No dia 3 de agosto o PagSeguro lançou as famosas APIs, para auxiliar na integração.
Uma delas é a de pagamento, cuja finalidade é fazer uma integração mais dinâmica e segura. Ao utilizar essa nova API de pagamento, automaticamente seu sistema se programa para aceitar pagamentos somente por ela. É necessário desabilitar essa opção para sanar o problema. Veja abaixo como:
1 – Acesse sua conta do PagSeguro – https://pagseguro.uol.com.br/
Acesse no menu a opção “Integrações”.
Escolha “Pagamentos via API”
Desmarque a opção “Quero receber somente pagamentos via API”.
Será exibida uma caixa de diálogo com a seguinte pergunta: “Deseja desativar a restrição de pagamentos com API?”
Seguindo todos os passos corretamente, será exibida a tela abaixo:
Agora você poderá receber seus pagamentos normalmente, eliminando os possíveis conflitos. Caso tenha alguma dúvida, entre em contato com nossa equipe de desenvolvedores, pelo e-mail desenvolvedores@pagseguro.com.br.
O PagSeguro tem uma novidade muito boa para você desenvolvedor. São as novas APIs de integração do PagSeguro. São três serviços: pagamentos, notificações e consultas. São aplicações que visam oferecer mais flexibilidade aos desenvolvedores e mais segurança aos vendedores. Leia mais…;
No último dia 30 de janeiro, Michael Granados explicou aos inscritos em seu curso na Impacta como criar uma loja usando PagSeguro sem usar nenhum framework, apenas o PHP. Aqui estão os slides da palestra (ótimos para quem entende um pouco de programação). Aproveitem.
Em janeiro a Impacta está com vários treinamentos gratuitos interessantíssimos para quem trabalha com internet – e e-commerce, claro. O destaque fica para a palestra gratuita de Michael Granados, nosso colaborador em ferramentas PHP. Com o título “Da argila ao forte: como desenvolver uma loja virtual com PagSeguro”, DG Mike vai ensinar como desenvolver uma loja virtual com 300 linhas de código sem framework!
Serviço:
Da argila ao forte: como desenvolver uma loja virtual com PagSeguro
Michael Granados – desenvolvedor na Visie e trabalha com PHP há mais de seis anos. Atualmente, ele trabalha com o UOL para elaborar ferramentas em PHP para PagSeguro. Recentemente foi palestrante do CMSBrasil, BlogCamp e PHP-MG
Dia 30 de janeiro, sábado, das 10h às 13h
Faculdade Impacta Tecnologia Rua Arabé, 71 – Vila Clementino (próx. metrô Santa Cruz)
Contribua com 1kg de alimento não perecível para o CPH Lar Vicentino
No e-commerce, o carrinho de compras é um ponto chave para o sucesso. Pode ser o lugar onde o cliente fecha o negócio ou desiste dele. Em termos de programação (ou desenvolvimento, como preferir), o carrinho é um conjunto de scripts que permitem ao seu usuário comprar. O seu bom funcionamento ajuda a ter sucesso na primeira fase crítica: a escolha. A segunda será o pagamento – mas quem já implantou o PagSeguro com sucesso não deve ter grandes problemas a respeito.
Há muitas opções para criar o seu carrinho de compras. Ele deve ser definido a partir do seu produto. A primeira coisa a fazer é analisar as suas necessidades – e as do seu cliente. Nunca esqueça: ele é a razão de ser do seu negócio. No nosso sistema pronto, você tem duas opções: o carrinho com apenas um produto (ou doação) e o carrinho do PagSeguro com mais itens. Além disso, você pode fazer toda a programação usando a sua ferramenta de e-commerce e, ao final do processo, enviar os dados dos produtos e do pagamento para o PagSeguro terminar a transação. A última escolha, claro, é muito mais profissional e permite mais controle das vendas e dos relatórios.
Em geral, quando se desenvolve um site, o custo é o fator principal. Entretanto, tentar cortar este custo em geral não leva seu negócio ao sucesso. Há várias histórias na internet brasileira de sistemas remendados, que não funcionam, de perda de vendas e até fim da operação por conta de um sistema que não atende as necessidades. Além de decidir as funções necessárias para você e para conquistar o seu cliente, lembre do futuro. Funções que hoje não são necessárias em pouco tempo, com o crescimento, se tornam essenciais. E mudanças com a loja no ar são verdadeiros pesadelos. O conselho? Planejamento bem-feito.
Algumas funções que podem ser usadas num carrinho de compras Leia mais…;
