Getnet DocsGetnet Docs

Pré-requisitos e Configuração

Este guia fornece as etapas necessárias para configurar o seu ambiente antes de integrar a solução Get Tap on Phone (App2App). Você deve trocar detalhes de configuração específicos com o seu processador para estabelecer uma conexão segura e funcional entre o seu aplicativo cliente e a plataforma Tap on Phone.

Passo 1: Configurar a conta da sua organização

Antes de escrever qualquer código, você deve configurar a conta da sua organização de desenvolvedor na plataforma. Você também precisa criar uma ou mais contas de estabelecimento comercial de teste.

Trabalhe com o seu Implementation Manager designado, que gerencia este processo de configuração inicial para você.

Passo 2: Obter as credenciais da sua plataforma

Durante o processo de onboarding, o seu Implementation Manager fornece as credenciais necessárias para acessar a plataforma. Para uma integração App2App, o identificador mais crítico que você recebe é o Client ID.

  • Client ID: Um identificador único para a sua organização. A plataforma usa este ID para rotear corretamente as solicitações de permissão de Single Sign-On (SSO) para o endpoint da sua API de backend.

Você deve passar este Client ID no campo operationMetadata sempre que iniciar um intent que exija validação de SSO (como inicialização ou estornos).

Passo 3: Registrar os detalhes do seu aplicativo

Para garantir que a plataforma Tap on Phone aceite apenas solicitações de fontes autorizadas, você deve fornecer ao seu Implementation Manager os seguintes detalhes sobre o seu aplicativo cliente e backend:

  • Android Package Name: O ID de aplicativo único do seu aplicativo cliente Android (por exemplo, com.yourcompany.pos).
  • Android Certificate Fingerprint (SHA-256): O hash criptográfico do certificado que você usa para assinar o seu aplicativo Android. A plataforma usa isso para verificar a autenticidade do seu app.
  • SSO API Endpoint: Uma URL HTTPS segura e acessível pela internet hospedada no seu backend. O backend do Tap on Phone chama este endpoint para autorizar sessões de usuários e operações sensíveis.

Passo 4: Configurar o seu ambiente de teste

Em um ambiente de produção, todas as credenciais e detalhes do aplicativo são estritamente únicos para a sua integração. No entanto, para ajudar você a começar a desenvolver e testar imediatamente no ambiente de sandbox, você pode usar um conjunto de valores padrão pré-configurados.

Use os seguintes valores para construir os seus intents App2App iniciais:

ParâmetroValor de Teste em Sandbox
Android App Package Namecom.dejamobile.cbp.sps.app
Client ID4bac0922d476436697283b8238ba282b
Merchant ID19
User ID19
User Token1234567

Próximos Passos

Agora que você entende as credenciais necessárias e os parâmetros de configuração, o seu próximo passo é preparar o seu servidor para gerenciar as solicitações de autorização da plataforma Tap on Phone.

Prossiga para Integração de Backend: Gerenciando Solicitações de SSO para configurar o seu endpoint de SSO API.