Redemption Links Deep Dive

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "TEAMID123.com.yourcompany.yourapp",
        "paths": ["/*"]
      }
    ]
  },
  "webcredentials": {
    "apps": ["TEAMID123.com.yourcompany.yourapp"]
  }
}

[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.yourcompany.yourapp",
      "sha256_cert_fingerprints": [
        "AA:BB:CC:DD:EE:FF:..."
      ]
    }
  }
]

import RevenueCat

// Case 1: App is open (background or foreground) when link is tapped
func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
    guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
          let url = userActivity.webpageURL else { return }
    Task { await redeemIfNeeded(url) }
}

// Case 2: Cold start - app was killed when link tapped
func scene(_ scene: UIScene,
             willConnectTo session: UISceneSession,
             options connectionOptions: UIScene.ConnectionOptions) {
    if let activity = connectionOptions.userActivities.first,
       activity.activityType == NSUserActivityTypeBrowsingWeb,
       let url = activity.webpageURL {
        Task { await redeemIfNeeded(url) }
    }
}

// Shared redemption logic
func redeemIfNeeded(_ url: URL) async {
    guard url.absoluteString.contains("revenuecat") else { return }
    do {
        let result = try await Purchases.shared.redeemWebPurchase(url)
        await MainActor.run {
            NotificationCenter.default.post(name: .entitlementsUpdated, object: result.customerInfo)
        }
    } catch {
        await MainActor.run { handleRedemptionError(error) }
    }
}

import { Linking } from 'react-native';
import Purchases, { PurchasesError } from 'react-native-purchases';
import { useEffect, useCallback } from 'react';

async function redeemIfNeeded(url: string) {
  if (!url.includes('revenuecat')) return;
  try {
    const { customerInfo } = await Purchases.redeemWebPurchase(url);
    // Emit an event or call a state update to refresh entitlements in your UI
    console.log('Redeemed. Active:', customerInfo.activeSubscriptions);
  } catch (error) {
    handleRedemptionError(error as PurchasesError);
  }
}

export function useRedemptionLink() {
  useEffect(() => {
    // Case 1: app open - fires on every incoming URL
    const sub = Linking.addEventListener('url', ({ url }) => redeemIfNeeded(url));

    // Case 2: cold start - app opened via link from killed state
    Linking.getInitialURL().then((url) => {
      if (url) redeemIfNeeded(url);
    });

    return () => sub.remove();
  }, []);
}

import { PurchasesError, PURCHASES_ERROR_CODE } from 'react-native-purchases';

function handleRedemptionError(error: PurchasesError) {
  switch (error.code) {

    case PURCHASES_ERROR_CODE.PURCHASE_NOT_ALLOWED_ERROR:
      // Link is expired (60-min window passed)
      // RevenueCat auto-sends a new link via email - tell the user
      showAlert(
        'Link Expired',
        'This link has expired. We\'ve sent a fresh one to your email - tap it on your phone.'
      );
      break;

    case PURCHASES_ERROR_CODE.PURCHASE_INVALID_ERROR:
      // Link already redeemed - subscription may already be active
      showAlert(
        'Already Redeemed',
        'This link was already used. Your subscription should be active - try closing and reopening the app.'
      );
      break;

    case PURCHASES_ERROR_CODE.NETWORK_ERROR:
      // Transient - safe to retry
      showAlert(
        'Connection Error',
        'Check your connection and try tapping the link again.'
      );
      break;

    default:
      // Log unknown errors - don't fail silently
      console.error('Redemption error:', error.code, error.message);
      showAlert(
        'Something Went Wrong',
        'Contact support with code: ' + error.code
      );
  }
}