Comunicación basada en Intent

Esta página explica cómo la integración Get Mini App2App utiliza intents de Android para permitir la comunicación entre tu aplicación y la app Get Mini.

¿Qué son los intents de Android?

Los intents de Android son objetos de mensajería utilizados para solicitar una acción de otro componente de una aplicación. En la integración Get Mini App2App, los intents sirven como el mecanismo principal de comunicación entre tu aplicación y la app Get Mini.

Cómo funciona

La comunicación entre tu aplicación y la app Get Mini sigue un patrón simple de solicitud-respuesta. Tu aplicación crea un intent con una cadena de acción específica y los parámetros requeridos, y luego lo inicia utilizando las API de resultados de actividad (activity result) de Android. El sistema Android dirige el intent a la aplicación Get Mini, la cual procesa la transacción y devuelve el control a tu aplicación con los datos del resultado.

Acciones y parámetros de intent

La integración Get Mini utiliza tres acciones distintas de intent: una para pagos (es.redsys.paysys.mPOSRedsys_PAYMENT_REQUEST), una para consultas (es.redsys.paysys.mPOSRedsys_QUERY_REQUEST) y una para devoluciones (es.redsys.paysys.mPOSRedsys_REFUND_REQUEST). Cada acción requiere parámetros específicos pasados como extras del intent, tales como importes de transacción, rangos de fechas o detalles de autorización de transacciones anteriores.

Para obtener las especificaciones completas de todas las acciones y parámetros de intent, consulta la página de referencia de Parámetros de solicitud.

Gestión de respuestas

Una vez que la app Get Mini completa la transacción, devuelve el control a tu aplicación con un código de resultado y extras del intent. El código de resultado indica éxito (RESULT_OK) o fallo (RESULT_CANCELED), mientras que los extras contienen información detallada de la transacción, como los números de autorización, los mensajes de error y el ticket certificado.

Gestión de errores

Si la app Get Mini no está instalada en el dispositivo, intentar iniciar el intent lanzará una ActivityNotFoundException. Tu aplicación debe capturar esta excepción y guiar al usuario para que instale la app desde Google Play. Utiliza siempre bloques try-catch al iniciar intents, y analiza todos los extras de respuesta, incluso cuando las transacciones fallen, ya que contienen información valiosa sobre el error.

Para obtener orientación sobre cómo gestionar la disponibilidad de la aplicación, consulta Gestionar la disponibilidad de la aplicación.