CF-672: ability to send receipt with tx hash

server_extensions_api/src/main/java/com/generalbytes/batm/server/extensions/IExtensionContext.java

@@ -1,5 +1,5 @@
 /*************************************************************************************
- * Copyright (C) 2014-2020 GENERAL BYTES s.r.o. All rights reserved.
+ * Copyright (C) 2014-2024 GENERAL BYTES s.r.o. All rights reserved.
  *
  * This software may be distributed and modified under the terms of the GNU
  * General Public License version 2 (GPL2) as published by the Free Software
@@ -852,4 +852,19 @@ public static class EmbeddedEmailImage {
      * @param serverTimeToUnlock The absolute datetime when the transaction should unlock.
      */
     void unlockTransaction(String rid, Date serverTimeToUnlock);
+
+    /**
+     * Returns the custom string value set in CAS.
+     *
+     * @param machineSerialNumber Terminal or GB Safe serial number.
+     * @param customStringName    Name of custom string.
+     * @param language            Language. For default value, set language to {@code "default"} or leave blank.
+     *                            If no value is found for the specified language, the value for the default language
+     *                            will be returned (if available), otherwise {@code null}.
+     * @return Custom string value from the selected terminal or GB Safe in the selected language. Returns {@code null} if not found.
+     */
+    default String getCustomStringValue(String machineSerialNumber, String customStringName, String language) {
+        return null;
+    }
+
 }

server_extensions_api/src/main/java/com/generalbytes/batm/server/extensions/IReceiptDetails.java

@@ -1,5 +1,5 @@
 /*************************************************************************************
- * Copyright (C) 2014-2020 GENERAL BYTES s.r.o. All rights reserved.
+ * Copyright (C) 2014-2024 GENERAL BYTES s.r.o. All rights reserved.
  *
  * This software may be distributed and modified under the terms of the GNU
  * General Public License version 2 (GPL2) as published by the Free Software
@@ -17,6 +17,8 @@
  ************************************************************************************/
 package com.generalbytes.batm.server.extensions;
 
+import java.util.Set;
+
 public interface IReceiptDetails {
 
     String CUSTOM_DATA_RECEIPT_LANGUAGE = "receipt.language";
@@ -49,4 +51,9 @@ public interface IReceiptDetails {
      */
     String getUserLanguage();
 
+    /**
+     * @return Methods used to send the receipt.
+     */
+    Set<ReceiptTransferMethod> getTransferMethods();
+
 }

server_extensions_api/src/main/java/com/generalbytes/batm/server/extensions/ReceiptTransferMethod.java

@@ -0,0 +1,23 @@
+/*************************************************************************************
+ * Copyright (C) 2014-2024 GENERAL BYTES s.r.o. All rights reserved.
+ *
+ * This software may be distributed and modified under the terms of the GNU
+ * General Public License version 2 (GPL2) as published by the Free Software
+ * Foundation and appearing in the file GPL2.TXT included in the packaging of
+ * this file. Please note that GPL2 Section 2[b] requires that all works based
+ * on this software must also be made publicly available under the terms of
+ * the GPL2 ("Copyleft").
+ *
+ * Contact information
+ * -------------------
+ *
+ * GENERAL BYTES s.r.o.
+ * Web      :  http://www.generalbytes.com
+ *
+ ************************************************************************************/
+package com.generalbytes.batm.server.extensions;
+
+public enum ReceiptTransferMethod {
+    SMS,
+    EMAIL
+}