README.markdown in pagseguro-0.1.8 vs README.markdown in pagseguro-0.1.9.beta.0
- old
+ new
@@ -1,12 +1,10 @@
-PAGSEGURO
-=========
+# PAGSEGURO
Este é um plugin do Ruby on Rails que permite utilizar o [PagSeguro](https://pagseguro.uol.com.br/?ind=689659), gateway de pagamentos do [UOL](http://uol.com.br).
-SOBRE O PAGSEGURO
------------------
+## SOBRE O PAGSEGURO
### Carrinho Próprio
Trabalhando com carrinho próprio, sua loja mantém os dados do carrinho. O processo de inclusão de produtos no carrinho de compras acontece no próprio site da loja. Quando o comprador quiser finalizar sua compra, ele é enviado ao PagSeguro uma única vez com todos os dados de seu pedido. Aqui também, você tem duas opções. Pode enviar os dados do pedido e deixar o PagSeguro solicitar os dados do comprador, ou pode solicitar todos os dados necessários para a compra em sua loja e enviá-los ao PagSeguro.
@@ -14,19 +12,17 @@
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](https://pagseguro.uol.com.br/Security/ConfiguracoesWeb/RetornoAutomatico.aspx).
Antes de enviar o usuário para essa URL, o robô do PagSeguro faz um POST para ela, em segundo plano, com os dados e status da transação. Lendo esse POST, você pode obter o status do pedido. Se o pagamento entrou em análise, ou se o usuário pagou usando boleto bancário, o status será "Aguardando Pagamento" ou "Em Análise". 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.**
-REQUISITOS
-----------
+## REQUISITOS
A versão atual que está sendo mantida suporta Rails 3.0.0 ou superior.
Se você quiser esta biblioteca em versão mais antigas do Rails (2.3, por exemplo) deverá usar o [branch legacy](http://github.com/fnando/pagseguro/tree/legacy). Note que esta versão não será mais atualizada com novas funcionalidades; apenas correções de bugs serão aplicadas.
-COMO USAR
----------
+## COMO USAR
### Configuração
O primeiro passo é instalar a biblioteca. Para isso, basta executar o comando
@@ -185,24 +181,27 @@
* `approved`: Aprovado
* `verifying`: Em análise
* `canceled`: Cancelado
* `refunded`: Devolvido
-AUTOR:
-------
+### Codificação (Encoding)
+Esta biblioteca assume que você está usando UTF-8 como codificação de seu projeto. Neste caso, o único ponto onde os dados são convertidos para UTF-8 é quando uma notificação é enviada do UOL em ISO-8859-1.
+
+Se você usa sua aplicação como ISO-8859-1, esta biblioteca NÃO IRÁ FUNCIONAR. Nenhum patch dando suporte ao ISO-8859-1 será aplicado; você sempre pode manter o seu próprio fork, caso precise.
+
+## AUTOR:
+
Nando Vieira (<http://simplesideias.com.br>)
Recomendar no [Working With Rails](http://www.workingwithrails.com/person/7846-nando-vieira)
-COLABORADORES:
---------------
+## COLABORADORES:
* Elomar (<http://github.com/elomar>)
* Rafael (<http://github.com/rafaels>)
-LICENÇA:
---------
+## LICENÇA:
(The MIT License)
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the