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
HTTPSsegura 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âmetro | Valor de Teste em Sandbox |
|---|---|
| Android App Package Name | com.dejamobile.cbp.sps.app |
| Client ID | 4bac0922d476436697283b8238ba282b |
| Merchant ID | 19 |
| User ID | 19 |
| User Token | 1234567 |
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.