From da4dbdc099dc99e57ffc6e8badd522e7865ea19b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Maro=C5=A1=20Silady?=
 <38668012+SMaros@users.noreply.github.com>
Date: Tue, 15 Aug 2023 08:05:19 +0200
Subject: [PATCH] CF-484 - Notification - listener method for failed queued
 transactions (#832)

---
 .../extensions/INotificationListener.java     | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/server_extensions_api/src/main/java/com/generalbytes/batm/server/extensions/INotificationListener.java b/server_extensions_api/src/main/java/com/generalbytes/batm/server/extensions/INotificationListener.java
index 1b8d999f9..f522cc81d 100644
--- a/server_extensions_api/src/main/java/com/generalbytes/batm/server/extensions/INotificationListener.java
+++ b/server_extensions_api/src/main/java/com/generalbytes/batm/server/extensions/INotificationListener.java
@@ -51,6 +51,35 @@ default void transactionFailed(String terminalSerialNumber, BigDecimal cashAmoun
      */
     default void transactionQueued(String terminalSerialNumber, BigDecimal cashAmount, String cashCurrency, String transactionRemoteId, String paymentType) {}
 
+    /**
+     * Invoked when one or more transactions in a queue have failed.
+     *
+     * @param queueName          The name of the queue in which the transactions were queued.
+     * @param batchUid           A unique identifier representing the batch of transactions.
+     * @param failedTransactions A list of transaction details for those transactions which failed.
+     *                           Each transaction detail includes information such as the serial number of the terminal.
+     *
+     * <p>
+     * ITransactionDetails will have the following attributes populated:
+     * <ul>
+     *     <li><b>Terminal Serial Number</b>: Sourced from the transaction's terminal..</li>
+     *     <li><b>Remote ID (Rid)</b>: The Rid associated with the transaction</li>
+     *     <li><b>Local ID (Lid)</b>: The Lid associated with the transaction.</li>
+     *     <li><b>Cash Amount</b>: The fiat amount of transaction.</li>
+     *     <li><b>Cash Currency</b>: The type of fiat currency used in the transaction (e.g., USD, EUR).</li>
+     *     <li><b>Crypto Amount</b>: The fiat amount of transaction.</li>
+     *     <li><b>Crypto Currency</b>: The type of cryptocurrency used in the transaction (e.g., BTC, ETH).</li>
+     *     <li><b>Crypto Address</b>: The destination address for the cryptocurrency transaction.</li>
+     *     <li><b>Identity Public ID</b>: Public identity associated with the transaction, if any.</li>
+     * </ul>
+     * </p>
+     * <p>
+     * All other attributes are either set to default values or empty.
+     * </p>
+     *
+     */
+    default void queuedTransactionsFailed(String queueName, String batchUid, List<ITransactionDetails> failedTransactions) {}
+
     default void cashbackCreated(String terminalSerialNumber, BigDecimal cashAmount, String cashCurrency) {}
 
     default void invalidPaymentReceived(String terminalSerialNumber, BigDecimal amount, String cryptoCurrency, String fromAddress, String toAddress, String transactionRemoteId) {}