Merge branch 'master' into sync1.7toMaster

gradle.properties

@@ -1,6 +1,6 @@
 # buildscript - project id
 projectGroup=com.generalbytes.batm.public
-projectVersion=1.7.7
+projectVersion=1.8.1
 
 # buildscript - common dependency versions
 bitrafaelVersion=1.0.44

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

@@ -0,0 +1,56 @@
+
+package com.generalbytes.batm.server.extensions;
+
+/**
+ * Australia district identifiers.
+ * <p>
+ * Usage e.g.:
+ * CountryHongKong.HCW.getProvinceName()
+ * CountryHongKong.valueOf("HCW").getProvinceName()
+ */
+public enum CountryHongKong {
+    HCW("HCW", "Central and Western Hong Kong Island"),
+    HEA("HEA", "Eastern Hong Kong Island"),
+    HSO("HSO", "Southern Hong Kong Island"),
+    HWC("HWC", "Wan Chai Hong Kong Island"),
+    KKC("KKC", "Kowloon City Kowloon"),
+    KKT("KKT", "Kwun Tong Kowloon"),
+    KSS("KSS", "Sham Shui Po Kowloon"),
+    KWT("KWT", "Wong Tai Sin Kowloon"),
+    KYT("KYT", "Yau Tsim Mong Kowloon"),
+    NIS("NIS", "Islands New Territories"),
+    NKT("NKT", "Kwai Tsing New Territories"),
+    NNO("NNO", "North New Territories"),
+    NSK("NSK", "Sai Kung New Territories"),
+    NST("NST", "Sha Tin New Territories"),
+    NTM("NTM", "Tuen Mun New Territories"),
+    NTP("NTP", "Tai Po New Territories"),
+    NTW("NTW", "Tsuen Wan New Territories"),
+    NYL("NYL", "Yuen Long New Territories");
+
+    private final String iso;
+
+    private final String provinceName;
+
+    /**
+     * Private constructor.
+     */
+    CountryHongKong(String iso, String provinceName) {
+        this.iso = iso;
+        this.provinceName = provinceName;
+    }
+
+    /**
+     * ISO 3166-2 code of the province (2 digits).
+     */
+    public String getIso() {
+        return iso;
+    }
+
+    /**
+     * English province/territory name officially used by the ISO 3166 Maintenance Agency (ISO 3166/MA).
+     */
+    public String getProvinceName() {
+        return provinceName;
+    }
+}

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

@@ -337,4 +337,11 @@ default void verificationProviderApproved(String terminalSerialNumber, String id
 
     default void verificationProviderDeclined(String terminalSerialNumber, String identityPublicId) {}
 
+    /**
+     * Notification triggered when a used exchange pair is not available.
+     *
+     * @param fromCurrency Source currency in the exchange pair.
+     * @param toCurrency Destination currency in the exchange pair.
+     */
+    default void exchangePairNotAvailable(String fromCurrency, String toCurrency) {}
 }