Obtener el historial de transacciones

Resumen

El historial de transacciones permite a tu aplicación de cartera digital admitir:

• Notificaciones de transacciones
• Actualización del historial de transacciones

Durante la incorporación, confirme que el historial de transacciones está habilitado en la configuración de su programa.

Integración del SDK

Notificaciones de transacciones

Para admitir notificaciones de transacciones, procese Notificaciones TNS (transacciones) como se describe en Gestionar notificaciones push.

Recuperar historial de transacciones

MGTransactionHistoryService.refreshHistory(...) recupera los registros de transacciones del backend de NFC Wallet.

Si admite tarjetas de doble marca, use la sobrecarga que acepta transactionRecordType para recuperar registros primarios o auxiliares.

El registro de transacción contiene la siguiente información:

• ID de transacción
• Fecha de la transacción
• Tipo de transacción
• Estado de la transacción
• Código de moneda
• Importe e importe de visualización
• Nombre del comerciante
• Tipo de comerciante
• Código postal del comerciante
• ID del terminal
• ID del comerciante
• Indicador de tarjeta principal o auxiliar (para tarjetas de doble marca)

Los límites del historial de transacciones dependen de la red de pago:

• Ventana de tiempo (por ejemplo, transacciones de los últimos 30 días).
• Número máximo (por ejemplo, las últimas 10 transacciones).

Implementación

Para recuperar el historial de transacciones de una tarjeta digital:

1. Obtenga el correspondiente ID de tarjeta digital.

   Consulte Mostrar tarjetas digitales.
2. Obtenga un token de acceso.

   Consulte Obtenga un token de acceso.
3. (Opcional) Proporcione el transactionRecordType :

   PRIMARIO o AUXILIAR usar en tarjetas de doble marca y proporcionado en Gestionar notificaciones push.
4. Llamar a MGTransactionHistoryService.refreshHistory(...) e implemente TransactionHistoryListener:

   1. onSuccess

      Se activa cuando el SDK recupera correctamente las transacciones. La devolución de llamada proporciona un List<MGTransactionRecord>.

      Cada MGTransactionRecord representa un registro de transacción.
   2. onError

      Se activa cuando el SDK no puede recuperar el historial de transacciones. Use MobileGatewayError para obtener detalles del error.

El siguiente fragmento de código demuestra cómo recuperar los registros de transacciones:

GetTransactionHistory.java

// Valores inicializados previamente.
String digitalCardId = "...";
String accessToken = "...";

// Obtenga el servicio de historial de transacciones.
MobileGatewayManager mgClient = MobileGatewayManager.INSTANCE;
MGTransactionHistoryService transactionHistoryService = mgClient.getTransactionHistoryService();

// Obtenga el historial de transacciones.
transactionHistoryService.refreshHistory(
        accessToken,
        digitalCardId,
        null,
        new TransactionHistoryListener() {

            @Override
            public void onSuccess(
                    List<MGTransactionRecord> records,
                    String digitalCardId,
                    String timeStamp) {
                // Éxito.
                // Cada MGTransactionRecord contiene detalles de una transacción.
                // Consulte la referencia de la API para obtener detalles a nivel de campo.
            }

            @Override
            public void onError(String digitalCardId, MobileGatewayError error) {
                // Maneja el error.
            }
        }
);