Obtener el historial de transacciones

Descripción general

Con el historial de transacciones, su aplicación de monedero digital puede admitir:

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

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

Integración del SDK

Notificación de transacción

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

Obtener transacciones

TransactionHistoryService recupera tanto el historial de transacciones como los detalles de la notificación de transacciones del backend de NFC Wallet.

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 mostrado
• 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 con doble marca)

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

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

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

func transactionHistory() async {
    do {
        let historyService = TransactionHistoryService()
        let records = try await historyService.records(forDigitalCardID: "DIGITAL_CARD_ID")

        for record in records {
            // Muestra los campos del registro en tu interfaz de usuario.
            _ = record.id
            _ = record.date
            _ = record.status
            _ = record.type
            _ = record.currencyCode
            _ = record.amount
            _ = record.displayAmount
            _ = record.merchantName
            _ = record.merchantType
            _ = record.merchantPostalCode
            _ = record.terminalID
            _ = record.merchantID
            _ = record.isAuxiliaryTransaction
        }
    } catch {
        if let error = error as? TransactionHistoryService.Error {
            // Manejar el error.
        }
    }
}

Para tarjetas con doble marca, isAuxiliaryTransaction indica si el registro pertenece a la tarjeta auxiliar.