treslines / pagseguro_android

Integração de pagseguro para android sem usar os aplicativos da pagseguro
MIT License
20 stars 10 forks source link

Pagseguro para Android

Integração de pagseguro para android sem usar os aplicativos nativos da pagseguro

Introdução:

A maioria dos desenvolvedores sabem que a integração do pagseguro para android ainda é algo muito "chato". A integração com os aplicativos nativos da pagseguro ou wallet(carteira) obriga os desenvolvedores a ter os aplicativos instalados e não funcionam perfeitamente. Me aventurando nessa linha, rapidamente percebi que este caminho é muito cheio de impecílios e gerava um monte de código de validação extra.

No entando a pagseguro é bem popular e já tem um grau de maturidade interessante. Os consumidores brasileiros se sentem a vontade pagando com ela, pois a pagseguro tem todo um processo de validação e autorização de pagamentos, além de permitir a abertura de disputas em casos de fraude. Isso lhe torna um meio de pagamento indispensável no mercado brasileiro.

Foi pensando nessa necessidade, que decidi criar uma integração completa. Este aplicativo de demostração atende às necessidades mínimas do programador e em 90% dos casos é mais do que suficiente para a maioria dos aplicativos, que desejam vender algum tipo de pŕoduto.

Funções do aplicativo:

  • Oferece um modelo simples para criação de produtos de acordo com as especifiações da pagseguro
  • A criação de produtos valida as entradas a nível de programação para evitar erros durante a codificação
  • Prevê os cenários/fluxos de navegação em caso de cancelamento, sucesso e erro exibindo mensagens
  • Não requer nenhum aplicativo da pagseguro pre-instalado e realiza as transações atraves de webservices
  • Exibe progresso diretamente na actionbar e atualiza os titulos de acordo com as etapas do pagamento
  • Permite a configuração dos dados da conta do pagseguro através do xml de preferências
  • Bibliotecas usadas:

    Para que o exemplo funcione, usamos uma única biblioteca de REST bem popular também usada pelo Instagram, Pinterest e outros chamada: Android Asynchronous Http Client. Esta biblioteca usa a licença Apache 2.0. Ela pode ser encontrada no link: http://loopj.com/android-async-http/

    Ela está sendo referenciada no build.gradle da app (Module:app)

    dependencies {
    ...
        compile 'com.loopj.android:android-async-http:1.4.8'
    ...
    }

    Exemplo de uso (super simples):

    Depois que o cliente adicionou seus produtos ao seu carrinho (shoppingCart), criamos os objetos da pagseguro com a factory e efetuamos o pagamento. Neste exemplo estamos simulando uma compra simples de apenas um item (playstation)

    // ... 
    // simulating an user buying a playstation
    final PagSeguroFactory pagseguro = PagSeguroFactory.instance();
    List<PagSeguroItem> shoppingCart = new ArrayList<>();
    shoppingCart.add(pagseguro.item("123", "PlayStation", BigDecimal.valueOf(3.50), 1, 300));
    PagSeguroPhone buyerPhone = pagseguro.phone(PagSeguroAreaCode.DDD81, "91111112222");
    PagSeguroBuyer buyer = pagseguro.buyer("Albert Einstein", "04/03/1879", "11122233300", "test@email.com.br", buyerPhone);
    PagSeguroAddress buyerAddress = pagseguro.address("Av. Abc", "99", "Apt507", "Bairro", "12345678", "Cidade", PagSeguroBrazilianStates.PERNAMBUCO);
    PagSeguroShipping buyerShippingOption = pagseguro.shipping(PagSeguroShippingType.PAC, buyerAddress);
    PagSeguroCheckout checkout = pagseguro.checkout("Ref0001", shoppingCart, buyer, buyerShippingOption);
    // starting payment process
    new PagSeguroPayment(MainActivity.this).pay(checkout.buildCheckoutXml());
    // ...

    Preferências Pagseguro

    O arquivo de preferências se chama: pagseguro.xml
    IMPORTANTE: Antes de rodar o exemplo, certifique-se que você substituiu as preferências abaixo pelas suas. Caso contrário o exemplo não irá funcionar! Este exemplo está configurado para rodar em modo SANDBOX, ou seja, não será realizada nenhuma transação de "verdade". Após seus testes, basta substituir as url's de sandbox, pelas reais.

    <resources>
        <!-- we are using pagseguro's sandbox values here. -->
        <!-- you can use your onw values and after tests, use the real values -->
        <string name="pagseguro_vendor_email">yourPagSeguroEmail</string>
        <string name="pagseguro_vendor_token">yourPagSeguroToken</string>
        <string name="pagseguro_webservice_checkout_address" formatted="false">"https://ws.sandbox.pagseguro.uol.com.br/v2/checkout?email=%s&amp;token=%s"</string>
        <string name="pagseguro_payment_page">"https://sandbox.pagseguro.uol.com.br/v2/checkout/payment.html?code=%s"</string>
    </resources>

    Como criar uma conta pagseguro/sandbox?

    Para isso siga o passo-a-passo do post no meu blog: http://cleancodedevelopment-qualityseal.blogspot.com.br/2015/08/how-to-runinstall-pagseguro-on-android.html

    Imagens:

    1 2 3 4 5 6 7 8 9 10 11 12 13 14

    Contribuições - As exigências são mínimas:

  • As classes devem seguir o mesmo padrão das classes modelo com javadoc
  • Faça um fork do projeto, implemente sua contribuição, faça um pull request para este projeto
  • Licença:

    MIT License

    Autor:

    Ricardo Ferreira
    Software Engineer at CESAR http://www.cesar.org.br
    Instagram: ricardo7307
    Twitter: ricardo_7307
    Blog: http://www.cleancodedevelopment-qualityseal.blogspot.com.br