[NEB-4777] Add KYC, geo, and bot-detection structured fields

CHANGES.MD

@@ -1,3 +1,11 @@
+3.23.0 (2026-08-20)
+=================
+- Added support for `$nationality`, `$year_of_birth` fields to `$create_account`, `$update_account` events
+- Added support for `$kyc` complex field to `$create_account`, `$update_account`, `$transaction`,
+  `$create_order`, `$update_order`, `$verification` events
+- Added support for `$geo`, `$bot_identification` complex fields to `$create_account`,
+  `$update_account`, `$login`, `$transaction`, `$create_order`, `$update_order` events
+
 3.22.0 (2026-01-05)
 =================
 - Added support for `$user_email`, `$review.$reviewed_user_id` fields to `$create_content`, `$update_content` events

README.md

@@ -13,13 +13,13 @@ Java 1.7 or later.
 <dependency>
     <groupId>com.siftscience</groupId>
     <artifactId>sift-java</artifactId>
-    <version>3.22.0</version>
+    <version>3.23.0</version>
 </dependency>
 ```
 ### Gradle
 ```
 dependencies {
-    compile 'com.siftscience:sift-java:3.22.0'
+    compile 'com.siftscience:sift-java:3.23.0'
 }
 ```
 ### Other

build.gradle

@@ -5,7 +5,7 @@ apply plugin: 'signing'
 apply plugin: 'java-library-distribution'
 
 group = 'com.siftscience'
-version = '3.22.0'
+version = '3.23.0'
 
 repositories {
     mavenCentral()

src/main/java/com/siftscience/model/BaseAccountFieldSet.java

@@ -18,6 +18,11 @@ public abstract class BaseAccountFieldSet<T extends BaseAccountFieldSet<T>>
     @Expose @SerializedName("$social_sign_on_type") private String socialSignOnType;
     @Expose @SerializedName("$merchant_profile") private MerchantProfile merchantProfile;
     @Expose @SerializedName(VERIFICATION_PHONE_NUMBER) private String verificationPhoneNumber;
+    @Expose @SerializedName("$nationality") private String nationality;
+    @Expose @SerializedName("$year_of_birth") private Integer yearOfBirth;
+    @Expose @SerializedName("$kyc") private Kyc kyc;
+    @Expose @SerializedName("$geo") private Geo geo;
+    @Expose @SerializedName("$bot_identification") private BotIdentification botIdentification;
 
     public String getUserEmail() {
         return userEmail;
@@ -117,4 +122,49 @@ public T setPromotions(List<Promotion> promotions) {
         this.promotions = promotions;
         return (T) this;
     }
+
+    public String getNationality() {
+        return nationality;
+    }
+
+    public T setNationality(String nationality) {
+        this.nationality = nationality;
+        return (T) this;
+    }
+
+    public Integer getYearOfBirth() {
+        return yearOfBirth;
+    }
+
+    public T setYearOfBirth(Integer yearOfBirth) {
+        this.yearOfBirth = yearOfBirth;
+        return (T) this;
+    }
+
+    public Kyc getKyc() {
+        return kyc;
+    }
+
+    public T setKyc(Kyc kyc) {
+        this.kyc = kyc;
+        return (T) this;
+    }
+
+    public Geo getGeo() {
+        return geo;
+    }
+
+    public T setGeo(Geo geo) {
+        this.geo = geo;
+        return (T) this;
+    }
+
+    public BotIdentification getBotIdentification() {
+        return botIdentification;
+    }
+
+    public T setBotIdentification(BotIdentification botIdentification) {
+        this.botIdentification = botIdentification;
+        return (T) this;
+    }
 }

src/main/java/com/siftscience/model/BaseOrderFieldSet.java

@@ -27,6 +27,9 @@ public abstract class BaseOrderFieldSet<T extends BaseOrderFieldSet<T>>
     @Expose @SerializedName("$merchant_profile") private MerchantProfile merchantProfile;
     @Expose @SerializedName(VERIFICATION_PHONE_NUMBER) private String verificationPhoneNumber;
     @Expose @SerializedName("$digital_orders") private List<DigitalOrder> digitalOrders;
+    @Expose @SerializedName("$kyc") private Kyc kyc;
+    @Expose @SerializedName("$geo") private Geo geo;
+    @Expose @SerializedName("$bot_identification") private BotIdentification botIdentification;
 
     public String getOrderId() {
         return orderId;
@@ -211,4 +214,31 @@ public T setDigitalOrders(List<DigitalOrder> digitalOrders) {
         this.digitalOrders = digitalOrders;
         return (T) this;
     }
+
+    public Kyc getKyc() {
+        return kyc;
+    }
+
+    public T setKyc(Kyc kyc) {
+        this.kyc = kyc;
+        return (T) this;
+    }
+
+    public Geo getGeo() {
+        return geo;
+    }
+
+    public T setGeo(Geo geo) {
+        this.geo = geo;
+        return (T) this;
+    }
+
+    public BotIdentification getBotIdentification() {
+        return botIdentification;
+    }
+
+    public T setBotIdentification(BotIdentification botIdentification) {
+        this.botIdentification = botIdentification;
+        return (T) this;
+    }
 }

src/main/java/com/siftscience/model/BotIdentification.java

@@ -0,0 +1,27 @@
+package com.siftscience.model;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+
+public class BotIdentification {
+    @Expose @SerializedName("$result") private String result;
+    @Expose @SerializedName("$provider") private String provider;
+
+    public String getResult() {
+        return result;
+    }
+
+    public BotIdentification setResult(String result) {
+        this.result = result;
+        return this;
+    }
+
+    public String getProvider() {
+        return provider;
+    }
+
+    public BotIdentification setProvider(String provider) {
+        this.provider = provider;
+        return this;
+    }
+}

src/main/java/com/siftscience/model/Geo.java

@@ -0,0 +1,27 @@
+package com.siftscience.model;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+
+public class Geo {
+    @Expose @SerializedName("$uuid") private String uuid;
+    @Expose @SerializedName("$provider") private String provider;
+
+    public String getUuid() {
+        return uuid;
+    }
+
+    public Geo setUuid(String uuid) {
+        this.uuid = uuid;
+        return this;
+    }
+
+    public String getProvider() {
+        return provider;
+    }
+
+    public Geo setProvider(String provider) {
+        this.provider = provider;
+        return this;
+    }
+}

src/main/java/com/siftscience/model/Kyc.java

@@ -0,0 +1,47 @@
+package com.siftscience.model;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+
+public class Kyc {
+    @Expose @SerializedName("$names_match") private Boolean namesMatch;
+    @Expose @SerializedName("$kyc_level") private String kycLevel;
+    @Expose @SerializedName("$bin_nationality_match") private Boolean binNationalityMatch;
+    @Expose @SerializedName("$provider") private String provider;
+
+    public Boolean getNamesMatch() {
+        return namesMatch;
+    }
+
+    public Kyc setNamesMatch(Boolean namesMatch) {
+        this.namesMatch = namesMatch;
+        return this;
+    }
+
+    public String getKycLevel() {
+        return kycLevel;
+    }
+
+    public Kyc setKycLevel(String kycLevel) {
+        this.kycLevel = kycLevel;
+        return this;
+    }
+
+    public Boolean getBinNationalityMatch() {
+        return binNationalityMatch;
+    }
+
+    public Kyc setBinNationalityMatch(Boolean binNationalityMatch) {
+        this.binNationalityMatch = binNationalityMatch;
+        return this;
+    }
+
+    public String getProvider() {
+        return provider;
+    }
+
+    public Kyc setProvider(String provider) {
+        this.provider = provider;
+        return this;
+    }
+}

src/main/java/com/siftscience/model/LoginFieldSet.java

@@ -17,6 +17,8 @@ public static LoginFieldSet fromJson(String json) {
     @Expose @SerializedName("$account_types") private List<String> accountTypes;
     @Expose @SerializedName(USER_EMAIL) private String userEmail;
     @Expose @SerializedName(VERIFICATION_PHONE_NUMBER) private String verificationPhoneNumber;
+    @Expose @SerializedName("$geo") private Geo geo;
+    @Expose @SerializedName("$bot_identification") private BotIdentification botIdentification;
 
     @Override
     public String getEventType() {
@@ -79,4 +81,22 @@ public LoginFieldSet setVerificationPhoneNumber(String verificationPhoneNumber)
         this.verificationPhoneNumber = verificationPhoneNumber;
         return this;
     }
+
+    public Geo getGeo() {
+        return geo;
+    }
+
+    public LoginFieldSet setGeo(Geo geo) {
+        this.geo = geo;
+        return this;
+    }
+
+    public BotIdentification getBotIdentification() {
+        return botIdentification;
+    }
+
+    public LoginFieldSet setBotIdentification(BotIdentification botIdentification) {
+        this.botIdentification = botIdentification;
+        return this;
+    }
 }

src/main/java/com/siftscience/model/TransactionFieldSet.java

@@ -38,6 +38,9 @@ public class TransactionFieldSet extends BaseAppBrowserSiteBrandFieldSet<Transac
     @Expose @SerializedName("$maximum_withdrawal_amount") private Long maximumWithdrawalAmount;
     @Expose @SerializedName("$current_balance") private Long currentBalance;
     @Expose @SerializedName("$new_balance") private Long newBalance;
+    @Expose @SerializedName("$kyc") private Kyc kyc;
+    @Expose @SerializedName("$geo") private Geo geo;
+    @Expose @SerializedName("$bot_identification") private BotIdentification botIdentification;
 
 
     @Override
@@ -328,4 +331,31 @@ public TransactionFieldSet setNewBalance(Long newBalance) {
         this.newBalance = newBalance;
         return this;
     }
+
+    public Kyc getKyc() {
+        return kyc;
+    }
+
+    public TransactionFieldSet setKyc(Kyc kyc) {
+        this.kyc = kyc;
+        return this;
+    }
+
+    public Geo getGeo() {
+        return geo;
+    }
+
+    public TransactionFieldSet setGeo(Geo geo) {
+        this.geo = geo;
+        return this;
+    }
+
+    public BotIdentification getBotIdentification() {
+        return botIdentification;
+    }
+
+    public TransactionFieldSet setBotIdentification(BotIdentification botIdentification) {
+        this.botIdentification = botIdentification;
+        return this;
+    }
 }

src/main/java/com/siftscience/model/VerificationFieldSet.java

@@ -14,6 +14,7 @@ public static VerificationFieldSet fromJson(String json) {
     @Expose @SerializedName("$reason") private String reason;
     @Expose @SerializedName("$verified_event") private String verifiedEvent;
     @Expose @SerializedName("$verified_entity_id") private String verifiedEntityId;
+    @Expose @SerializedName("$kyc") private Kyc kyc;
 
     @Override
     public String getEventType() {
@@ -67,4 +68,13 @@ public VerificationFieldSet setVerifiedEntityId(String verifiedEntityId) {
         this.verifiedEntityId = verifiedEntityId;
         return this;
     }
+
+    public Kyc getKyc() {
+        return kyc;
+    }
+
+    public VerificationFieldSet setKyc(Kyc kyc) {
+        this.kyc = kyc;
+        return this;
+    }
 }