CF-484 - Notification - listener method for failed queued transactions (

#832)

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) {}