SDK Pix
SDK para uso da funcionalidade de vendas Pi
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:
void pixPaymentSuccessful(JSONObject jo);
void pixPaymentFailed(JSONObject jo);
- Na activity que implementa a interface VoidTransactionListener, que é utilizada para a função de estorno, será necessário implementar o método:
public void voidPixTransactionList(JSONObject jo)
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:
showMessage(String qrc, TerminalMessageType.TRANSACTION_PIX_BRCODE)
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
Updated 8 months ago