FAQ - SDK¶
Onde posso encontrar a documentação da PayStore ?
A documentação da PayStore (API, SDK, Android) deve ser acessada através do Portal PayStore. Para acessá-la, é necessário logar com suas credenciais de desenvolvedor.
Qual é o ambiente de desenvolvimento (IDE) usado pela PayStore ?
Recomendamos o uso do Android Studio.
Onde posso encontrar a lib e os projetos de exemplo ?
A lib e projetos de exemplo podem ser acessados através do link GitHub PayStore
Posso usar a mesma configuração de um terminal em outro ?
Não. Cada terminal precisa de um número único previamente cadastrado. Do contrário, será apresentada a mensagem "Sequencial inválido".
Não estou conseguindo fazer transações ou inicializar o terminal. O que pode ser ?
Entre em contato com o Suporte.
Para instalar a aplicação em um terminal físico, é necessário ter um cartão SD ?
Não. Os terminais convencionais não suportam cartão SD.
Se a carga estiver na sua máquina, use um cabo USB ou serial, dependendo do modelo do terminal.
Os terminais Verifone suportam carga via pendrive.
Os terminais PAX **não** suportam carga via pendrive.
O terminal está exibindo "Número de série inválido". O que pode ser ?
Provavelmente está faltando o cadastro desse terminal na PayStore. Solicite que seu terminal seja cadastrado.
Se o problema persistir, contate o Suporte.
Por que está ocorrendo o erro "Bad request" ?
Contate o Suporte informando data, hora e serial do equipamento, para que possamos investigar a causa desse problema.
Existe alguma forma de fazer a atualização da aplicação sem ser pela USB ?
Sim. Através do sistema de carga remota, chamado de PhDM, é possível realizar cargas no terminal remotamente. Contudo, dependendo da versão instalada no terminal, esse processo só poderá ser feito para terminais que tenham inicializado alguma vez.
Se a necessidade é apenas instalar um App, basta colocá-lo na Loja de Aplicativos para ser baixado no terminal, sem precisar dar carga local ou executar atualização remota no terminal.
É possível efetuar a primeira carga via o sistema de telecarga "PhDM" ?
Não. A primeira carga deve ser feita por carga local, via USB ou serial.
Que aplicação eu devo carregar inicialmente no terminal ?
Você vai receber um pacote que contém as seguintes aplicações:
- Payments.apk
- Acquirer.apk
- Plataform.apk
- PaystoreClient.apk
Esse pacote de aplicações é disponibilizado pela equipe de Suporte.
Como eu carrego a aplicação no terminal ?
A aplicação deve ser carregada via ADB. Para mais informações consulte a documentação, opção comece por aqui.
Onde consigo os drivers Windows para dar carga via USB nos terminais ?
Entre em contato com o fabricante ou fornecedor dos seus terminais para solicitar os drivers.
Eu posso fazer uma venda digitando o número do cartão de crédito ou débito ?
Depende. Se a adquirente permitir transações digitadas, sim. Por exemplo, a Global Payments e Adiq permitem transações digitadas. Já a Stone, normalmente, não permite.
Entre em contato com sua adquirente e verifique as condições para ativação desta modalidade no estabelecimento. Isso envolve análise de risco do estabelecimento.
Por que está ocorrendo a mensagem "Operação manual não permitida" ?
Provavelmente você tentou fazer uma transação de venda digitada e a adquirente não permite.
Como posso simular a captura de um cartão no terminal virtual (Emulador) ?
Não é possível simular a captura de um cartão usando o emulador. Atualmente, isso só é possível através de um terminal físico.
Quando publico um app que desenvolvi, ele fica disponível para todos os terminais da PayStore ou apenas para os terminais da minha empresa ?
O seu app vai ficar disponível apenas para os terminais da sua rede. Esses níveis de visibilidade podem ser configuráveis através da PayStore. Essa configuração é chamada de "Filtros de Publicação" e pode ser aplicada por Cidade, Ramos de Atividade, Grupo de Lojistas ou Terminais específicos.
Posso definir o número do estabelecimento de acordo com o ID do meu cliente ?
Sim, na PayStore pelo Portal do Facilitador, você pode definir o identificador do estabelecimento no cadastro de lojistas de forma muito simples.
Posso mudar a ordem de captura das informações, por exemplo, capturar o valor antes de passar o cartão ?
Sim, basta fazer a captura do valor antes de chamar a API de pagamento.
Posso alterar a logo do meu comprovante ?
Sim, essa logo pode ser alterada no Portal da PayStore.
Como adicionar informação extra ao terminal como, por exemplo, o "ID dos meus clientes" ?
Para adicionar uma informação ao terminal, acesse o Portal da PayStore, no menu "Configurações", selecione a opção “Campos Adicionais”.
Como capturar a informação de um Campo Adicional ?
Vide a documentação.
É possível alterar ou adicionar informações ao comprovante ?
Isso depende da adquirente. Algumas adquirentes enviam o comprovante já formatado para ser impresso no terminal. Para outras adquirentes, é possível criar o comprovante no Servidor TEF, posicionando e formatando as informações da forma desejada.
A PayStore também suporta a impressão de comprovantes gráficos. Neste caso, o terminal POS utiliza as informações enviadas pela adquirente ou Servidor TEF, para formatar os comprovantes usando um layout gráfico. No layout gráfico, o desenvolvedor tem total liberdade de construir o comprovante.
Em todo caso, a alteração nos comprovantes ou o uso de comprovante gráfico deve ser submetido para validação pela adquirente, uma vez que a descaracterização do comprovante (modelo) pode ser encarada como um possível problema para ações futuras, tais como dificuldade na identificação das transações nas centrais de atendimento, possível bloqueio das bandeiras quanto aos dados informados no comprovante, etc. Por padrão, as adquirentes, normalmente, exigem que todas as informações presentes no seu comprovante original sejam preservadas no comprovante customizado pela subadquirente.