Obtener historial de transacciones

Resumen

Con el historial de transacciones, su aplicación de billetera 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 Manejar notificaciones push.

Obtener transacciones

TransactionHistoryService recupera tanto el historial de transacciones como los detalles de notificaciones de transacciones desde el backend de la Billetera NFC.

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

• ID de la transacción

• Fecha de la transacción

• Tipo de transacción

• Estado de la transacción

• Código de moneda

• Importe e importe para mostrar

• 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 co-marcadas)

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).

• Recuento máximo (por ejemplo, las últimas 10 transacciones).

El siguiente fragmento de código demuestra 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 {
            // Mostrar campos del registro en su 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 co-marcadas, isAuxiliaryTransaction indica si el registro pertenece a la tarjeta auxiliar.