Getnet DocsGetnet Docs

Arquitectura y flujo

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

El modelo de integración App2App permite una comunicación local segura y fluida en el mismo terminal Android. La comunicación ocurre entre una aplicación de automatización de terceros y la Getnet Payment App instalada en el terminal.

Mecanismo de comunicación: Android Intents

El intercambio de datos no requiere una conexión persistente. En su lugar, usa Android Intents y deeplinks para disparar comandos y recibir respuestas.

  • Un Intent es un objeto de mensajería que se usa para solicitar una acción a otro componente de la app.

  • Un deeplink es un URI específico (por ejemplo, getnet://payment/v1/payment) que funciona como la “dirección” de una función específica dentro de la Getnet App.

Comandos admitidos

Esta tabla resume las operaciones que tu aplicación puede solicitar al terminal Getnet:

OperaciónURI del deeplinkDescripción
Pagogetnet://payment/v1/paymentInicia una transacción de pago (tarjeta o QR Code).
Preautorizacióngetnet://payment/v1/pre-authRetiene fondos temporalmente en la tarjeta de crédito del cliente.
Devolucióngetnet://payment/v1/refundRevierte una transacción aprobada previamente.
Datos del comerciogetnet://payment/v1/commerce-dataObtiene los datos de registro del comercio.
Obtener informacióngetnet://payment/v1/get-infoObtiene datos técnicos del terminal (S/N, OS, versión).
Pollinggetnet://payment/v1/pollingVerifica si la app de pago está lista para atender solicitudes.
Reimpresióngetnet://payment/v1/last-transactionDevuelve o reimprime el último comprobante.
Reportesgetnet://payment/v1/reportsObtiene el historial de transacciones (lista detallada o resumen de totales).
Turnogetnet://payment/v1/shiftAdministra los turnos (configurar, cambiar u obtener información del turno).
Cancelar operacióngetnet://payment/v1/cancel-operationCancela una operación de deeplink en curso.
Consultar estadogetnet://payment/v1/transaction-check-statusBusca el estado de una transacción anterior específica.

El ciclo de vida de la transacción

El proceso sigue tres etapas principales. Al final de la operación, el control de la interfaz vuelve a tu app:

  1. Inicio (solicitud): tu app dispara un Intent con un URI de deeplink específico y los parámetros de la solicitud enviados como extras.

  2. Procesamiento (flujo de interfaz): la Getnet Payment App toma el control de la interfaz para interactuar con el usuario o procesar la transacción.

  3. Retorno (callback): al finalizar, la Getnet Payment App devuelve los parámetros de respuesta como extras del Intent mediante el método onActivityResult.

Siguientes pasos