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

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,34 +541,15 @@ const DeepLinkIapProvider = ({ children, }) => {
             return Promise.reject(error);
         }
     });
-    const fetchAndConditionallyOpenUrl = (affiliateIdentifier, offerCodeUrlId) => __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 offerCode = yield fetchOfferCode(affiliateIdentifier);
-            if (offerCode && offerCode.length > 0) {
-                yield openRedeemURL(offerCode, offerCodeUrlId);
-                return true;
-            }
-            else {
-                verboseLog("No valid offer code found");
-                return false;
-            }
-        }
-        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 activeCompanyCode = yield getActiveCompanyCode();
+            if (!activeCompanyCode) {
+                verboseLog('Cannot fetch offer code: no company code available');
+                return null;
+            }
             const encodedAffiliateLink = encodeURIComponent(affiliateLink);
-            const url = `https://api.insertaffiliate.com/v1/affiliateReturnOfferCode/${encodedAffiliateLink}`;
+            const url = `https://api.insertaffiliate.com/v1/affiliateReturnOfferCode/${activeCompanyCode}/${encodedAffiliateLink}`;
             verboseLog(`Fetching offer code from: ${url}`);
             const response = yield axios_1.default.get(url);
             if (response.status === 200) {
@@ -587,33 +579,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 and underscores
+        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 +623,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.2",
   "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,301 @@ 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.**
+> **Note:** Offer Codes are currently supported on **iOS only**.
 
-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).
+#### How It Works
 
-To fetch an Offer Code and conditionally redirect the user to redeem it, pass the affiliate identifier (deep link or short code) to:
+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.
 
-```javascript
-const { fetchAndConditionallyOpenUrl } = useDeepLinkIapProvider();
 
-await fetchAndConditionallyOpenUrl("your_affiliate_identifier", "your_offer_code_url_id");
+#### Basic Usage
+
+##### 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:
+
+```javascript
+const { OfferCode } = useDeepLinkIapProvider();
 ```
 
-#### Branch.io Example
+##### Setup Requirements
+
+#### 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.
+
+
+**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,10 +825,12 @@ 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
 
+When a short code is set, the SDK automatically attempts to fetch and store any associated offer codes for iOS users.
+
 ```javascript
   import {
     DeepLinkIapProvider,
@@ -670,6 +842,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,41 +653,16 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
     }
   };
 
-  const fetchAndConditionallyOpenUrl = async (
-    affiliateIdentifier: string,
-    offerCodeUrlId: string
-  ): Promise<boolean> => {
-    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 offerCode = await fetchOfferCode(affiliateIdentifier);
-      
-      if (offerCode && offerCode.length > 0) {
-        await openRedeemURL(offerCode, offerCodeUrlId);
-        return true;
-      } else {
-        verboseLog("No valid offer code found");
-        return false;
-      }
-    } 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 activeCompanyCode = await getActiveCompanyCode();
+      if (!activeCompanyCode) {
+        verboseLog('Cannot fetch offer code: no company code available');
+        return null;
+      }
 
       const encodedAffiliateLink = encodeURIComponent(affiliateLink);
-      const url = `https://api.insertaffiliate.com/v1/affiliateReturnOfferCode/${encodedAffiliateLink}`;
+      const url = `https://api.insertaffiliate.com/v1/affiliateReturnOfferCode/${activeCompanyCode}/${encodedAffiliateLink}`;
       
       verboseLog(`Fetching offer code from: ${url}`);
       
@@ -716,29 +698,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 and underscores
+    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 +737,7 @@ const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER> = ({
       value={{
         referrerLink,
         userId,
+        OfferCode,
         setShortCode,
         returnInsertAffiliateIdentifier,
         storeExpectedStoreTransaction,
@@ -755,7 +747,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,
   };
 };