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 5 months ago