FAQ|Geral

    Aprenda as melhores práticas para desenvolver sua aplicação, para que seu sistema seja escalável, eficiente e seguro.

     

    Quais são os modelos de terminais SmartPOS com os quais a SDK Stone trabalha?

    A SDK Stone trabalha atualmente com quatro modelos de terminais: Ingenico A8, Sunmi P2-B e Positivo L3 e L4.

     
     

    Quanto tempo um parceiro tem direito ao empréstimo de um terminal de debug para integração?

    O parceiro tem direito ao empréstimo de apenas um terminal de debug por um período de 180 dias.

     
     

    O que acontece após 180 dias de empréstimo do terminal de debug?

    Após 180 dias, será solicitada a devolução do terminal de debug através da logística Stone.

     
     

    Quando o terminal de debug é enviado?

    O terminal de debug será enviado exclusivamente no início da integração, quando a proposta comercial já estiver fechada. Não disponibilizamos terminais para análise.

     
     

    O que fazer se precisar de mais unidades ou um modelo diferente de terminal durante a integração?

    Se precisar de mais unidades ou um modelo diferente, você deve buscar a compra diretamente com a fabricante.

     
     

    Quais são os requisitos mandatórios para o desenvolvimento de um aplicativo com a SDK Stone?

    Alguns dos requisitos mandatórios incluem o desenvolvimento nativo ou híbrido, suporte mínimo à versão 5.0+ do Android, assinatura digital do aplicativo, layout dinâmico/responsivo e uso do SDK Android Stone.

     
     

    Quais são as limitações para o desenvolvimento de aplicativos com a SDK Stone?

    Algumas limitações incluem a proibição de WebApps, WebViews, Websockets e MQTT, a falta de suporte ao Google Play Services, e a necessidade de evitar comunicação com concorrentes diretos ou indiretos da Stone Co.

     
     

    Quais são os fabricantes e modelos de terminais suportados pela SDK Stone?

    A SDK Stone suporta terminais dos fabricantes Ingenico APOS A8, Sunmi P2, Positivo L3 e L4.

     
     

    O que é a homologação no contexto da SDK Stone?

    A homologação é o processo de validação e aprovação da aplicação desenvolvida em conjunto com a SDK Stone. Envolve testes técnicos e verificações para garantir que o aplicativo atenda aos requisitos.

     
     

    Como funciona o processo de homologação dos aplicativos submetidos à SDK Stone?

    O processo de homologação envolve análise técnica, testes de acordo com o roteiro de testes fornecido, avaliação da implementação para cada modelo de terminal POS e análise do AndroidManifest, VersionName, VersionCode e PackageName.

     
     

    Quais são os critérios levados em conta para o rankeamento do aplicativo no Partner Locator da Stone?

    Os critérios para rankeamento incluem o uso da última versão da SDK Android Stone, homologação para todos os terminais, tamanho da APK menor que 60MB e um design de interface de usuário amigável.

     
     

    Como funciona o controle de releases e liberação de aplicativos para os terminais dos clientes Stone?

    O controle de releases envolve o uso de um sistema de gerenciamento de transporte (TMS) que controla a entrega do aplicativo aos terminais dos clientes Stone. Há dois momentos de liberação: Piloto e Rollout, cada um com suas características.

     
     

    Como é feita a liberação de aplicativos para os clientes Stone?

    A liberação pode ser feita pelo credenciamento do cliente, pelo cadastro do cliente ou por Stone Code e CNPJ. Isso pode ser gerenciado através do Partner HUB.

     
     

    Pode alterar o packagename de um aplicativo?

    Não, o packageName é a forma como o Android reconhece um aplicativo. O packageName é o identificador único de cada aplicativo. Caso haja alteração, será necessária uma nova homologação.

     
     

    É possível utilizar API do Android em POS de produção?

    Sim, as únicas API disponíveis para uso são as do próprio Android.

     
     

    Todo o controle da transação de adquirência será realizado pela aplicação de pagamento da Stone? Inclusive a situação das transações pendentes e confirmadas?

    Depende, caso desenvolva utilizando deeplink, sim. A aplicação de pagamento é responsável por toda parte de adquirência.
    No caso de Providers, vocês vão precisar gerir todo o fluxo de pagamento, pendentes, confirmadas e fluxo de telas.

     
     

    Quem deve imprimir o comprovante da transação de pagamento?

    Em caso de deeplink o app de pagamento faz o fluxo de impressão. Em caso de providers, deve utilizar o Providers de Impressão usando o método posPrintProvider.

     
     

    A Stone pode me enviar o apk de pagamento para eu fazer testes?

    Sim, todo terminal debug enviado pela Stone possui os Apps Stone de debug, mas terá acesso apenas ao APK deles.

     
     

    Quais são os cartões aceitos pela Stone nos terminais Android?

    Pode verificar a lista completa na nossa FAQ.

     
     

    Qual campo é referente ao NSU?

    Este dado é conhecido na Stone como StoneID ou ATK (Acquirer Transaction Key), no retorno da SDK pode identificar como "recipientTransactionIdentification".

     
     

    Meu app está sendo recusado na homologação por falta de assinatura. O que fazer?

    Para garantirmos a instalação do seu app em todos os nossos POS, você precisa assinar seu app com ambos os tipos de assinatura, V1 (Jar Signature) e V2 (Full APK Signature).

     
     

     Como faço para adquirir um terminal homologado pela Stone?

    Você terá que entrar em contato com os canais de venda das fabricantes.

    Atenção: Ao entrar em contato com a fabricante, é preciso informar que precisa da chave transacional Stone de teste nos equipamentos, isso viabiliza as transações em teste.

     
     

    Não consigo debugar a solução no dispositivo homologado pela Stone. O que pode ser?

    Primeiro verifique se seu terminal realmente é Mockup(dev). Para essa verificação, deve ter uma marca d'água no centro ou esquerda inferior da tela informando “debug”, ”mockaup” ou “not commercial use”. Caso ele não seja Mockup, você tem em mãos um terminal produtivo, desta forma não será possível debugar sua aplicação, pois as portas USB não funcionam para debug nos terminais produtivos.

     
     

    Existe alguma limitação ou requisito para o uso do Wifi?

    Sim, o POS Stone (launcher), por questões de segurança e PCI, não pode se conectar a uma rede wifi sem segurança (sem senha), assim como também não pode entrar em redes que exijam autenticação via browser.

     
     

    Eu terei que colocar o meu sim card 3G/4G no POS?

    Não, o sim card será da Stone.

     
     

    Posso utilizar um sim card próprio?

    Sim, pode usar um sim card próprio.

     
     

    Existe um ambiente de sandbox para testes com a Stone?

    Sim, existe tanto um ambiente de credenciamento como de autorização para que possa simular os testes transacionais e de ativação do cliente no POS. Para esse cenário, vai precisar também de um terminal de debug (depuração e ambiente do desenvolvedor habilitadas).

     
     

    Posso desenvolver para smartphones?

    Sim, a SDK por providers possui métodos específicos para implementar para mobile. Fique atento às especificações da documentação.

     
     

    Tomei um erro genérico ao testar uma transação, o que significa?

    Fique atento aos retornos do sandbox Stone, explicamos os tipos de código e informações. Esses códigos são pré-setados pelas bandeiras e têm o intuito de ser informativos e não detalhados.

     
     

    Posso utilizar uma biblioteca direto do fabricante do POS que a SDK não possui?

    Sim, não temos limitações em relação ao uso de outras bibliotecas fora do SDK Android. No entanto, o suporte em caso de dúvidas é direto com a fabricante. Fique atento a possíveis conflitos de Libs já usados na SDK Android Stone.

     
     

    Meu computador não reconhece o comando ADB devices, o que eu faço?

    Provavelmente ele não foi instalado corretamente. No gerenciador de dispositivos do computador, deve haver um "Android > Android Composite ADB Interface (landi platforms)". Caso contrário, irá aparecer em "Outros dispositivos > Android".

     
     

    Conseguimos testar em POS produtivos?

    Não, porque as portas USB’s não funcionam para debug, apenas são instalados aplicativos através do Partner HUB. Isso é válido para aplicativos já homologados na Stone.

     
     

    Como eu instalo meu aplicativo no terminal?

    Primeiro verifique se ele realmente é Mockup(dev). Para essa verificação, procure por uma marca d’água na tela, o posicionamento varia de fabricante, mas deve haver a informação de “debug”, “not for user comercial” ou “mockup". Sendo mockup, pode ser utilizado os comandos ADB para realizar a instalação do aplicativo.

     
     

    A versão do Android é 5.0 (21), basta minha aplicação suportar o Android 5.0 (21) ou necessariamente tenho que compilar para SDK 21?

    Isso. Basta ter suporte para a versão 21.

     
     

    Existe a possibilidade de atualizarmos o Sistema operacional da máquina que estamos testando para uma versão mais atual?

    Os modelos de terminais que estamos trabalhando hoje, não temos expectativa de atualizar. Porém já temos no parque o Positivo L4 que já conta com o Android 11. Também no futuro, podemos começar a trabalhar com outros modelos de POS com Android mais atual.

     
     

    Posso compilar em um SDK superior e informar a minSDK 21?

    O target pode ser superior, mas o minSDK deve ser 21.

     
     

    Toda vez que eu mandar uma versão nova a Stone irá homologar?

    Sim, mas dessa vez passará apenas pela homologação do time de QA, consiste em assinar o APK com as fabricantes, testar o download e instalação do APK nos POS e distribuir a nova versão.

     
     

    Meu aplicativo ainda não está pronto, mas eu posso iniciar a homologação da Stone para avaliar a integração com pagamento?

    Não, pois a Stone entende que um aplicativo submetido já está validado pelo desenvolvedor e apto para ser publicado para “produção”. Inclusive, se o APK for aprovado pela homologação, o mesmo será assinado pela Stone e já estará pronto para produção.

     
     

     

    Conseguimos te ajudar?