insert-affiliate-react-native-sdk 1.6.1 → 1.6.3

package/dist/DeepLinkIapProvider.d.ts

@@ -8,6 +8,7 @@ type CustomPurchase = {
 type T_DEEPLINK_IAP_CONTEXT = {
     referrerLink: string;
     userId: string;
+    OfferCode: string | null;
     returnInsertAffiliateIdentifier: () => Promise<string | null>;
     validatePurchaseWithIapticAPI: (jsonIapPurchase: CustomPurchase, iapticAppId: string, iapticAppName: string, iapticPublicKey: string) => Promise<boolean>;
     returnUserAccountTokenAndStoreExpectedTransaction: () => Promise<string | null>;
@@ -16,7 +17,6 @@ type T_DEEPLINK_IAP_CONTEXT = {
     setShortCode: (shortCode: string) => Promise<void>;
     setInsertAffiliateIdentifier: (referringLink: string) => Promise<void | string>;
     initialize: (code: string | null, verboseLogging?: boolean) => Promise<void>;
-    fetchAndConditionallyOpenUrl: (affiliateIdentifier: string, offerCodeUrlId: string) => Promise<boolean>;
     isInitialized: boolean;
 };
 export declare const DeepLinkIapContext: React.Context<T_DEEPLINK_IAP_CONTEXT>;

package/dist/DeepLinkIapProvider.js

@@ -46,11 +46,13 @@ const ASYNC_KEYS = {
     USER_ID: '@app_user_id',
     COMPANY_CODE: '@app_company_code',
     USER_ACCOUNT_TOKEN: '@app_user_account_token',
+    IOS_OFFER_CODE: '@app_ios_offer_code',
 };
 // STARTING CONTEXT IMPLEMENTATION
 exports.DeepLinkIapContext = (0, react_1.createContext)({
     referrerLink: '',
     userId: '',
+    OfferCode: null,
     returnInsertAffiliateIdentifier: () => __awaiter(void 0, void 0, void 0, function* () { return ''; }),
     validatePurchaseWithIapticAPI: (jsonIapPurchase, iapticAppId, iapticAppName, iapticPublicKey) => __awaiter(void 0, void 0, void 0, function* () { return false; }),
     returnUserAccountTokenAndStoreExpectedTransaction: () => __awaiter(void 0, void 0, void 0, function* () { return ''; }),
@@ -59,7 +61,6 @@ exports.DeepLinkIapContext = (0, react_1.createContext)({
     setShortCode: (shortCode) => __awaiter(void 0, void 0, void 0, function* () { }),
     setInsertAffiliateIdentifier: (referringLink) => __awaiter(void 0, void 0, void 0, function* () { }),
     initialize: (code, verboseLogging) => __awaiter(void 0, void 0, void 0, function* () { }),
-    fetchAndConditionallyOpenUrl: (affiliateIdentifier, offerCodeUrlId) => __awaiter(void 0, void 0, void 0, function* () { return false; }),
     isInitialized: false,
 });
 const DeepLinkIapProvider = ({ children, }) => {
@@ -68,6 +69,7 @@ const DeepLinkIapProvider = ({ children, }) => {
     const [companyCode, setCompanyCode] = (0, react_1.useState)(null);
     const [isInitialized, setIsInitialized] = (0, react_1.useState)(false);
     const [verboseLogging, setVerboseLogging] = (0, react_1.useState)(false);
+    const [OfferCode, setOfferCode] = (0, react_1.useState)(null);
     // MARK: Initialize the SDK
     const initialize = (companyCode_1, ...args_1) => __awaiter(void 0, [companyCode_1, ...args_1], void 0, function* (companyCode, verboseLogging = false) {
         setVerboseLogging(verboseLogging);
@@ -107,9 +109,11 @@ const DeepLinkIapProvider = ({ children, }) => {
                 const uId = yield getValueFromAsync(ASYNC_KEYS.USER_ID);
                 const refLink = yield getValueFromAsync(ASYNC_KEYS.REFERRER_LINK);
                 const companyCodeFromStorage = yield getValueFromAsync(ASYNC_KEYS.COMPANY_CODE);
+                const storedOfferCode = yield getValueFromAsync(ASYNC_KEYS.IOS_OFFER_CODE);
                 verboseLog(`User ID found: ${uId ? 'Yes' : 'No'}`);
                 verboseLog(`Referrer link found: ${refLink ? 'Yes' : 'No'}`);
                 verboseLog(`Company code found: ${companyCodeFromStorage ? 'Yes' : 'No'}`);
+                verboseLog(`iOS Offer Code found: ${storedOfferCode ? 'Yes' : 'No'}`);
                 if (uId && refLink) {
                     setUserId(uId);
                     setReferrerLink(refLink);
@@ -119,6 +123,10 @@ const DeepLinkIapProvider = ({ children, }) => {
                     setCompanyCode(companyCodeFromStorage);
                     verboseLog('Company code restored from storage');
                 }
+                if (storedOfferCode) {
+                    setOfferCode(storedOfferCode);
+                    verboseLog('iOS Offer Code restored from storage');
+                }
             }
             catch (error) {
                 errorLog(`ERROR ~ fetchAsyncEssentials: ${error}`);
@@ -209,9 +217,9 @@ const DeepLinkIapProvider = ({ children, }) => {
     };
     // MARK: Short Codes
     const isShortCode = (referringLink) => {
-        // Short codes are less than 10 characters
-        const isValidCharacters = /^[a-zA-Z0-9]+$/.test(referringLink);
-        return isValidCharacters && referringLink.length < 25 && referringLink.length > 3;
+        // Short codes are 3-25 characters and can include underscores
+        const isValidCharacters = /^[a-zA-Z0-9_]+$/.test(referringLink);
+        return isValidCharacters && referringLink.length >= 3 && referringLink.length <= 25;
     };
     function setShortCode(shortCode) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -376,6 +384,9 @@ const DeepLinkIapProvider = ({ children, }) => {
             verboseLog(`Saving referrer link to AsyncStorage...`);
             yield saveValueInAsync(ASYNC_KEYS.REFERRER_LINK, link);
             verboseLog(`Referrer link saved to AsyncStorage successfully`);
+            // Automatically fetch and store offer code for any affiliate identifier
+            verboseLog('Attempting to fetch offer code for stored affiliate identifier...');
+            yield retrieveAndStoreOfferCode(link);
         });
     }
     const validatePurchaseWithIapticAPI = (jsonIapPurchase, iapticAppId, iapticAppName, iapticPublicKey) => __awaiter(void 0, void 0, void 0, function* () {
@@ -530,35 +541,25 @@ const DeepLinkIapProvider = ({ children, }) => {
             return Promise.reject(error);
         }
     });
-    const fetchAndConditionallyOpenUrl = (affiliateIdentifier, offerCodeUrlId) => __awaiter(void 0, void 0, void 0, function* () {
+    const fetchOfferCode = (affiliateLink) => __awaiter(void 0, void 0, void 0, function* () {
         try {
-            verboseLog(`Attempting to fetch and conditionally open URL for affiliate: ${affiliateIdentifier}, offerCodeUrlId: ${offerCodeUrlId}`);
-            if (react_native_1.Platform.OS !== 'ios') {
-                console.warn("[Insert Affiliate] Offer codes are only supported on iOS");
-                verboseLog("Offer codes are only supported on iOS");
-                return false;
+            const activeCompanyCode = yield getActiveCompanyCode();
+            if (!activeCompanyCode) {
+                verboseLog('Cannot fetch offer code: no company code available');
+                return null;
             }
-            const offerCode = yield fetchOfferCode(affiliateIdentifier);
-            if (offerCode && offerCode.length > 0) {
-                yield openRedeemURL(offerCode, offerCodeUrlId);
-                return true;
+            let platformType = 'ios';
+            // Check if its iOs or Android here
+            if (react_native_1.Platform.OS !== 'ios') {
+                verboseLog('Platform is not iOS, setting platform type to android');
+                platformType = 'android';
             }
             else {
-                verboseLog("No valid offer code found");
-                return false;
+                verboseLog('Platform is iOS, setting platform type to ios');
             }
-        }
-        catch (error) {
-            console.error('[Insert Affiliate] Error fetching and opening offer code URL:', error);
-            verboseLog(`Error fetching and opening offer code URL: ${error}`);
-            return false;
-        }
-    });
-    const fetchOfferCode = (affiliateLink) => __awaiter(void 0, void 0, void 0, function* () {
-        try {
             const encodedAffiliateLink = encodeURIComponent(affiliateLink);
-            const url = `https://api.insertaffiliate.com/v1/affiliateReturnOfferCode/${encodedAffiliateLink}`;
-            verboseLog(`Fetching offer code from: ${url}`);
+            const url = `https://api.insertaffiliate.com/v1/affiliateReturnOfferCode/${activeCompanyCode}/${encodedAffiliateLink}?platformType=${platformType}`;
+            verboseLog(`Starting to fetch offer code from: ${url}`);
             const response = yield axios_1.default.get(url);
             if (response.status === 200) {
                 const offerCode = response.data;
@@ -587,33 +588,41 @@ const DeepLinkIapProvider = ({ children, }) => {
             return null;
         }
     });
-    const openRedeemURL = (offerCode, offerCodeUrlId) => __awaiter(void 0, void 0, void 0, function* () {
+    const retrieveAndStoreOfferCode = (affiliateLink) => __awaiter(void 0, void 0, void 0, function* () {
         try {
-            const redeemUrl = `https://apps.apple.com/redeem?ctx=offercodes&id=${offerCodeUrlId}&code=${offerCode}`;
-            verboseLog(`Opening redeem URL: ${redeemUrl}`);
-            const canOpen = yield react_native_1.Linking.canOpenURL(redeemUrl);
-            if (canOpen) {
-                yield react_native_1.Linking.openURL(redeemUrl);
-                console.log('[Insert Affiliate] Successfully opened redeem URL');
-                verboseLog('Successfully opened redeem URL');
+            verboseLog(`Attempting to retrieve and store offer code for: ${affiliateLink}`);
+            const offerCode = yield fetchOfferCode(affiliateLink);
+            if (offerCode && offerCode.length > 0) {
+                // Store in both AsyncStorage and state
+                yield saveValueInAsync(ASYNC_KEYS.IOS_OFFER_CODE, offerCode);
+                setOfferCode(offerCode);
+                verboseLog(`Successfully stored offer code: ${offerCode}`);
+                console.log('[Insert Affiliate] Offer code retrieved and stored successfully');
             }
             else {
-                console.error(`[Insert Affiliate] Could not launch redeem URL: ${redeemUrl}`);
-                verboseLog(`Could not launch redeem URL: ${redeemUrl}`);
+                verboseLog('No valid offer code found to store');
+                // Clear stored offer code if none found
+                yield saveValueInAsync(ASYNC_KEYS.IOS_OFFER_CODE, '');
+                setOfferCode(null);
             }
         }
         catch (error) {
-            console.error('[Insert Affiliate] Error opening redeem URL:', error);
-            verboseLog(`Error opening redeem URL: ${error}`);
+            console.error('[Insert Affiliate] Error retrieving and storing offer code:', error);
+            verboseLog(`Error in retrieveAndStoreOfferCode: ${error}`);
         }
     });
+    const removeSpecialCharacters = (offerCode) => {
+        // Remove special characters, keep only alphanumeric, underscores, and hyphens
+        return offerCode.replace(/[^a-zA-Z0-9_-]/g, '');
+    };
     const cleanOfferCode = (offerCode) => {
         // Remove special characters, keep only alphanumeric
-        return offerCode.replace(/[^a-zA-Z0-9]/g, '');
+        return removeSpecialCharacters(offerCode);
     };
     return (react_1.default.createElement(exports.DeepLinkIapContext.Provider, { value: {
             referrerLink,
             userId,
+            OfferCode,
             setShortCode,
             returnInsertAffiliateIdentifier,
             storeExpectedStoreTransaction,
@@ -623,7 +632,6 @@ const DeepLinkIapProvider = ({ children, }) => {
             setInsertAffiliateIdentifier,
             initialize,
             isInitialized,
-            fetchAndConditionallyOpenUrl,
         } }, children));
 };
 exports.default = DeepLinkIapProvider;

package/dist/useDeepLinkIapProvider.d.ts

@@ -12,6 +12,6 @@ declare const useDeepLinkIapProvider: () => {
     setInsertAffiliateIdentifier: (referringLink: string) => Promise<void | string>;
     initialize: (code: string | null, verboseLogging?: boolean) => Promise<void>;
     isInitialized: boolean;
-    fetchAndConditionallyOpenUrl: (affiliateIdentifier: string, offerCodeUrlId: string) => Promise<boolean>;
+    OfferCode: string | null;
 };
 export default useDeepLinkIapProvider;

package/dist/useDeepLinkIapProvider.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const react_1 = require("react");
 const DeepLinkIapProvider_1 = require("./DeepLinkIapProvider");
 const useDeepLinkIapProvider = () => {
-    const { referrerLink, userId, validatePurchaseWithIapticAPI, storeExpectedStoreTransaction, returnUserAccountTokenAndStoreExpectedTransaction, returnInsertAffiliateIdentifier, trackEvent, setShortCode, setInsertAffiliateIdentifier, initialize, isInitialized, fetchAndConditionallyOpenUrl } = (0, react_1.useContext)(DeepLinkIapProvider_1.DeepLinkIapContext);
+    const { referrerLink, userId, validatePurchaseWithIapticAPI, storeExpectedStoreTransaction, returnUserAccountTokenAndStoreExpectedTransaction, returnInsertAffiliateIdentifier, trackEvent, setShortCode, setInsertAffiliateIdentifier, initialize, isInitialized, OfferCode, } = (0, react_1.useContext)(DeepLinkIapProvider_1.DeepLinkIapContext);
     return {
         referrerLink,
         userId,
@@ -16,7 +16,7 @@ const useDeepLinkIapProvider = () => {
         setInsertAffiliateIdentifier,
         initialize,
         isInitialized,
-        fetchAndConditionallyOpenUrl
+        OfferCode,
     };
 };
 exports.default = useDeepLinkIapProvider;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "insert-affiliate-react-native-sdk",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "A package for connecting with the Insert Affiliate Platform to add app based affiliate marketing.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/readme.md

@@ -252,7 +252,7 @@ const Child = () => {
             <Button
                 disabled={iapLoading}
                 title={`Click to Buy Subscription`}
-                onPress={() => handleBuySubscription("oneMonthSubscriptionTwo")}
+                onPress={() => handleBuySubscription("oneMonthSubscription")}
             />
             {iapLoading && <ActivityIndicator size={"small"} color={"black"} />}
         </View>
@@ -520,131 +520,327 @@ const {
 />
 ```
 
-### 2. Offer Codes
+### 2. Discounts for Users → Offer Codes / Dynamic Product IDs
 
-Offer Codes allow you to automatically present a discount to users who access an affiliate's link or enter a short code. This provides affiliates with a compelling incentive to promote your app, as discounts are automatically applied during the redemption flow [(learn more)](https://docs.insertaffiliate.com/offer-codes). 
+The SDK allows you to apply dynamic modifiers to in-app purchases based on whether the app was installed via an affiliate. These modifiers can be used to swap the default product ID for a discounted or trial-based one - similar to applying an offer code.
 
-**Note: Offer Codes are currently only supported on iOS.**
+#### How It Works
 
-You'll need your Offer Code URL ID, which can be created and retrieved from App Store Connect. Instructions to retrieve your Offer Code URL ID are available [here](https://docs.insertaffiliate.com/offer-codes#create-the-codes-within-app-store-connect).
+When a user clicks an affiliate link or enters a short code linked to an offer (set up in the **Insert Affiliate Dashboard**), the SDK auto-populates the `OfferCode` field with a relevant modifier (e.g., `_oneWeekFree`). You can append this to your base product ID to dynamically display the correct subscription.
 
-To fetch an Offer Code and conditionally redirect the user to redeem it, pass the affiliate identifier (deep link or short code) to:
+#### Basic Usage
 
-```javascript
-const { fetchAndConditionallyOpenUrl } = useDeepLinkIapProvider();
+##### 1. Automatic Offer Code Fetching
+If an affiliate short code is stored, the SDK automatically fetches and saves the associated offer code modifier.
+
+##### 2. Access the Offer Code Modifier
+The offer code modifier is available through the context:
 
-await fetchAndConditionallyOpenUrl("your_affiliate_identifier", "your_offer_code_url_id");
+```javascript
+const { OfferCode } = useDeepLinkIapProvider();
 ```
 
-#### Branch.io Example
+##### Setup Requirements
+
+#### Insert Affiliate Setup Instructions
+
+1. Go to your Insert Affiliate dashboard at [app.insertaffiliate.com/affiliates](https://app.insertaffiliate.com/affiliates)
+2. Select the affiliate you want to configure
+3. Click "View" to access the affiliate's settings
+4. Assign an iOS IAP Modifier to the affiliate (e.g., `_oneWeekFree`, `_threeMonthsFree`)
+5. Assign an Android IAP Modifier to the affiliate (e.g., `-oneweekfree`, `-threemonthsfree`)
+5. Save the settings
+
+Once configured, when users click that affiliate's links or enter their short codes, your app will automatically receive the modifier and can load the appropriate discounted product.
+
+#### App Store Connect Configuration
+1. Create both a base and a promotional product:
+   - Base product: `oneMonthSubscription`
+   - Promo product: `oneMonthSubscription_oneWeekFree`
+2. Ensure **both** products are approved and available for sale.
+
+#### Google Play Console Configuration
+There are multiple ways you can configure your products in Google Play Console:
+
+1. **Multiple Products Approach**: Create both a base and a promotional product:
+   - Base product: `oneMonthSubscription`
+   - Promo product: `oneMonthSubscription-oneweekfree`
+
+2. **Single Product with Multiple Base Plans**: Create one product with multiple base plans, one with an offer attached
+
+3. **Developer Triggered Offers**: Have one base product and apply the offer through developer-triggered offers
 
+4. **Base Product with Intro Offers**: Have one base product that includes an introductory offer
+
+Any of these approaches are suitable and work with the SDK. The important part is that your product naming follows the pattern where the offer code modifier can be appended to identify the promotional version.
+
+**If using the Multiple Products Approach:**
+- Ensure **both** products are activated and available for purchase.
+- Generate a release to at least **Internal Testing** to make the products available in your current app build
+
+**Product Naming Pattern:**
+- Follow the pattern: `{baseProductId}{OfferCode}`
+- Example: `oneMonthSubscription` + `_oneWeekFree` = `oneMonthSubscription_oneWeekFree`
+
+---
+
+#### RevenueCat Dashboard Configuration
+
+#### RevenueCat Dashboard Configuration:
+1. Create separate offerings:
+   - Base offering: `premium_monthly`
+   - Modified offering: `premium_monthly_oneWeekFree`
+
+2. Add both product IDs under different offerings in RevenueCat.
+
+3. Ensure modified products follow this naming pattern: {baseProductId}_{cleanOfferCode}. e.g. premium_monthly_oneWeekFree
+
+
+### Integration Example
 ```javascript
-import React, { useEffect } from 'react';
-import branch from 'react-native-branch';
+import React, { useEffect, useState } from 'react';
+import { View, Button, Text } from 'react-native';
 import { useDeepLinkIapProvider } from 'insert-affiliate-react-native-sdk';
+import Purchases from 'react-native-purchases';
 
-const DeepLinkHandler = () => {
-  const { fetchAndConditionallyOpenUrl } = useDeepLinkIapProvider();
-  
-  useEffect(() => {
-    const branchSubscription = branch.subscribe(async ({ error, params }) => {
-      if (error) {
-        console.error('Error from Branch:', error);
-        return;
-      }
+const PurchaseHandler = () => {
+  const { OfferCode } = useDeepLinkIapProvider();
+  const [subscriptions, setSubscriptions] = useState([]);
 
-      if (params['+clicked_branch_link']) {
-        const referringLink = params['~referring_link'];
-        if (referringLink) {
-          try {
-            await fetchAndConditionallyOpenUrl(
-              referringLink,
-              "{{ your_offer_code_url_id }}"
-            );
+  const fetchSubscriptions = async () => {
+    const offerings = await Purchases.getOfferings();
+    let packagesToUse = [];
 
-            // Other code required for Insert Affiliate in the other listed steps...
-          } catch (err) {
-            console.error('Error with offer code:', err);
+    if (OfferCode) {
+    
+
+      // Construct modified product IDs from base products
+      const baseProducts = offerings.current.availablePackages;
+
+      for (const basePackage of baseProducts) {
+        const baseProductId = basePackage.product.identifier;
+        const modifiedProductId = `${baseProductId}_${OfferCode}`;
+
+        // Search all offerings for the modified product
+        const allOfferings = Object.values(offerings.all);
+        let foundModified = false;
+
+        for (const offering of allOfferings) {
+          const modifiedPackage = offering.availablePackages.find(pkg =>
+            pkg.product.identifier === modifiedProductId
+          );
+
+          if (modifiedPackage) {
+            packagesToUse.push(modifiedPackage);
+            foundModified = true;
+            break;
           }
         }
+
+        // Fallback to base product if no modified version
+        if (!foundModified) {
+          packagesToUse.push(basePackage);
+        }
       }
-    });
+    } else {
+      packagesToUse = offerings.current.availablePackages;
+    }
 
-    return () => branchSubscription();
-  }, [fetchAndConditionallyOpenUrl]);
+    setSubscriptions(packagesToUse);
+  };
 
-  return <App />;
+  const handlePurchase = async (subscriptionPackage) => {
+    try {
+      await Purchases.purchasePackage(subscriptionPackage);
+    } catch (error) {
+      console.error('Purchase failed:', error);
+    }
+  };
+
+  useEffect(() => {
+    fetchSubscriptions();
+  }, [OfferCode]);
+
+  return (
+    <View>
+      {subscriptions.map((pkg) => (
+        <Button
+          key={pkg.identifier}
+          title={`Buy: ${pkg.product.identifier}`}
+          onPress={() => handlePurchase(pkg)}
+        />
+      ))}
+      {OfferCode && (
+        <Text>Special offer applied: {OfferCode}</Text>
+      )}
+    </View>
+  );
 };
 ```
+---
 
-#### Short Code Example
+#### Native Receipt Verification Example
+
+For apps using `react-native-iap` directly:
 
 ```javascript
-import React, { useState } from 'react';
-import { View, TextInput, Button, StyleSheet } from 'react-native';
+import React, { useState, useEffect } from 'react';
+import { View, Text, Button, Platform } from 'react-native';
 import { useDeepLinkIapProvider } from 'insert-affiliate-react-native-sdk';
+import { 
+  initConnection, 
+  getSubscriptions, 
+  requestSubscription,
+  useIAP 
+} from 'react-native-iap';
+
+const NativeIAPPurchaseView = () => {
+  const { OfferCode, returnUserAccountTokenAndStoreExpectedTransaction } = useDeepLinkIapProvider();
+  const [availableProducts, setAvailableProducts] = useState([]);
+  const [loading, setLoading] = useState(false);
+  const { currentPurchase, connected } = useIAP();
+  
+  const baseProductIdentifier = "oneMonthSubscription";
+  
+  // Dynamic product identifier that includes offer code
+  const dynamicProductIdentifier = OfferCode 
+    ? `${baseProductIdentifier}${OfferCode}`  // e.g., "oneMonthSubscription_oneWeekFree"
+    : baseProductIdentifier;
 
-const ShortCodeInputWidget = () => {
-  const [shortCode, setShortCode] = useState('');
-  const { setShortCode: setInsertAffiliateShortCode, fetchAndConditionallyOpenUrl } = useDeepLinkIapProvider();
-
-  const handleShortCodeSubmission = async () => {
-    const trimmedCode = shortCode.trim();
-    
-    if (trimmedCode.length > 0) {
-      try {
-        // Set the short code for affiliate tracking
-        await setInsertAffiliateShortCode(trimmedCode);
-        
-        // Fetch and conditionally open offer code URL
-        await fetchAndConditionallyOpenUrl(
-          trimmedCode, 
-          "{{ your_offer_code_url_id }}"
+  const fetchProducts = async () => {
+    try {
+      setLoading(true);
+      
+      // Try to fetch the dynamic product first
+      let productIds = [dynamicProductIdentifier];
+      
+      // Also include base product as fallback
+      if (OfferCode) {
+        productIds.push(baseProductIdentifier);
+      }
+      
+      const products = await getSubscriptions({ skus: productIds });
+      
+      // Prioritize the dynamic product if it exists
+      let sortedProducts = products;
+      if (OfferCode && products.length > 1) {
+        sortedProducts = products.sort((a, b) => 
+          a.productId === dynamicProductIdentifier ? -1 : 1
         );
-      } catch (error) {
-        console.error('Error handling short code:', error);
       }
+      
+      setAvailableProducts(sortedProducts);
+      console.log(`Loaded products for: ${productIds.join(', ')}`);
+      
+    } catch (error) {
+      try {
+        // Fallback logic
+        const baseProducts = await getSubscriptions({ skus: [baseProductIdentifier] });
+        setAvailableProducts(baseProducts);
+      } catch (fallbackError) {
+        console.error('Failed to fetch base products:', fallbackError);
+      }
+    } finally {
+      setLoading(false);
     }
   };
 
+  const handlePurchase = async (productId) => {
+    // Implement the purchase handling logic as outlined in the remaining SDK integration steps.
+  };
+
+  useEffect(() => {
+    if (connected) {
+      fetchProducts();
+    }
+  }, [connected, OfferCode]);;
+
+  const primaryProduct = availableProducts[0];
+
   return (
-    <View style={styles.container}>
-      <TextInput
-        style={styles.input}
-        value={shortCode}
-        onChangeText={setShortCode}
-        placeholder="Enter your code"
-        placeholderTextColor="#ABC123"
-      />
-      <Button
-        title="Apply Code"
-        onPress={handleShortCodeSubmission}
-      />
+    <View style={{ padding: 20 }}>
+      <Text style={{ fontSize: 18, fontWeight: 'bold', marginBottom: 10 }}>
+        Premium Subscription
+      </Text>
+      
+      {OfferCode && (
+        <View style={{ backgroundColor: '#e3f2fd', padding: 10, marginBottom: 15, borderRadius: 8 }}>
+          <Text style={{ color: '#1976d2', fontWeight: 'bold' }}>
+            🎉 Special Offer Applied: {OfferCode}
+          </Text>
+        </View>
+      )}
+      
+      {loading ? (
+        <Text>Loading products...</Text>
+      ) : primaryProduct ? (
+        <View>
+          <Text style={{ fontSize: 16, marginBottom: 5 }}>
+            {primaryProduct.title}
+          </Text>
+          <Text style={{ fontSize: 14, color: '#666', marginBottom: 5 }}>
+            Price: {primaryProduct.localizedPrice}
+          </Text>
+          <Text style={{ fontSize: 12, color: '#999', marginBottom: 15 }}>
+            Product ID: {primaryProduct.productId}
+          </Text>
+          
+          <Button
+            title={loading ? "Processing..." : "Subscribe Now"}
+            onPress={() => handlePurchase(primaryProduct.productId)}
+            disabled={loading}
+          />
+          
+          {primaryProduct.productId === dynamicProductIdentifier && OfferCode && (
+            <Text style={{ fontSize: 12, color: '#4caf50', marginTop: 10 }}>
+              ✓ Promotional pricing applied
+            </Text>
+          )}
+        </View>
+      ) : (
+        <View>
+          <Text style={{ color: '#f44336', marginBottom: 10 }}>
+            Product not found: {dynamicProductIdentifier}
+          </Text>
+          <Button
+            title="Retry"
+            onPress={fetchProducts}
+          />
+        </View>
+      )}
+      
+      {availableProducts.length > 1 && (
+        <View style={{ marginTop: 20 }}>
+          <Text style={{ fontSize: 14, fontWeight: 'bold', marginBottom: 10 }}>
+            Other Options:
+          </Text>
+          {availableProducts.slice(1).map((product) => (
+            <Button
+              key={product.productId}
+              title={`${product.title} - ${product.localizedPrice}`}
+              onPress={() => handlePurchase(product.productId)}
+            />
+          ))}
+        </View>
+      )}
     </View>
   );
 };
-
-const styles = StyleSheet.create({
-  container: {
-    padding: 20,
-  },
-  input: {
-    borderWidth: 1,
-    borderColor: '#ddd',
-    padding: 10,
-    marginBottom: 10,
-    borderRadius: 5,
-  },
-});
-
-export default ShortCodeInputWidget;
 ```
 
+##### Key Features of Native IAP Integration:
+
+1. **Dynamic Product Loading**: Automatically constructs product IDs using the offer code modifier
+2. **Fallback Strategy**: If the promotional product isn't found, falls back to the base product
+3. **Visual Feedback**: Shows users when promotional pricing is applied
+4. **Error Handling**: Graceful handling when products aren't available
+
+
 ### 3. Short Codes (Beta)
 
 #### What are Short Codes?
 
-Short codes are unique, 10-character alphanumeric identifiers that affiliates can use to promote products or subscriptions. These codes are ideal for influencers or partners, making them easier to share than long URLs.
+Short codes are unique identifiers that affiliates can use to promote products or subscriptions. These codes are ideal for influencers or partners, making them easier to share than long URLs.
 
 **Example Use Case**: An influencer promotes a subscription with the short code "JOIN12345" within their TikTok video's description. When users enter this code within your app during sign-up or before purchase, the app tracks the subscription back to the influencer for commission payouts.
 
@@ -655,8 +851,8 @@ For more information, visit the [Insert Affiliate Short Codes Documentation](htt
 Use the `setShortCode` method to associate a short code with an affiliate. This is ideal for scenarios where users enter the code via an input field, pop-up, or similar UI element.
 
 Short codes must meet the following criteria:
-- Exactly **10 characters long**.
-- Contain only **letters and numbers** (alphanumeric characters).
+- Between **3-25 characters long**.
+- Contain only **letters, numbers, and underscores** (alphanumeric characters and underscores).
 - Replace {{ user_entered_short_code }} with the short code the user enters through your chosen input method, i.e. an input field / pop up element
 
 ```javascript
@@ -670,6 +866,6 @@ Short codes must meet the following criteria:
 
   <Button
     title={'Set Short Code'}
-    onPress={() => setShortCode('JOIN123456')}
+    onPress={() => setShortCode('JOIN_123')}
   />
 ```

package/src/DeepLinkIapProvider.tsx

@@ -15,6 +15,7 @@ type CustomPurchase = {
 type T_DEEPLINK_IAP_CONTEXT = {
   referrerLink: string;
   userId: string;
+  OfferCode: string | null;
   returnInsertAffiliateIdentifier: () => Promise<string | null>;
   validatePurchaseWithIapticAPI: (
     jsonIapPurchase: CustomPurchase,
@@ -32,10 +33,6 @@ type T_DEEPLINK_IAP_CONTEXT = {
     referringLink: string
   ) => Promise<void | string>;
   initialize: (code: string | null, verboseLogging?: boolean) => Promise<void>;
-  fetchAndConditionallyOpenUrl: (
-    affiliateIdentifier: string,
-    offerCodeUrlId: string
-  ) => Promise<boolean>;
   isInitialized: boolean;
 };
 
@@ -61,12 +58,14 @@ const ASYNC_KEYS = {
   USER_ID: '@app_user_id',
   COMPANY_CODE: '@app_company_code',
   USER_ACCOUNT_TOKEN: '@app_user_account_token',
+  IOS_OFFER_CODE: '@app_ios_offer_code',
 };
 
 // STARTING CONTEXT IMPLEMENTATION
 export const DeepLinkIapContext = createContext<T_DEEPLINK_IAP_CONTEXT>({
   referrerLink: '',
   userId: '',
+  OfferCode: null,
   returnInsertAffiliateIdentifier: async () => '',
   validatePurchaseWithIapticAPI: async (
     jsonIapPurchase: CustomPurchase,
@@ -80,10 +79,6 @@ export const DeepLinkIapContext = createContext<T_DEEPLINK_IAP_CONTEXT>({
   setShortCode: async (shortCode: string) => {},
   setInsertAffiliateIdentifier: async (referringLink: string) => {},
   initialize: async (code: string | null, verboseLogging?: boolean) => {},
-  fetchAndConditionallyOpenUrl: async (
-    affiliateIdentifier: string,
-    offerCodeUrlId: string
-  ) => false,
   isInitialized: false,
 });
 
@@ -95,6 +90,7 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
   const [companyCode, setCompanyCode] = useState<string | null>(null);
   const [isInitialized, setIsInitialized] = useState<boolean>(false);
   const [verboseLogging, setVerboseLogging] = useState<boolean>(false);
+  const [OfferCode, setOfferCode] = useState<string | null>(null);
 
   // MARK: Initialize the SDK
   const initialize = async (companyCode: string | null, verboseLogging: boolean = false): Promise<void> => {
@@ -142,10 +138,12 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
         const uId = await getValueFromAsync(ASYNC_KEYS.USER_ID);
         const refLink = await getValueFromAsync(ASYNC_KEYS.REFERRER_LINK);
         const companyCodeFromStorage = await getValueFromAsync(ASYNC_KEYS.COMPANY_CODE);
+        const storedOfferCode = await getValueFromAsync(ASYNC_KEYS.IOS_OFFER_CODE);
 
         verboseLog(`User ID found: ${uId ? 'Yes' : 'No'}`);
         verboseLog(`Referrer link found: ${refLink ? 'Yes' : 'No'}`);
         verboseLog(`Company code found: ${companyCodeFromStorage ? 'Yes' : 'No'}`);
+        verboseLog(`iOS Offer Code found: ${storedOfferCode ? 'Yes' : 'No'}`);
 
         if (uId && refLink) {
           setUserId(uId);
@@ -157,6 +155,11 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
           setCompanyCode(companyCodeFromStorage);
           verboseLog('Company code restored from storage');
         }
+
+        if (storedOfferCode) {
+          setOfferCode(storedOfferCode);
+          verboseLog('iOS Offer Code restored from storage');
+        }
       } catch (error) {
         errorLog(`ERROR ~ fetchAsyncEssentials: ${error}`);
         verboseLog(`Error loading from AsyncStorage: ${error}`);
@@ -259,9 +262,9 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
 
   // MARK: Short Codes
   const isShortCode = (referringLink: string): boolean => {
-    // Short codes are less than 10 characters
-    const isValidCharacters = /^[a-zA-Z0-9]+$/.test(referringLink);
-    return isValidCharacters && referringLink.length < 25 && referringLink.length > 3;
+    // Short codes are 3-25 characters and can include underscores
+    const isValidCharacters = /^[a-zA-Z0-9_]+$/.test(referringLink);
+    return isValidCharacters && referringLink.length >= 3 && referringLink.length <= 25;
   };
 
   async function setShortCode(shortCode: string): Promise<void> {
@@ -449,6 +452,10 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
     verboseLog(`Saving referrer link to AsyncStorage...`);
     await saveValueInAsync(ASYNC_KEYS.REFERRER_LINK, link);
     verboseLog(`Referrer link saved to AsyncStorage successfully`);
+    
+    // Automatically fetch and store offer code for any affiliate identifier
+    verboseLog('Attempting to fetch offer code for stored affiliate identifier...');
+    await retrieveAndStoreOfferCode(link);
   }
 
   const validatePurchaseWithIapticAPI = async (
@@ -646,43 +653,27 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
     }
   };
 
-  const fetchAndConditionallyOpenUrl = async (
-    affiliateIdentifier: string,
-    offerCodeUrlId: string
-  ): Promise<boolean> => {
+  const fetchOfferCode = async (affiliateLink: string): Promise<string | null> => {
     try {
-      verboseLog(`Attempting to fetch and conditionally open URL for affiliate: ${affiliateIdentifier}, offerCodeUrlId: ${offerCodeUrlId}`);
-
-      if (Platform.OS !== 'ios') {
-        console.warn("[Insert Affiliate] Offer codes are only supported on iOS");
-        verboseLog("Offer codes are only supported on iOS");
-        return false;
+      const activeCompanyCode = await getActiveCompanyCode();
+      if (!activeCompanyCode) {
+        verboseLog('Cannot fetch offer code: no company code available');
+        return null;
       }
 
-      const offerCode = await fetchOfferCode(affiliateIdentifier);
-      
-      if (offerCode && offerCode.length > 0) {
-        await openRedeemURL(offerCode, offerCodeUrlId);
-        return true;
+      let platformType = 'ios'
+      // Check if its iOs or Android here
+      if (Platform.OS !== 'ios') {
+        verboseLog('Platform is not iOS, setting platform type to android');
+        platformType = 'android'
       } else {
-        verboseLog("No valid offer code found");
-        return false;
+        verboseLog('Platform is iOS, setting platform type to ios');
       }
-    } catch (error) {
-      console.error('[Insert Affiliate] Error fetching and opening offer code URL:', error);
-      verboseLog(`Error fetching and opening offer code URL: ${error}`);
-      return false;
-    }
-  };
-
-  const fetchOfferCode = async (affiliateLink: string): Promise<string | null> => {
-    try {
-
 
       const encodedAffiliateLink = encodeURIComponent(affiliateLink);
-      const url = `https://api.insertaffiliate.com/v1/affiliateReturnOfferCode/${encodedAffiliateLink}`;
+      const url = `https://api.insertaffiliate.com/v1/affiliateReturnOfferCode/${activeCompanyCode}/${encodedAffiliateLink}?platformType=${platformType}`;
       
-      verboseLog(`Fetching offer code from: ${url}`);
+      verboseLog(`Starting to fetch offer code from: ${url}`);
       
       const response = await axios.get(url);
       
@@ -716,29 +707,38 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
     }
   };
 
-  const openRedeemURL = async (offerCode: string, offerCodeUrlId: string): Promise<void> => {
+  const retrieveAndStoreOfferCode = async (affiliateLink: string): Promise<void> => {
     try {
-      const redeemUrl = `https://apps.apple.com/redeem?ctx=offercodes&id=${offerCodeUrlId}&code=${offerCode}`;
-      verboseLog(`Opening redeem URL: ${redeemUrl}`);
+      verboseLog(`Attempting to retrieve and store offer code for: ${affiliateLink}`);
+      
+      const offerCode = await fetchOfferCode(affiliateLink);
       
-      const canOpen = await Linking.canOpenURL(redeemUrl);
-      if (canOpen) {
-        await Linking.openURL(redeemUrl);
-        console.log('[Insert Affiliate] Successfully opened redeem URL');
-        verboseLog('Successfully opened redeem URL');
+      if (offerCode && offerCode.length > 0) {
+        // Store in both AsyncStorage and state
+        await saveValueInAsync(ASYNC_KEYS.IOS_OFFER_CODE, offerCode);
+        setOfferCode(offerCode);
+        verboseLog(`Successfully stored offer code: ${offerCode}`);
+        console.log('[Insert Affiliate] Offer code retrieved and stored successfully');
       } else {
-        console.error(`[Insert Affiliate] Could not launch redeem URL: ${redeemUrl}`);
-        verboseLog(`Could not launch redeem URL: ${redeemUrl}`);
+        verboseLog('No valid offer code found to store');
+        // Clear stored offer code if none found
+        await saveValueInAsync(ASYNC_KEYS.IOS_OFFER_CODE, '');
+        setOfferCode(null);
       }
     } catch (error) {
-      console.error('[Insert Affiliate] Error opening redeem URL:', error);
-      verboseLog(`Error opening redeem URL: ${error}`);
+      console.error('[Insert Affiliate] Error retrieving and storing offer code:', error);
+      verboseLog(`Error in retrieveAndStoreOfferCode: ${error}`);
     }
   };
 
+  const removeSpecialCharacters = (offerCode: string): string => {
+    // Remove special characters, keep only alphanumeric, underscores, and hyphens
+    return offerCode.replace(/[^a-zA-Z0-9_-]/g, '');
+  };
+
   const cleanOfferCode = (offerCode: string): string => {
     // Remove special characters, keep only alphanumeric
-    return offerCode.replace(/[^a-zA-Z0-9]/g, '');
+    return removeSpecialCharacters(offerCode);
   };
 
   return (
@@ -746,6 +746,7 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
       value={{
         referrerLink,
         userId,
+        OfferCode,
         setShortCode,
         returnInsertAffiliateIdentifier,
         storeExpectedStoreTransaction,
@@ -755,7 +756,6 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
         setInsertAffiliateIdentifier,
         initialize,
         isInitialized,
-        fetchAndConditionallyOpenUrl,
       }}
     >
       {children}

package/src/useDeepLinkIapProvider.tsx

@@ -14,7 +14,7 @@ const useDeepLinkIapProvider = () => {
     setInsertAffiliateIdentifier,
     initialize,
     isInitialized,
-    fetchAndConditionallyOpenUrl
+    OfferCode,
   } = useContext(DeepLinkIapContext);
 
   return {
@@ -29,7 +29,7 @@ const useDeepLinkIapProvider = () => {
     setInsertAffiliateIdentifier,
     initialize,
     isInitialized,
-    fetchAndConditionallyOpenUrl
+    OfferCode,
   };
 };