Guias de ImplementaçãoReferência da APIAPI StatusAjuda

O recém lançadoSDK Android 2.3.0 traz a esperada funcionalidade de venda Pix por QRCODE e fornece uma maneira simples e de alto nível de suportar transações Pix, além das outras formas de pagamentos presenciais já conhecidas e disponibilizadas pela Zoop. Assim o seu aplicativo pode aceitar pagamentos Pix com todo a segurança.

  • Suporte a Charge com Pix ** - Como Implementar **

Primeiramente você deve seguir todas as configurações definidas para o SDK 2.1.8 conforme a documentação neste site nas seções anteriores a esta.

Uma vez feitas as configurações regulares para venda com cartão, você precisará adicionar as seguintes etapas para habilitar o uso do Pix no seu app:

  • Na sua** activity** que implementa a Interface **TerminalPaymentListener,** que você já usa para a função de charge, você precisará implementar os métodos:


  • Na  **activity** que implementa a interface **VoidTransactionListener**, que é utilizada para a função de estorno, será necessário implementar o método:

Estes métodos serão invocados automaticamente (callback) como resposta a sua transação Pix contendo sucesso ou falha do pagamento (venda ou estorno) e detalhes da mesma no JSON recebido o qual você pode utilizar da forma mais conveniente para sua aplicação.
** Sobre a operação Charge Pix  - Como Funciona**
As chamadas chargePix() disponíveis na classe que instancia TerminalPayment invocarão assincronamente o método showMessage da sua Activity de charge no seguinte formato:

O primeiro é o código de barras QRCODE (BRCODE) definido no Manual Brasileiro do Pix BRCODE, que deverá ser demonstrado na tela para o usuário para pagamento enquanto aguarda (loop de espera) pelo retorno do sucesso ou falha da transação.
O segundo parametro serve para seu app identificar que os dados recebidos sao um QRCODE PIX e não uma string de mensagem de tela por exemplo.
O timeout do pagamento é de 15 minutos.
Em não existindo retorno do pagamento Pix seu app receberá uma callback de falha de pagamento através de pixPaymentFailed() implementado na sua activity de Charge.
 Para demonstrar o gráfico QRCODE de forma simples e rápida, recomendamos usar a biblioteca Android Zebra ZXwing devido à facilidade de uso, mas pode ser outra de sua escolha. 
Caso deseje entender melhor os dados recebidos no QRCODE PIX (BRCODE) você pode consultar o Manual Brasileiro do Pix diretamente no [site do Banco Central](🔗)