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