FAQ | Providers

    Uma resposta para as principais dúvidas sobre Android Point-of-Sale (POS) para ajudar os usuários a desfrutar de uma experiência simples, segura e rápida.

    Ao realizar uma transação com NFC, obtive o seguinte erro: SWITCH_INTERFACE, como prosseguir?

    SWITCH_INTERFACE ocorre quando o POS teve algum problema durante a comunicação com o cartão, nesse caso é preciso que use o chip em vez de NFC.

     
     

    Ocorreu o seguinte erro no POS:  "ERRO DE CHAVE. POR FAVOR, RETORNE ESTA MÁQUINA PARA STONE". Como seguir?
     

    Este é um pequeno bug já conhecido, estamos trabalhando na resolução, mas caso aconteça com você, basta reiniciar o seu terminal algumas vezes para que esta mensagem não interfira mais.

    Fique tranquilo o erro não afeta a SDK, apenas um bug visual do terminal.

     
     

    Erro ao tentar ativar o POS: "COULD_NOT_ACTIVATE_WITH_ACCEPTOR_CONFIGURATION_UPDATE_DATA_NULL". Como seguir?

    Este erro acontece quando o seu serial Number não foi adicionado ao seu Stonecode de teste, para isso entre em contato com o suporte do time de integrações.  

     
     

    Tentei fazer uma transação no POS de Teste por meio do App de Pagamento e deu o seguinte erro: "ERRO DE PROCESSAMENTO". Como seguir?

    Este erro acontece quando houve  algum problema com as aplicações de Debug instaladas no POS. Para corrigir  você precisa desinstalar e instalar novamente os apps Stone. Entre em contato com o suporte de integrações para ter acesso ao pacote de apps. 

     
     

    É possível alterar a fonte que sai na função addLine do CustomPrintProvider?

    Infelizmente não é possível alterar a fonte da impressão da SDK, apenas é possível alterar o tamanho da fonte e o alinhamento. Para maior possibilidade de customização recomendamos a criação de uma imagem a partir de uma view do android, como o modelo base64 na documentação, aqui.

     
     

    Erro ao realizar uma transação: "Parcelamento ou número de parcelas inválido"

    Para realizar transações de crédito a vista não é necessário enviar o campo installment_count , só enviar os campos amount, transactionType e installmentType sendo este ultimo sendo enviado = NONE.

    E para o Débito é a mesma lógica.

     
     

    Como transacionar VR/VA [voucher] nas maquininhas com a integração SDK Android Stone.

    Diferente das formas de pagamento Débito e Crédito onde a Stone realiza o processamento da transação, no caso de Vouchers é a empresa responsável pelo cartão que realiza o processamento dos pagamentos, por exemplo no caso da Alelo o estabelecimento que vai transacionar com alelo precisa estar credenciado na alelo e devidamente liberado por eles para só então habilitar essa forma de pagamento na Stone e começar a transacionar, mas isso apenas no ambiente de produção.

    No ambiente de testes não temos comunicação com as empresas que gerenciam os vouchers, não sendo possível realizar testes com essa forma de pagamento, sendo possível testar apenas no ambiente de produção.

     
     

    Ao realizar uma transação ocorreu o seguinte erro: "the task has already been executed (a task can be executed only once)"

    Os provirdes são "assíncronos", é necessário criar uma nova instância para uma nova execução do Provider.

     
     

    É possível deixar a tela do terminal sempre acesa?

    Infelizmente não é possível. Essa é uma configuração do POS para trabalhar a economia de bateria. Também entra no tema de modo quiosque, que demanda de uma certificação especifica para liberação que hoje não temos.

     
     

    Ao tentar ativar o terminal e realizar transações deu o seguinte erro: "StoneCode Inválido" ou "Estabelecimento Inválido"

    Identificamos a causa do problema nos terminais Android de debug versão 6.9.0.
    Se seu terminal está nesta versão e, ao ativar ou tentar realizar transações, retornava os erros abaixo:

    "StoneCode Inválido";

    "Estabelecimento Inválido - Não tente novamente".

    Já é possível corrigir, realizando os passos abaixo:

    1 - Desinstalar o package "br.com.stone.posandroid.datacontainer" usando o comando ADB UNINSTALL;

    2 - instalar este apk de acordo com o modelo do seu terminal. Após a instalação, o terminal passará por um "reset";

    3 - Após a reinicialização, realize a associação do seu terminal com o stonecode de testes através deste formulário;

    4 - Por último, basta ativar o terminal novamente com seu StoneCode de testes e o problema será solucionado.

    Obs: Em caso de dúvidas, abra um ticket neste link aqui.

     
     

    Posso trabalhar com mais de um StoneCode?

    Não, sempre 1:1. Se precisar de trocar, o ideal é desativar o anterior para ativar o novo. Método de desativação no provider de Ativação 

     

    “É possível utilizar uma feature chamada ”MultiploStonecode" na SDK, esse modelo permite trabalhar com um StoneCode ativado na SDK diferente do ativado na maquininha POS. Essa modelo funciona apenas em determinados modelos de negocio. Procure seu BizDev ou o time de Integrações para mais detalhes. 

     
     

    O que são ATKs ou StoneID?

    É o identificador único de uma transação gerada pelo Autorizador Stone, seja aprovada ou não uma vez que chega ao nosso ambiente um ATK/StoneID é gerado.

    Mais detalhes em "Conceito Stone"

     
     

    O packagecloud token é igual para todos os terminais?

    Sim, é gerado um Tokem para cada Integrador parceiro, igualmente utilizando na integração com a SDK independente do modelo de terminal.

     
     

    Na Primeira versão é necessário colocar o SDK da Stone?

    Não. Precisa enviar com a função de pagamentos. É impreterível.

     
     

    Ao realizar uma transação ocorreu o seguinte erro: "java.lang.IllegalStateException: KoinApplication has not been started"

    Esse erro pode acontecer quando não é feita a inicialização do SDK.

    Temos um exemplo de uso na nossa demo:
    https://github.com/stone-payments/demo-sdk-android/blob/1b756e23afedb21db5db59a8c4[…]/main/java/br/com/stonesdk/sdkdemo/activities/MainActivity.java 

     

     
     

    O Erro “PED_PASS_NO_KEY_FOUND_ERROR” apareceu ao fazer uma transação.

    Esse erro significa que a chave transacional Stone está faltando ou está errada. É preciso solicitar a trocar o terminal! 

    Entre em contato com seu BizDev ou com o time de integrações 

     
     

    As duas chaves necessárias para o PIX variam para cada estabelecimento, ou para cada terminal?

    Igual/única para todos! Esse é para autenticação na API de Pix, apenas. O transacional é associado com o stonecode ativo na máquina.

     
     

    Ao realizar um cancelamento foi solicitado uma senha administrativa, onde eu consigo?

    A senha administrativa é definida na ativação do terminal, caso não lembre, será necessário realizar o reset do mesmo, pelo Menu > ajustes > Restaurar Dados e ativa-lo novamente.

     
     

    É obrigatório desenvolver minha aplicação para todos os hardwares Stone?

    É de extrema importância que implemente as dependencias de todas as fabricantes homologadas pela Stone, mais detalhes aqui.

    Isso garante a experiencia do cliente e minimiza impacto de troca de terminais nos estabelecimentos.

    Recomendamos a leitura do #GuiaDoDesenvolvedor e em nossa #Documentação para que as suas duvidas sobre implementação das dependências sejam sanadas!

     
     

    A chave PIX de destino do pagamento obrigatoriamente tem que ser da Conta Stone?  Ou pode ser para outro banco (Itaú, Bradesco etc)?

    Precisa ser da Conta Stone

     
     

    Nos dispositivos de produção, o estabelecimento comercial sempre poderá fazer a transação PIX ou depende de contratar o serviço com a Stone?

    Basta ter conta stone ativa e o PIX é ativo

     
     

    Nosso app necessita de um servidor local para funcionar. Como faremos para vocês conseguirem testar? Nosso app necessita de um servidor local para funcionar. Como faremos para vocês conseguirem testar?

    A equipe de integrações, validam o roteiro de testes que o parceiro preenche e envia, e o time de QA valida a estrutura do aplicativo em si, realiza a varredura antimalware no arquivo APK e verifica se o aplicativo é carregado no gerenciador, é baixado, instalado e aberto no terminal.

    Vale ressaltar que não realizamos testes internos no aplicativo em relação ao fluxo, features ou qualquer outra coisa.

    Nossa única validação ocorre no fluxo de pagamento, conforme enviado pelo roteiro de testes.

     
     

    Troquei minha maquina e agora meu app roda a build normalmente mais na hora de instalar o apk ele está dando erro de certificado.

    app-debug.apk: Failure [INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES: --apkPath:/data/app/vmdl1229461020.tmp/base.apkmodelo: GPOS700X

    Para compilar o app no terminal GPOS700X é necessário seguir os passos conforme doc: https://sdkandroid.stone.com.br/reference/preparando-aplicacao#processo-de-build-com-dispositivos-gertec

     
     

     

    Conseguimos te ajudar?