Getnet DocsGetnet Docs

Prerrequisitos y configuración

Esta guía proporciona los pasos necesarios para configurar tu entorno antes de integrar la solución Get Tap on Phone (App2App). Debes intercambiar detalles de configuración específicos con tu procesador para establecer una conexión segura y funcional entre tu app cliente y la plataforma Tap on Phone.

Paso 1: Configurar la cuenta de tu organización

Antes de escribir cualquier código, debes configurar la cuenta de tu organización de desarrollador en la plataforma. También necesitas crear una o más cuentas de comercio de prueba.

Trabaja con tu Implementation Manager asignado, quien gestiona este proceso de configuración inicial para ti.

Paso 2: Obtener las credenciales de tu plataforma

Durante el proceso de incorporación, tu Implementation Manager te proporciona las credenciales necesarias para acceder a la plataforma. Para una integración App2App, el identificador más crítico que recibes es el Client ID.

  • Client ID: Un identificador único para tu organización. La plataforma utiliza este ID para enrutar correctamente las solicitudes de permiso de Single Sign-On (SSO) al endpoint de tu API backend.

Debes pasar este Client ID en el campo operationMetadata siempre que inicies un intent que requiera validación de SSO (como inicialización o reembolsos).

Paso 3: Registrar los detalles de tu aplicación

Para garantizar que la plataforma Tap on Phone solo acepte solicitudes de fuentes autorizadas, debes proporcionar a tu Implementation Manager los siguientes detalles sobre tu app cliente y backend:

  • Nombre del paquete Android: El ID de aplicación único de tu app cliente Android (por ejemplo, com.yourcompany.pos).
  • Huella digital del certificado Android (SHA-256): El hash criptográfico del certificado que utilizas para firmar tu aplicación Android. La plataforma lo utiliza para verificar la autenticidad de tu app.
  • Endpoint API para solicitudes SSO: Una URL HTTPS segura y accesible por internet alojada en tu backend. El backend de Tap on Phone llama a este endpoint para autorizar sesiones de usuario y operaciones sensibles.

Paso 4: Configurar tu entorno de prueba

En un entorno de producción, todas las credenciales y detalles de la aplicación son estrictamente únicos para tu integración. Sin embargo, para ayudarte a comenzar a desarrollar y probar inmediatamente en el entorno de pruebas, puedes utilizar un conjunto de valores predeterminados preconfigurados.

Utiliza los siguientes valores para construir tus intents App2App iniciales:

ParámetroValor de Prueba
Android App Package Namecom.dejamobile.cbp.sps.app
Client ID4bac0922d476436697283b8238ba282b
Merchant ID19
User ID19
User Token1234567

Próximos pasos

Ahora que comprendes las credenciales necesarias y los parámetros de configuración, tu próximo paso es preparar tu servidor para gestionar las solicitudes de autorización de la plataforma Tap on Phone.

Continúa en Integración Backend: Gestión de Solicitudes de SSO para configurar tu endpoint de SSO API.