AppsFlyerSDK
diff --git a/‎CHANGELOG.md‎
Lines changed: 8 additions & 0 deletions b/‎CHANGELOG.md‎
Lines changed: 8 additions & 0 deletions
diff --git a/‎README.md‎
Lines changed: 3 additions & 3 deletions b/‎README.md‎
Lines changed: 3 additions & 3 deletions
diff --git a/‎android/build.gradle‎
Lines changed: 1 addition & 1 deletion b/‎android/build.gradle‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎android/src/main/java/com/appsflyer/appsflyersdk/AppsFlyerConstants.java‎
Lines changed: 1 addition & 1 deletion b/‎android/src/main/java/com/appsflyer/appsflyersdk/AppsFlyerConstants.java‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎android/src/main/java/com/appsflyer/appsflyersdk/AppsflyerSdkPlugin.java‎
Lines changed: 107 additions & 0 deletions b/‎android/src/main/java/com/appsflyer/appsflyersdk/AppsflyerSdkPlugin.java‎
Lines changed: 107 additions & 0 deletions
diff --git a/‎doc/API.md‎
Lines changed: 112 additions & 0 deletions b/‎doc/API.md‎
Lines changed: 112 additions & 0 deletions
diff --git a/‎doc/AdvancedAPI.md‎
Lines changed: 52 additions & 1 deletion b/‎doc/AdvancedAPI.md‎
Lines changed: 52 additions & 1 deletion
@@ -1,5 +1,13 @@
 # Versions
 
+## 6.17.3
+
+- Updated to AppsFlyer SDK v6.17.3 for both Android and iOS
+- Added validateAndLogInAppPurchaseV2 API (Beta) for improved cross-platform purchase validation
+- Unified AFPurchaseDetails data structure for type-safe purchase validation
+- Enhanced error handling and consistent API across Android and iOS
+- Maintains backward compatibility with existing purchase validation methods
+
 ## 6.17.1
 
 - Android: Bug fix for users who expirienced `NullPointerExceptions`.
 
@@ -11,13 +11,13 @@
 
 ## SDK Versions
 
-- Android AppsFlyer SDK **v6.17.0**
-- iOS AppsFlyer SDK **v6.17.1**
+- Android AppsFlyer SDK **v6.17.3**
+- iOS AppsFlyer SDK **v6.17.3**
 
 ### Purchase Connector versions
 
 - Android 2.1.1
-- iOS 6.17.1
+- iOS 6.17.3
 
 ## ❗❗ Breaking changes when updating to v6.x.x❗❗
 
 
@@ -53,7 +53,7 @@ android {
 dependencies {
     implementation fileTree(dir: 'libs', include: ['*.jar'])
     implementation 'androidx.appcompat:appcompat:1.0.0'
-    implementation 'com.appsflyer:af-android-sdk:6.17.0'
+    implementation 'com.appsflyer:af-android-sdk:6.17.3'
     implementation 'com.android.installreferrer:installreferrer:2.2'
 //    implementation 'androidx.core:core-ktx:1.13.1'
     if (includeConnector) {
 
@@ -1,7 +1,7 @@
 package com.appsflyer.appsflyersdk;
 
 public final class AppsFlyerConstants {
-    final static String PLUGIN_VERSION = "6.17.1";
+    final static String PLUGIN_VERSION = "6.17.3";
     final static String AF_APP_INVITE_ONE_LINK = "appInviteOneLink";
     final static String AF_HOST_PREFIX = "hostPrefix";
     final static String AF_HOST_NAME = "hostName";
 
@@ -11,9 +11,12 @@
 
 import com.appsflyer.AFAdRevenueData;
 import com.appsflyer.AFLogger;
+import com.appsflyer.AFPurchaseDetails;
+import com.appsflyer.AFPurchaseType;
 import com.appsflyer.AppsFlyerConsent;
 import com.appsflyer.AppsFlyerConversionListener;
 import com.appsflyer.AppsFlyerInAppPurchaseValidatorListener;
+import com.appsflyer.AppsFlyerInAppPurchaseValidationCallback;
 import com.appsflyer.AppsFlyerLib;
 import com.appsflyer.AppsFlyerProperties;
 import com.appsflyer.MediationNetwork;
@@ -286,6 +289,9 @@ public void onMethodCall(MethodCall call, Result result) {
             case "validateAndLogInAppAndroidPurchase":
                 validateAndLogInAppPurchase(call, result);
                 break;
+            case "validateAndLogInAppPurchaseV2":
+                validateAndLogInAppPurchaseV2(call, result);
+                break;
             case "getAppsFlyerUID":
                 getAppsFlyerUID(result);
                 break;
@@ -796,6 +802,107 @@ private void validateAndLogInAppPurchase(MethodCall call, Result result) {
         result.success(null);
     }
 
+    private void validateAndLogInAppPurchaseV2(MethodCall call, Result result) {
+        try {
+            // Get the complete purchase details map
+            Map<String, Object> purchaseDetailsMap = (Map<String, Object>) call.argument("purchaseDetails");
+            Map<String, String> additionalParameters = (Map<String, String>) call.argument("additionalParameters");
+
+            if (purchaseDetailsMap == null) {
+                result.error("INVALID_ARGUMENTS", "Purchase details cannot be null", null);
+                return;
+            }
+
+            if (additionalParameters == null) {
+                additionalParameters = new HashMap<>();
+            }
+
+            // Extract fields from purchase details map
+            String purchaseTypeString = (String) purchaseDetailsMap.get("purchaseType");
+            String purchaseToken = (String) purchaseDetailsMap.get("purchaseToken");
+            String productId = (String) purchaseDetailsMap.get("productId");
+
+            // Validate required fields
+            if (purchaseTypeString == null || purchaseToken == null || productId == null) {
+                result.error("INVALID_ARGUMENTS", "Purchase details must contain purchaseType, purchaseToken, and productId", null);
+                return;
+            }
+
+            // Map Dart enum values to Android AFPurchaseType enum
+            AFPurchaseType purchaseType = mapPurchaseType(purchaseTypeString);
+            if (purchaseType == null) {
+                result.error("INVALID_PURCHASE_TYPE", "Invalid purchase type: " + purchaseTypeString + ". Expected: 'subscription' or 'one_time_purchase'", null);
+                return;
+            }
+
+            // Create AFPurchaseDetails object
+            AFPurchaseDetails purchaseDetails = new AFPurchaseDetails(
+                purchaseType,
+                purchaseToken,
+                productId
+            );
+
+            Log.d(AF_PLUGIN_TAG, "validateAndLogInAppPurchaseV2 called with " + purchaseDetailsMap);
+            
+            AppsFlyerLib.getInstance().validateAndLogInAppPurchase(
+                purchaseDetails,
+                additionalParameters,
+                new AppsFlyerInAppPurchaseValidationCallback() {
+                    @Override
+                    public void onInAppPurchaseValidationFinished(@NonNull Map<String, ?> validationFinishedResult) {
+                        Log.d(AF_PLUGIN_TAG, "Purchase validation V2 response arrived");
+                        
+                        // Convert the result to a format Flutter can understand
+                        Map<String, Object> flutterResult = new HashMap<>();
+                        for (Map.Entry<String, ?> entry : validationFinishedResult.entrySet()) {
+                            flutterResult.put(entry.getKey(), entry.getValue());
+                        }
+                        
+                        result.success(flutterResult);
+                    }
+
+                    @Override
+                    public void onInAppPurchaseValidationError(@NonNull Map<String, ?> validationErrorResult) {
+                        Log.d(AF_PLUGIN_TAG, "Purchase validation V2 returned error");
+                        
+                        String errorMessage = "Purchase validation failed";
+                        if (validationErrorResult.containsKey("error_message")) {
+                            errorMessage = (String) validationErrorResult.get("error_message");
+                        }
+                        
+                        // Convert error result to Flutter format
+                        Map<String, Object> flutterErrorResult = new HashMap<>();
+                        for (Map.Entry<String, ?> entry : validationErrorResult.entrySet()) {
+                            flutterErrorResult.put(entry.getKey(), entry.getValue());
+                        }
+                        
+                        result.error("VALIDATION_ERROR", errorMessage, flutterErrorResult);
+                    }
+                }
+            );
+            
+        } catch (Exception e) {
+            Log.e(AF_PLUGIN_TAG, "Error in validateAndLogInAppPurchaseV2: " + e.getMessage(), e);
+            result.error("VALIDATION_ERROR", "Purchase validation failed: " + e.getMessage(), null);
+        }
+    }
+
+    /**
+     * Maps Dart enum string to Android AFPurchaseType enum.
+     * @param purchaseTypeString The string representation from Dart
+     * @return AFPurchaseType enum or null if invalid
+     */
+    private AFPurchaseType mapPurchaseType(String purchaseTypeString) {
+        switch (purchaseTypeString) {
+            case "subscription":
+                return AFPurchaseType.SUBSCRIPTION;
+            case "one_time_purchase":
+                return AFPurchaseType.ONE_TIME_PURCHASE;
+            default:
+                return null;
+        }
+    }
+
     private void registerValidatorListener() {
         AppsFlyerInAppPurchaseValidatorListener validatorListener = new AppsFlyerInAppPurchaseValidatorListener() {
             @Override
 
@@ -6,6 +6,8 @@
 - [AppsFlyerOptions](#appsflyer-options)
 - [AdRevenueData](#AdRevenueData)
 - [AFMediationNetwork](#AFMediationNetwork)
+- [AFPurchaseDetails](#AFPurchaseDetails)
+- [AFPurchaseType](#AFPurchaseType)
 
 ## Methods
 - [initSdk](#initSdk)
@@ -35,6 +37,7 @@
 - [getHostPrefix](#getHostPrefix)
 - [updateServerUninstallToken](#updateServerUninstallToken)
 - [Validate Purchase](#validatePurchase)
+- [validateAndLogInAppPurchaseV2](#validatePurchaseV2)
 - [sendPushNotificationData](#sendPushNotificationData)
 - [addPushNotificationDeepLinkPath](#addPushNotificationDeepLinkPath)
 - [User Invite](#userInvite)
@@ -511,6 +514,54 @@ appsFlyerSdk.updateServerUninstallToken("token");
 ---
 **<a id="validatePurchase"> Validate Purchase**
 
+***Cross-Platform V2 API (Recommended - BETA):***
+
+> ⚠️ **BETA Feature**: This API is currently in beta. While it's stable and recommended for new implementations, please test thoroughly in your environment before production use.
+
+**`Future<Map<String, dynamic>> validateAndLogInAppPurchaseV2(AFPurchaseDetails purchaseDetails, {Map<String, String>? additionalParameters})`**
+
+The new unified purchase validation API that works across both Android and iOS platforms. This is the recommended approach for validating in-app purchases.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `purchaseDetails` | `AFPurchaseDetails` | Purchase details containing type, token, and product ID |
+| `additionalParameters` | `Map<String, String>?` | Optional additional parameters |
+
+**AFPurchaseDetails:**
+| Property | Type | Description |
+|----------|------|-------------|
+| `purchaseType` | `AFPurchaseType` | Type of purchase (oneTimePurchase or subscription) |
+| `purchaseToken` | `String` | Purchase token from the app store |
+| `productId` | `String` | Product identifier |
+
+**AFPurchaseType:**
+- `AFPurchaseType.oneTimePurchase` - For one-time in-app purchases
+- `AFPurchaseType.subscription` - For subscription purchases
+
+_Example:_
+```dart
+// Create purchase details
+AFPurchaseDetails purchaseDetails = AFPurchaseDetails(
+  purchaseType: AFPurchaseType.oneTimePurchase,
+  purchaseToken: "your_purchase_token",
+  productId: "your_product_id",
+);
+
+// Validate purchase
+try {
+  Map<String, dynamic> result = await appsFlyerSdk.validateAndLogInAppPurchaseV2(
+    purchaseDetails,
+    additionalParameters: {"custom_param": "value"}
+  );
+  print("Validation successful: $result");
+} catch (e) {
+  print("Validation failed: $e");
+}
+```
+
+---
+
+***Legacy APIs:***
 
 ***Android:***
 
@@ -572,6 +623,67 @@ appsflyerSdk.onPurchaseValidation((res){
 });
 ```
 
+---
+
+##### <a id="validatePurchaseV2"> **validateAndLogInAppPurchaseV2 (Recommended - BETA)**
+
+> ⚠️ **BETA Feature**: This API is currently in beta. While it's stable and recommended for new implementations, please test thoroughly in your environment before production use.
+
+**`Future<Map<String, dynamic>> validateAndLogInAppPurchaseV2(AFPurchaseDetails purchaseDetails, {Map<String, String>? additionalParameters})`**
+
+The unified cross-platform purchase validation API introduced in SDK v6.17.3. This is the recommended approach for validating in-app purchases as it provides a consistent interface across Android and iOS.
+
+|| parameter | type  | description |
+|| --------- | ----- | ----------- |
+|| `purchaseDetails` | `AFPurchaseDetails` | Purchase details object containing purchase type, token, and product ID |
+|| `additionalParameters` | `Map<String, String>?` | Optional additional parameters to send with the validation request |
+
+**Returns:** `Future<Map<String, dynamic>>` - Validation result with detailed response information
+
+**AFPurchaseDetails Properties:**
+
+|| property | type  | description |
+|| -------- | ----- | ----------- |
+|| `purchaseType` | `AFPurchaseType` | Type of purchase (`AFPurchaseType.oneTimePurchase` or `AFPurchaseType.subscription`) |
+|| `purchaseToken` | `String` | Purchase token obtained from the app store |
+|| `productId` | `String` | Product identifier of the purchased item |
+
+_Example:_
+
+```dart
+// Create purchase details
+AFPurchaseDetails purchaseDetails = AFPurchaseDetails(
+  purchaseType: AFPurchaseType.subscription,
+  purchaseToken: "your_purchase_token_from_store",
+  productId: "premium_subscription_monthly",
+);
+
+// Validate the purchase
+try {
+  Map<String, dynamic> validationResult = await appsflyerSdk.validateAndLogInAppPurchaseV2(
+    purchaseDetails,
+    additionalParameters: {
+      "app_version": "1.2.0",
+      "validation_source": "flutter_example"
+    }
+  );
+  
+  print("✅ Purchase validation successful!");
+  print("Validation result: $validationResult");
+  
+} catch (e) {
+  print("❌ Purchase validation failed: $e");
+  // Handle validation error
+}
+```
+
+**Key Benefits:**
+- **Cross-platform compatibility**: Works on both Android and iOS with the same API
+- **Type safety**: Uses structured data classes instead of platform-specific parameters  
+- **Enhanced error handling**: Provides detailed error information in structured format
+- **Future-proof**: Built on AppsFlyer's latest V2 validation infrastructure
+- **Automatic routing**: Automatically routes to correct validation endpoints based on purchase type
+
 ---
 ## **<a id="sendPushNotificationData"> `void sendPushNotificationData(Map? userInfo)`**
 
 
@@ -114,7 +114,58 @@ appsFlyerSdk.generateInviteLink(inviteLinkParams,
 Receipt validation is a secure mechanism whereby the payment platform (e.g. Apple or Google) validates that an in-app purchase indeed occurred as reported.<br>
 Learn more - https://support.appsflyer.com/hc/en-us/articles/207032106-Receipt-validation-for-in-app-purchases<br>
 
-There are two different functions, one for iOS and one for Android:
+**Cross-Platform V2 API (Recommended - SDK v6.17.3+) - BETA:**
+
+> ⚠️ **BETA Feature**: This API is currently in beta. While it's stable and recommended for new implementations, please test thoroughly in your environment before production use.
+
+The new unified purchase validation API that works across both Android and iOS platforms:
+
+```dart
+Future<Map<String, dynamic>> validateAndLogInAppPurchaseV2(
+      AFPurchaseDetails purchaseDetails,
+      {Map<String, String>? additionalParameters})
+```
+
+**AFPurchaseDetails class:**
+```dart
+AFPurchaseDetails(
+  purchaseType: AFPurchaseType,    // oneTimePurchase or subscription
+  purchaseToken: String,           // Purchase token from app store
+  productId: String,               // Product identifier
+)
+```
+
+Example:
+```dart
+// Create purchase details
+AFPurchaseDetails purchaseDetails = AFPurchaseDetails(
+  purchaseType: AFPurchaseType.oneTimePurchase,
+  purchaseToken: "sample_purchase_token_12345",
+  productId: "com.example.product",
+);
+
+// Validate purchase (works on both Android and iOS)
+try {
+  Map<String, dynamic> result = await appsFlyerSdk.validateAndLogInAppPurchaseV2(
+    purchaseDetails,
+    additionalParameters: {"custom_param": "value"}
+  );
+  print("Validation successful: $result");
+} catch (e) {
+  print("Validation failed: $e");
+}
+```
+
+**Benefits of V2 API:**
+- ✅ **Cross-platform**: Single API works on both Android and iOS
+- ✅ **Type-safe**: Uses structured data classes instead of raw strings
+- ✅ **Better error handling**: Returns structured error information
+- ✅ **Enhanced validation**: Uses AppsFlyer's latest validation infrastructure
+- ✅ **Future-proof**: Built for AppsFlyer's V2 validation endpoints
+
+---
+
+**Legacy Platform-Specific APIs:**
 
 **Android:**
 ```dart