Add disableAppSetId API and new validateAndLogInAppPurchase (V2) API

Author: al-af

CHANGELOG.md

@@ -1,3 +1,33 @@
+## 6.17.21
+ Release date: *2025-08-08*
+
+- React Native >> Add new `disableAppSetId` API for Android platform
+- React Native >> Add new `validateAndLogInAppPurchase` API with AFPurchaseDetails support
+- React Native >> Update Android SDK to 6.17.2
+- React Native >> Update Plugin to v6.17.21
+
+## 6.17.2
+ Release date: *2025-07-30*
+
+- React Native >> Add Purchase Connector and Swift AppDelegate support to Expo config plugin
+- React Native >> expo 53 and RN 0.79 support
+- React Native >> Add Expo Android Purchase Connector support
+- React Native >> Fix withAppsFlyerAndroid configuration
+- React Native >> Update Plugin to v6.17.2
+
+## 6.17.1
+ Release date: *2025-07-01*
+
+- React Native >> Update iOS Purchase Connector to 6.17.1
+- React Native >> Update Plugin to v6.17.1
+
+## 6.17.0
+ Release date: *2025-06-15*
+
+- React Native >> Add Purchase Connector support with StoreKit2 option
+- React Native >> Update iOS & Android SDKs to 6.17.0
+- React Native >> Update Plugin to v6.17.0
+
 ## 6.16.2
  Release date: *2025-03-19*
 

Docs/RN_API.md

@@ -31,6 +31,7 @@ The list of available methods for this plugin is described below.
   - [setSharingFilter](#setsharingfilter)
   - [setSharingFilterForPartners](#setsharingfilterforpartners)
   - [validateAndLogInAppPurchase](#validateandloginapppurchase)
+  - [validateAndLogInAppPurchase(NEW)](#validateandloginapppurchasev2)
   - [updateServerUninstallToken](#updateserveruninstalltoken)
   - [sendPushNotificationData](#sendpushnotificationdata)
   - [addPushNotificationDeepLinkPath](#addpushnotificationdeeplinkpath)
@@ -44,6 +45,7 @@ The list of available methods for this plugin is described below.
   - [setCollectIMEI](#setcollectimei)
   - [setDisableNetworkData `setDisableNetworkData(disable)`](#setdisablenetworkdata-setdisablenetworkdatadisable)
   - [performOnDeepLinking](#performondeeplinking)
+  - [disableAppSetId](#disableappsetid)
 - [iOS Only APIs](#ios-only-apis)
   - [disableCollectASA](#disablecollectasa)
   - [disableIDFVCollection](#disableidfvcollection)
@@ -627,6 +629,53 @@ appsFlyer.validateAndLogInAppPurchase(info, res => console.log(res), err => cons
 
 ---
 
+## New In-App Purchase Validation API
+The new `validateAndLogInAppPurchase` API uses `AFPurchaseDetails` and `AFPurchaseType` enum for structured purchase validation.
+
+### AFPurchaseType Enum
+
+```javascript
+import { AFPurchaseType } from 'react-native-appsflyer';
+
+AFPurchaseType.SUBSCRIPTION        // "subscription"
+AFPurchaseType.ONE_TIME_PURCHASE   // "one-time-purchase"
+```
+
+### AFPurchaseDetails Interface
+
+```typescript
+interface AFPurchaseDetails {
+  purchaseType: AFPurchaseType;    // Type of purchase
+  transactionId: string;           // Unique transaction identifier
+  productId: string;               // Product identifier
+}
+```
+
+### Usage Example
+
+```javascript
+import appsFlyer, { AFPurchaseType } from 'react-native-appsflyer';
+
+const purchaseDetails = {
+  purchaseType: AFPurchaseType.SUBSCRIPTION,
+  transactionId: "google_play_purchase_token_123",
+  productId: "com.example.app.premium_monthly"
+};
+
+const additionalParams = {
+  revenue: 9.99,
+  currency: "USD"
+};
+
+appsFlyer.validateAndLogInAppPurchase(
+  purchaseDetails,
+  additionalParams,
+  (result) => console.log(result)
+);
+```
+
+---
+
 ### updateServerUninstallToken
 `updateServerUninstallToken(token, callback)`
 
@@ -948,6 +997,25 @@ if (Platform.OS == 'android') {
 
 appsFlyer.startSdk(); // <--- Here we send launch
 ```
+
+### disableAppSetId 
+`disableAppSetId()`
+
+**Disable the collection of AppSet ID.**<br/>
+**Must be called before calling start.**<br/>
+
+*Example:*
+```javascript
+if (Platform.OS == 'android') {
+  appsFlyer.disableAppSetId();
+  appsFlyer.initSdk({
+    devKey: 'K2***********99',
+    isDebug: false,
+    appId: '41*****44',
+  });
+}
+```
+
 ## iOS Only APIs
 
 ### disableCollectASA 

android/src/main/java/com/appsflyer/reactnative/RNAppsFlyerModule.java

@@ -776,6 +776,55 @@ public void onValidateInAppFailure(String error) {
         });
     }
 
+    @ReactMethod
+    public void validateAndLogInAppPurchaseV2(ReadableMap purchaseDetails, ReadableMap additionalParameters, Callback callback) {
+        try {
+            String purchaseType = purchaseDetails.getString("purchaseType");
+            String purchaseToken = purchaseDetails.getString("transactionId");
+            String productId = purchaseDetails.getString("productId");
+
+            // Convert purchaseType string to AFPurchaseType enum
+            AFPurchaseType afPurchaseType;
+            if ("subscription".equals(purchaseType)) {
+                afPurchaseType = AFPurchaseType.SUBSCRIPTION;
+            } else {
+                afPurchaseType = AFPurchaseType.ONE_TIME_PURCHASE;
+            }
+
+            // Create AFPurchaseDetails object
+            AFPurchaseDetails afPurchaseDetails = new AFPurchaseDetails(afPurchaseType, purchaseToken, productId);
+
+            // Convert additionalParameters to Map
+            Map<String, String> additionalParamsMap = null;
+            if (additionalParameters != null) {
+                additionalParamsMap = RNUtil.toMap(additionalParameters);
+            }
+
+            AppsFlyerLib.getInstance().validateAndLogInAppPurchase(
+                    afPurchaseDetails,
+                    additionalParamsMap,
+                    new AppsFlyerInAppPurchaseValidationCallback() {
+                        @Override
+                        public void onSuccess() {
+                            if (callback != null) {
+                                callback.invoke("In App Purchase Validation completed successfully!");
+                            }
+                        }
+
+                        @Override
+                        public void onError(int errorCode, String errorMessage) {
+                            if (callback != null) {
+                                callback.invoke("Error: " + errorMessage);
+                            }
+                        }
+                    });
+        } catch (Exception e) {
+            if (callback != null) {
+                callback.invoke("Error: " + e.getMessage());
+            }
+        }
+    }
+
     @ReactMethod
     public void sendPushNotificationData(ReadableMap pushPayload, Callback errorCallback) {
         JSONObject payload = RNUtil.readableMapToJson(pushPayload);
@@ -879,6 +928,11 @@ public void performOnDeepLinking() {
         }
     }
 
+    @ReactMethod
+    public void disableAppSetId() {
+        AppsFlyerLib.getInstance().disableAppSetId();
+    }
+
     @ReactMethod
     public void enableTCFDataCollection(Boolean enabled) {
         AppsFlyerLib.getInstance().enableTCFDataCollection(enabled);

index.d.ts

@@ -102,6 +102,22 @@ declare module "react-native-appsflyer" {
     additionalParameters?: object;
   }
 
+  export enum AFPurchaseType {
+    SUBSCRIPTION = "subscription",
+    ONE_TIME_PURCHASE = "one-time-purchase"
+  }
+
+  export interface AFPurchaseDetails {
+    purchaseType: AFPurchaseType;
+    transactionId: string; //aka PurchaseToken
+    productId: string;
+  }
+
+  export interface AppsFlyerInAppPurchaseValidationCallback {
+    onSuccess?: (result?: any) => void;
+    onError?: (error?: any) => void;
+  }
+
   export interface SetEmailsOptions {
     emails?: string[];
     emailsCryptType: AF_EMAIL_CRYPT_TYPE | 0 | 3;
@@ -350,11 +366,23 @@ declare module "react-native-appsflyer" {
       latitude: number,
       successC?: SuccessCB
     ): void;
+    /**
+     * [LEGACY WARNING] This is the legacy validateAndLogInAppPurchase API.
+     */
     validateAndLogInAppPurchase(
       purchaseInfo: InAppPurchase,
       successC: SuccessCB,
       errorC: ErrorCB
     ): Response<string>;
+    /**
+     * [NEW API] This is the new validateAndLogInAppPurchase API with AFPurchaseDetails.
+     */
+    validateAndLogInAppPurchase(
+      purchaseDetails: AFPurchaseDetails,
+      additionalParameters?: object,
+      callback?: AppsFlyerInAppPurchaseValidationCallback
+    ): void;
+
     updateServerUninstallToken(token: string, successC?: SuccessCB): void;
     sendPushNotificationData(pushPayload: object, errorC?: ErrorCB): void;
     setHost(hostPrefix: string, hostName: string, success: SuccessCB): void;
@@ -390,6 +418,7 @@ declare module "react-native-appsflyer" {
     setCollectAndroidID(isCollect: boolean, successC?: SuccessCB): void;
     setDisableNetworkData(disable: boolean): void;
     performOnDeepLinking(): void;
+    disableAppSetId(): void;
   };
 
   export default appsFlyer;

index.js

@@ -846,18 +846,26 @@ appsFlyer.disableCollectASA = (shouldDisable) => {
 };
 
 /**
- * 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.
- * Learn more - https://support.appsflyer.com/hc/en-us/articles/207032106-Receipt-validation-for-in-app-purchases
- * @param purchaseInfo ReadableMap includes: String publicKey, String signature, String purchaseData, String price, String currency, JSONObject additionalParameters.
- * @param successC Success callback
- * @param errorC Error callback
+ * Validate and log in-app purchase with support for both legacy and new APIs.
+ * 
+ * - **Legacy API**: validateAndLogInAppPurchase(purchaseInfo, successC, errorC) 
+ * - **New API**: validateAndLogInAppPurchase(purchaseDetails, additionalParameters, callback) 
+ * 
+ * The method automatically detects which API to use based on the parameters:
+ * - If first parameter has 'purchaseType' property, uses new API
+ * - Otherwise, uses legacy API
  */
-appsFlyer.validateAndLogInAppPurchase = (purchaseInfo, successC, errorC) => {
-  return RNAppsFlyer.validateAndLogInAppPurchase(
-    purchaseInfo,
-    successC,
-    errorC
-  );
+appsFlyer.validateAndLogInAppPurchase = (param1, param2, param3) => {
+  // Detect which API to use based on the first parameter
+  if (param1 && typeof param1 === 'object' && param1.purchaseType) {
+    // New API: (purchaseDetails, additionalParameters, callback)
+    console.log('[AppsFlyer] Using new validateAndLogInAppPurchase API with AFPurchaseDetails');
+    return RNAppsFlyer.validateAndLogInAppPurchaseV2(param1, param2, param3);
+  } else {
+    // Legacy API: (purchaseInfo, successC, errorC)
+    console.log('[AppsFlyer] Using legacy validateAndLogInAppPurchase API');
+    return RNAppsFlyer.validateAndLogInAppPurchase(param1, param2, param3);
+  }
 };
 
 appsFlyer.setUseReceiptValidationSandbox = (isSandbox) => {
@@ -954,6 +962,14 @@ appsFlyer.performOnDeepLinking = () => {
   return RNAppsFlyer.performOnDeepLinking();
 };
 
+/**
+ * Disable the collection of AppSet ID.
+ * This method is only relevant for Android platform.
+ */
+appsFlyer.disableAppSetId = () => {
+  return RNAppsFlyer.disableAppSetId();
+};
+
 /**
  * instruct the SDK to collect the TCF data from the device.
  * @param enabled: if the sdk should collect the TCF data. true/false

ios/RNAppsFlyer.m

@@ -565,6 +565,10 @@ - (BOOL)isExpoApp {
     [[AppsFlyerLib shared] setDisableIDFVCollection:shouldDisable];
 }
 
+RCT_EXPORT_METHOD(disableAppSetId) {
+    NSLog(@"disableAppSetId is only relevant for Android platform");
+}
+
 RCT_EXPORT_METHOD(setUseReceiptValidationSandbox: (BOOL)isSandbox) {
     [AppsFlyerLib shared].useReceiptValidationSandbox = isSandbox;
 }
@@ -600,6 +604,54 @@ - (BOOL)isExpoApp {
 
 }
 
+RCT_EXPORT_METHOD(validateAndLogInAppPurchaseV2: (NSDictionary*)purchaseDetails
+                  additionalParameters:(NSDictionary*)additionalParameters
+                  callback:(RCTResponseSenderBlock)callback) {
+    
+    if (!purchaseDetails || [purchaseDetails isKindOfClass:[NSNull class]]) {
+        if (callback) {
+            callback(@[@"Error: Purchase details are required"]);
+        }
+        return;
+    }
+    
+    NSString* purchaseType = [purchaseDetails objectForKey:@"purchaseType"];
+    NSString* productId = [purchaseDetails objectForKey:@"productId"];
+    NSString* transactionId = [purchaseDetails objectForKey:@"transactionId"];
+    
+    if (!purchaseType || !productId || !transactionId) {
+        if (callback) {
+            callback(@[@"Error: purchaseType, productId, and transactionId are required"]);
+        }
+        return;
+    }
+    
+    // Convert purchaseType string to enum
+    AFSDKPurchaseType afPurchaseType;
+    if ([purchaseType isEqualToString:@"subscription"]) {
+        afPurchaseType = AFSDKPurchaseTypeSubscription;
+    } else {
+        afPurchaseType = AFSDKPurchaseTypeOneTimePurchase;
+    }
+    
+    // Create AFSDKPurchaseDetails object
+    AFSDKPurchaseDetails* details = [[AFSDKPurchaseDetails alloc] initWithPurchaseType:afPurchaseType
+                                                                              productId:productId
+                                                                          transactionId:transactionId];
+    
+    [[AppsFlyerLib shared] validateAndLogInAppPurchase:details
+                                       extraEventValues:additionalParameters
+                                      completionHandler:^(AFSDKValidateAndLogResult * _Nullable result) {
+        if (callback) {
+            if (result && result.isValid) {
+                callback(@[@"In App Purchase Validation completed successfully!"]);
+            } else {
+                callback(@[@"Error: Purchase validation failed"]);
+            }
+        }
+    }];
+}
+
 RCT_EXPORT_METHOD(sendPushNotificationData: (NSDictionary*)pushPayload errorCallBack:(RCTResponseErrorBlock)errorCallBack) {
     [[AppsFlyerLib shared] handlePushNotification:pushPayload];
 }