DGmike

No sábado passado realizei uma palestra na Impacta sobre como implementar uma loja virtual do nada com ajuda do PagSeguro da UOL. Esta palestra já está na terceira versão, eu já a apresentei no PHP-Minas e PHPConference no ano passado. Eu sempre dou um upgrade entre uma apresentação e outra ou corto coisas que não são importantes, mas o conteúdo é basicamente o mesmo.

Foram abordados os temas controle de versão, PDO, Frameworks, motivação, KISS (keep it simple, stupid!) e desenvolvimento ágil.

Eu gosto muito dessa palestra em particular porque demonstra como você pode (e deve) ter sistemas grandes implementados com poucas linhas de código, bastando usar a essência do PHP. Hoje o PHP pode ser considerado uma linguagem bem estável e com grandes recursos que em muitos casos usar um Framework completo é algumas vezes perda de tempo, valendo mais a pena usar a essência da linguagem.

Sala cheia (duas) na palestra sobre PagSeguro na Impacta

Também gosto pra caramba de implementar PagSeguro em palestras por ser simples. Em menos de vinte minutos explicativos é possível demonstrar como implementar PagSeguro com direito a retorno automático e dicas de segurança na hora de implementar. É muito satisfatório ver o quanto é rápido, simples e fácil implementar vários meios de pagamento de uma só vez. Com a segurança de “pishing”, fraude, reembolso e muitas outras vantagens que o PagSeguro disponibiliza.

A palestra esteve bem cheia, foram necessárias duas salas e uma conexão de áudio e vídeo para que todos possam ver a palestra. Dentre o pessoal consegui ver o @caferrari – dono do projeto vortice framework, e o @rodrideme – ex-funcionário da Visie e sua namorada @alazanscarol. Muito bom ver esse pessoal.

Enfim a palestra foi ótima e o código-fonte do projeto está no trac para qualquer um estudar. Para ver a palestra, basta vê-la no SlideShare. Espero que tenha mais palestras como esta pois acredite em mim, não é a mesma coisa assistir a palestra e vê-la no SlideShare, é completamente diferente.

Uma coisa que sempre me tirou o sono durante a noite era o campo status do PagSeguro. Quando a compra está pronta, quando eu posso confiar em enviar o meu produto. O que significa completo, o que significa aprovado. Quando vem cada um.

Estou há uma semana no UOL junto com o pessoal do PagSeguro e eles tinham uma visão diferente da minha, eles devem saber disso melhor do que eu. Acontece que a regra básica é: “Aprovado” quando o boleto, cartão de crédito, débito ou TCP (transferência entre contas PagSeguro) foi efetivada e aprovada. “Completo” vem um POST após 14 dias informando que aquele valor não tem mais volta, o cliente gostou do serviço/produto e você pode retirar seu dinheiro junto ao PagSeguro.

Bom, resolvi tirar a prova dos sete. Na Visie, nos ajudamos o cliente a implementar o PagSeguro com o retorno automático em sua loja. Então peguei o banco de dados de um cliente aleatório (com as devidas autorizações) para fazer essa pesquisa. Isso foi importante porque assim temos um cliente comum como você ou eu mesmo.

Organizei o log (ainda bem que nós sempre guardamos o log de tudo o que é feito) de informações e joguei no banco de dados com a data de recebimento do POST para ficar mais fácil de visualizar. Organizei os resultados pelo código do pedido e em seguida pela data. Pedi para exibir também o tipo de transação e o status de cada linha. Assim podemos ver o que aconteceu aonde e quando.

Este foi o resultado obtido (os códigos de transação foram cortados para protejer os clientes):

Mas e ae?! Que conclusões podemos tirar disto?

Perceba que, sempre você terá um post de “Aprovado” e um de “Completo”, os que não tem “Completo” é porque ainda não chegou sua data.

Nota: O cliente recebeu alguns POSTs de “Completo” sozinhos porque ele ainda não havia implantado o retorno automático corretamente (era feito na mão). E por isso os POSTs de “Aprovado”/”Em Analise”/”Aguardando Pagto” não foram logados.

O status “Completo” sempre chega 14 dias após o primeiro POST recebido referente à aquela transação. Ou seja, se um boleto foi emitido no dia 1, e aprovado no dia 3 você receberá um “Completo” no dia 15 (quatorze dias após o dia primeiro).

Para boleto, o tempo de “Em Análise” para “Aprovado” pode levar de um a dois dias dependendo do caso. Para boleto, o tempo depende do cliente, isso quer dizer que ele tem três dias para pagar o boleto. Mas você receberá o “Completo” quatorze dias após o “Aguardando Pagto” se no meio existir um “Aprovado”. Ao invés de “Aprovado” o você pode receber um POST de “Cancelado” e aí, não há mais interação.

Nota: Alguns POSTs aparecem repetidos devido a testes realizados durante a implantação.

Bom, isso tira todas as minhas dúvidas. Se você tiver alguma dúvida com relação ao retorno automático do PagSeguro, não exite em perguntar. Não cansarei até descobrir a resposta à sua pergunta

Voltamos a um assunto que interessa muitas pessoas: ganhar dinheiro. Talvez você não tenha nada físico para vender, mas você provavelmente tem talento (não, chocolate não) e sabe escrever um bom livro ou mesmo fazer ótimas fotografias. Você pode não saber, mas dá pra ganhar dinheiro com esse seu talento. Por que você não começa a vender arquivos para download? Sim! Por que não?! Comece a explorar o seu lado criativo e faça de seus dons uma forma de fazer lucros.

Crie uma loja virtual. Você pode começar com uma loja poderosa como o Magento ou mesmo uma coisa mais simples como OsCommerce, Joomla o mesmo WordPress. Mas, se você é programador como eu e prefere escrever seu próprio código ou mesmo entender como o sistema de sua loja (ou loja de seus clientes) funcionará, farei uma série de artigos para demonstrar como é simples criar uma loja virtual cujos produtos não são nada além de links para download.

Loja virtual com PagSeguro? Agora ficou fácil!

Para você conseguir acompanhar este “curso” você deve entender um pouco dos seguintes assuntos:

• PagSeguro: Vamos usar esta ferramenta de pagamento online para que nossos clientes se sintam seguros ao comprar em sua loja, então você já pode criar sua conta para podermos fazer a nossa loja virtual
• PHP: Não precisa ser um expert, mas saber conceitos básicos de banco de dados e orientação a objetos já dão um gás
• MySQL: Vamos trabalhar com a dobradinha mais conhecida da Web. Não usaremos o MySQL ao extremo mas iremos fazer um join ou outro
• Ânimo: muitas vezes você irá errar. Podem ser erros básicos como não colocar um ponto-e-virgula/ no seu script, então não desanime e continue em frente

Ok, com os requisitos em mãos vamos por a mão na massa. A começar pela estruturação do nosso banco de dados.

O banco de dados

Vamos precisar basicamente de duas tabelas para organizar os produtos: categorias, produtos. Elas são descritas pelas seguintes queries:

CREATE TABLE `categoria` (
  `id` INTEGER UNSIGNED NOT NULL AUTO_INCREMENT,
  `slug` VARCHAR(45) NOT NULL,
  `titulo` VARCHAR(100) NOT NULL,
  PRIMARY KEY (`id`)
);
 
CREATE TABLE `produto` (
  `id` INTEGER UNSIGNED NOT NULL AUTO_INCREMENT,
  `categoria_id` INTEGER UNSIGNED NOT NULL,
  `slug` VARCHAR(45) NOT NULL,
  `titulo` VARCHAR(100) NOT NULL,
  `descricao` TEXT NOT NULL,
  `valor` FLOAT NOT NULL,
  `url` VARCHAR(32) NOT NULL,
  `imagem` CHAR(32) NOT NULL,
  PRIMARY KEY (`id`)
);

Usaremos os campos “slug” tanto de categoria quanto de produto para a url na loja virtual ficar mais fácil de enteder, é o que chamamos de URLs amigáveis. Repare também que temos “categoria_id” na tabela de produto, é nela que vamos basear a nossa organização, um produto deve ter uma categoria e uma categoria pode ter diversos produtos. Os campos de url e imagem da tabela de produtos conterá o endereço do arquivo físico (o arquivo que o usuário fará o download) e a imagem que aparecerá na loja virtual respectivamente. Eles receberão uma criptografia para a segurança de sua loja, usarei md5 como criptografia.

Muito bem, não vamos nos prender a criação de usuários no nosso sistema. Por quê?! Porque você realmete não precisa disso na sua loja. Se um usuário compra de sua loja ele terá os seus dados no PagSeguro, afinal, ele vai pagar por lá não é mesmo? Então para quê ter dados repetidos no seu sistema? Não vamos fazer também um sistema de login, tenho em mente que você é um programador experto e já sabe fazer isso de olhos fechados. Vamos colocar um sistema de login no nosso sistema sim, claro, mas com um usuário único e uma senha única. Isso para não perdermos o foco da loja virtual.

A outra tabela que iremos precisar é a tabela de compra, nela teremos a compra de cada usuário, assim poderemos reenviar um e-mail ao usuário com os links para onde ele pode efetuar o download dos produtos que ele comprou. Esta tabela também serve para sabermos que o produto foi enviado ao cliente, digo, a data de envio do e-mail. Essa tabela é regida pelo seguinte SQL.

CREATE TABLE `compra` (
  `id` INTEGER UNSIGNED NOT NULL AUTO_INCREMENT,
  `email` VARCHAR(100),
  `produtos` TEXT NOT NULL,
  `transacao_id` VARCHAR(45),
  `status` VARCHAR(45) NOT NULL,
  `data_confirmacao` DATETIME NOT NULL,
  PRIMARY KEY (`id`)
);

Veja que produtos é um campo do tipo do tipo TEXT, nele vamos gravar os ids contidos na tabela produto, separados por virgula. Os campos transacao_id, status e data_confirmacao serão completados ao receber o retorno do PagSeguro.

Com isso já temos as tabelas básicas necessárias para a criação de nossa loja virtual. Fique ligado para a próxima parte dessa série onde vamos montar uma loja virtual voltada para downloads.

• Campo DataTransacao no retorno do PagSeguro
• Palestra PagSeguro na Impacta
• Verifique o retorno automático, sempre!
• [PagSeguro] O campo status
• O PagSeguro mudou a URL de retorno automático, e agora?