To allow the RevenueCat plugin installed in your Bubble app to read subscriptions and charge money, you must first connect the payment platforms (Apple, Google, Stripe) to RevenueCat.
📖 DETAILED INPUT GUIDE:

1. revenuecat_api_key (Secret v1):
  Used for secure Server-Side Actions.
  Path: Dashboard > Project Settings > API Keys > Secret API Keys (starts with 'sk_').

2. revenuecat_api_key_v2 (Secret v2):
  Required for advanced v2 endpoints (Product Mgmt).
  Path: Dashboard > Project Settings > API Keys > Secret API Keys.

3. api_key (Public SDK):
  Used for the API Connector (Get Offerings, etc.).
  Path: Dashboard > Project Settings > API Keys > Public SDK Keys. Choose for your specific platform.

4. app_user_id:
  The unique identifier of the user in your app. In Bubble, use 'Current User's unique id'.

5. entitlement_id:
  The ID of the feature/level you want to grant (e.g., 'premium'). Found in RevenueCat > Entitlements.

6. expiration_date:
  ISO 8601 date (e.g., 2026-12-31T23:59:59Z) or keywords like 'lifetime' (for Grant Promotional Entitlement).

═══════════════════════════════════════════════════════════

SETUP INSTRUCTIONS:



DOC: https://bubble.io/page?id=revenuecat-advanced-demo&tab=Design&name=documentation_english&type=page&elements=bTHMN0

📖 COMPLETE PLATFORM SETUP GUIDE (Apple, Google, Stripe):
Full guide on where to find your App Store, Play Store & Stripe Keys:
https://github.com/carlosdmoron/Bubble-Plugin-RevenueCat-Advanced/blob/main/SETUP_PLATAFORMAS.md


1. Create a RevenueCat account at https://www.revenuecat.com

2. Get your Secret API Key from RevenueCat Dashboard:
  - Go to Dashboard > Apps > [Your App] > API Keys
  - Copy your Secret API Key (starts with "sk_")
  - IMPORTANT: Never use Public API Keys - they are not secure for server-side calls

3. In your Bubble app, go to Plugins > RevenueCat Advanced

4. Paste your Secret API Key in the "api_key" field

═══════════════════════════════════════════════════════════
AVAILABLE API CALLS (12 Endpoints)
═══════════════════════════════════════════════════════════

📊 SUBSCRIBER MANAGEMENT:

1. GET SUBSCRIBER INFO
  What it does: Retrieves complete subscription information for a user
  When to use:
  - Loading user profile
  - Verifying active subscription status
  - Displaying renewal date or billing information
 
  Use case examples:
  • User logs in → verify if they have premium subscription
  • Display in dashboard → "Your subscription renews on Nov 15, 2025"
  • Conditional logic → allow access only if subscription_status = "active"
  • Detect cancellations → show message if will_renew = false

2. VALIDATE RECEIPT
  What it does: Validates purchase receipts from App Store or Google Play Store
  When to use:
  - After an in-app purchase
  - To verify a transaction is legitimate
  - When restoring previous purchases
 
  Use case examples:
  • User purchases plan → validate receipt before granting premium access
  • "Restore Purchases" button → verify saved receipts
  • Prevent fraud → validate receipt is not fake or duplicated
  • Cross-device sync → validate on user's new device

3. UPDATE SUBSCRIBER ATTRIBUTES
  What it does: Stores custom user data for segmentation and analytics
  When to use:
  - Saving additional user information
  - Creating custom segments
  - For analysis and reporting
 
  Use case examples:
  • Onboarding completed → {"signup_source": "google_ads", "campaign": "summer2025"}
  • User upgrades plan → {"subscription_tier": "premium", "upgrade_date": "2025-10-24"}
  • Demographics → {"user_type": "student", "university": "MIT"}
  • Preferences → {"language": "en", "notifications": "enabled"}

4. DELETE SUBSCRIBER
  What it does: Permanently deletes all user data
  When to use:
  - User requests account deletion
  - GDPR/privacy compliance
  - Cleanup of inactive user data
 
  Use case examples:
  • User clicks "Delete my account" → permanently erase everything
  • GDPR request → comply with right to be forgotten
  • Annual cleanup → remove users inactive for 2+ years
  • WARNING: This action is irreversible

5. CREATE OR TRANSFER SUBSCRIBER
  What it does: Creates new subscriber or transfers subscription between IDs
  When to use:
  - Migrating users between systems
  - Changing user identifier
  - Merging duplicate accounts
 
  Use case examples:
  • User changes email → transfer from [email protected] to [email protected]
  • Account merge → consolidate history from 2 profiles
  • System migration → change from numeric user_id to email
  • Maintain subscription → when switching unique identifiers

6. GET OFFERINGS
  What it does: Retrieves all available plans and products
  When to use:
  - Displaying pricing page (paywall)
  - Listing subscription options
  - Running A/B tests on offers
 
  Use case examples:
  • Paywall → show "Basic $9.99/mo", "Premium $19.99/mo", "Enterprise $49.99/mo"
  • Pricing page → list all options with descriptions
  • A/B test → show offering_a vs offering_b by segment
  • Free trial → display "7 days free, then $14.99/month"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🛍️ PRODUCT MANAGEMENT (API v2):

7. LIST PRODUCTS
  What it does: Lists all products configured in your project
  When to use:
  - Admin panel management
  - Catalog synchronization
  - Reporting and analytics
 
  Use case examples:
  • Admin dashboard → display table of all products
  • Auto-sync → update catalog every 24 hours
  • Monthly report → analyze sales by product
  • Verification → ensure products are configured correctly

8. CREATE PRODUCT
  What it does: Creates new products from your application
  When to use:
  - Dynamic product management
  - Automatic launches
  - Region-specific products
 
  Use case examples:
  • Admin creates plan → "Premium Plus" with additional AI features
  • Automatic launch → create product when activating new feature
  • Regionalization → create "Premium_EU" with euro pricing
  • Temporary products → create Black Friday special offer

9. LIST OFFERINGS V2
  What it does: Lists offerings with advanced v2 API functionality
  When to use:
  - Multi-project management
  - Complex configurations
  - Custom metadata
 
  Use case examples:
  • Multi-tenant → show specific offerings per client/project
  • Advanced metadata → filter offerings by custom tags
  • Corporate dashboard → manage offerings across multiple apps
  • Granular configuration → offerings with complex rules

10. LIST ENTITLEMENTS
   What it does: Lists all available permissions/access rights
   When to use:
   - Configuring which features each plan unlocks
   - Feature access control
   - Permission management
   
   Use case examples:
   • Initial setup → define entitlements: "premium_features", "unlimited_storage"
   • Verify access → if user.entitlements includes "export_data" → allow export
   • Features panel → show which features user has enabled
   • Debugging → verify which entitlements are configured

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎁 PROMOTIONAL OFFERS:

11. GRANT PROMOTIONAL ENTITLEMENT
   What it does: Grants temporary promotional access to premium features
   When to use:
   - Marketing campaigns
   - Special trial periods
   - Customer compensation
   - Influencer collaborations
   
   Use case examples:
   • Black Friday → grant 30 days free: {duration: "P30D", entitlement: "premium_features"}
   • Influencer marketing → give 90 days free to content creators
   • Compensation → customer had technical issue → 1 month free
   • Beta testers → free early access for 60 days
   • Referral program → referred friend gets 2 weeks free

12. REVOKE PROMOTIONAL ENTITLEMENT
   What it does: Cancels promotional access before its natural expiration
   When to use:
   - Canceling promotions early
   - Resolving abuse cases
   - Correcting grant errors
   
   Use case examples:
   • Abuse detected → user mass-shared promo code → revoke access
   • Campaign change → end promotion before planned date
   • Human error → access given to wrong user → correct immediately
   • Terms violation → user broke conditions → remove promo access

═══════════════════════════════════════════════════════════

📱 MOBILE APP INTEGRATION:
For iOS/Android apps, use this plugin with BDK Native for full integration.

📚 COMPLETE DOCUMENTATION:
https://www.revenuecat.com/docs

💡 SUPPORT:
All endpoints support dynamic parameters for multi-user apps.
Each user configures their own api_key once.


═══════════════════════════════════════════════════════════
INSTRUCCIONES EN ESPAÑOL
═══════════════════════════════════════════════════════════

INSTRUCCIONES DE CONFIGURACIÓN:

📖 GUÍA COMPLETA DE PLATAFORMAS (Apple, Google, Stripe):
Guía paso a paso sobre dónde encontrar todas tus llaves (App Store, Play Store y Stripe Webhook):
https://github.com/carlosdmoron/Bubble-Plugin-RevenueCat-Advanced/blob/main/SETUP_PLATAFORMAS.md


1. Crea una cuenta en RevenueCat: https://www.revenuecat.com

2. Obtén tu Secret API Key desde el Dashboard:
  - Ve a Dashboard > Apps > [Tu App] > API Keys
  - Copia tu Secret API Key (comienza con "sk_")
  - IMPORTANTE: Nunca uses Public API Keys - no son seguras

3. En tu app Bubble, ve a Plugins > RevenueCat Advanced

4. Pega tu Secret API Key en el campo "api_key"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
LLAMADAS API (12 Endpoints)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 GESTIÓN DE SUSCRIPTORES:

1. GET SUBSCRIBER INFO
  Qué hace: Obtiene información completa de suscripción
  Cuándo usar: Cargar perfil, verificar estado, mostrar facturación
  Ejemplos:
  • Login → verificar suscripción premium
  • Dashboard → "Tu suscripción se renueva el 15 Nov 2025"
  • Lógica → acceso si status = "active"

2. VALIDATE RECEIPT
  Qué hace: Valida recibos de App Store/Play Store
  Cuándo usar: Después de compra, restaurar compras
  Ejemplos:
  • Compra → validar antes de dar acceso premium
  • Botón Restaurar → verificar recibos guardados
  • Prevenir fraude → validar legitimidad

3. UPDATE SUBSCRIBER ATTRIBUTES
  Qué hace: Guarda datos personalizados del usuario
  Cuándo usar: Segmentación, analytics, atributos custom
  Ejemplos:
  • Onboarding → {"signup_source": "google_ads"}
  • Upgrade → {"tier": "premium"}
  • Preferencias → {"language": "es"}

4. DELETE SUBSCRIBER
  Qué hace: Elimina todos los datos del usuario
  Cuándo usar: Solicitud de borrado, GDPR, limpieza
  Ejemplos:
  • Eliminar cuenta → borrado permanente
  • GDPR → derecho al olvido
  • ⚠️ ADVERTENCIA: Acción irreversible

5. CREATE OR TRANSFER SUBSCRIBER
  Qué hace: Crea usuario o transfiere suscripción
  Cuándo usar: Migración, cambio de ID, fusionar cuentas
  Ejemplos:
  • Cambio email → transferir suscripción
  • Fusión → consolidar perfiles
  • Migración → cambiar identificador

6. GET OFFERINGS
  Qué hace: Obtiene planes y productos disponibles
  Cuándo usar: Paywall, pricing, A/B testing
  Ejemplos:
  • Paywall → "Basic $9.99", "Premium $19.99"
  • A/B test → diferentes ofertas por segmento
  • Trial → "7 días gratis, luego $14.99/mes"

🛍️ GESTIÓN DE PRODUCTOS:

7. LIST PRODUCTS - Lista productos del proyecto
8. CREATE PRODUCT - Crea nuevos productos
9. LIST OFFERINGS V2 - Ofertas con API v2 avanzada
10. LIST ENTITLEMENTS - Lista permisos/derechos

🎁 OFERTAS PROMOCIONALES:

11. GRANT PROMOTIONAL ENTITLEMENT
   Qué hace: Otorga acceso promocional temporal
   Ejemplos:
   • Black Friday → 30 días gratis
   • Influencers → 90 días acceso
   • Compensación → 1 mes gratis por problema

12. REVOKE PROMOTIONAL ENTITLEMENT
   Qué hace: Cancela acceso promo antes de expirar
   Ejemplos:
   • Abuso → revocar acceso
   • Error → corregir otorgamiento


═══════════════════════════════════════════════════════════
INSTRUCTIONS EN FRANÇAIS
═══════════════════════════════════════════════════════════

INSTRUCTIONS DE CONFIGURATION:

1. Créez un compte RevenueCat: https://www.revenuecat.com

2. Obtenez votre Secret API Key depuis le Dashboard:
  - Allez à Dashboard > Apps > [Votre App] > API Keys
  - Copiez votre Secret API Key (commence par "sk_")
  - IMPORTANT: N'utilisez jamais les Public API Keys - non sécurisées

3. Dans votre app Bubble, allez à Plugins > RevenueCat Advanced

4. Collez votre Secret API Key dans le champ "api_key"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
APPELS API DISPONIBLES (12 Endpoints)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 GESTION DES ABONNÉS:

1. GET SUBSCRIBER INFO
  Fonction: Récupère les informations d'abonnement
  Quand utiliser: Charger profil, vérifier statut, afficher facturation
  Exemples:
  • Connexion → vérifier abonnement premium
  • Tableau de bord → "Votre abonnement se renouvelle le 15 nov 2025"
  • Logique → accès si status = "active"

2. VALIDATE RECEIPT
  Fonction: Valide les reçus App Store/Play Store
  Quand utiliser: Après achat, restaurer achats
  Exemples:
  • Achat → valider avant accès premium
  • Bouton Restaurer → vérifier reçus sauvegardés
  • Prévenir fraude → valider légitimité

3. UPDATE SUBSCRIBER ATTRIBUTES
  Fonction: Enregistre données personnalisées utilisateur
  Quand utiliser: Segmentation, analytics, attributs custom
  Exemples:
  • Onboarding → {"signup_source": "google_ads"}
  • Upgrade → {"tier": "premium"}
  • Préférences → {"language": "fr"}

4. DELETE SUBSCRIBER
  Fonction: Supprime toutes les données utilisateur
  Quand utiliser: Demande suppression, RGPD, nettoyage
  Exemples:
  • Supprimer compte → effacement permanent
  • RGPD → droit à l'oubli
  • ⚠️ ATTENTION: Action irréversible

5. CREATE OR TRANSFER SUBSCRIBER
  Fonction: Crée utilisateur ou transfère abonnement
  Quand utiliser: Migration, changement ID, fusionner comptes
  Exemples:
  • Changement email → transférer abonnement
  • Fusion → consolider profils
  • Migration → changer identifiant

6. GET OFFERINGS
  Fonction: Récupère plans et produits disponibles
  Quand utiliser: Paywall, tarification, A/B testing
  Exemples:
  • Paywall → "Basic 9,99€", "Premium 19,99€"
  • A/B test → offres différentes par segment
  • Essai → "7 jours gratuits, puis 14,99€/mois"

🛍️ GESTION DES PRODUITS:

7. LIST PRODUCTS - Liste produits du projet
8. CREATE PRODUCT - Crée nouveaux produits
9. LIST OFFERINGS V2 - Offres avec API v2 avancée
10. LIST ENTITLEMENTS - Liste permissions/droits

🎁 OFFRES PROMOTIONNELLES:

11. GRANT PROMOTIONAL ENTITLEMENT
   Fonction: Accorde accès promotionnel temporaire
   Exemples:
   • Black Friday → 30 jours gratuits
   • Influenceurs → 90 jours d'accès
   • Compensation → 1 mois gratuit pour problème

12. REVOKE PROMOTIONAL ENTITLEMENT
   Fonction: Annule accès promo avant expiration
   Exemples:
   • Abus → révoquer accès
   • Erreur → corriger attribution

📚 DOCUMENTATION: https://www.revenuecat.com/docs
💡 Tous les endpoints supportent paramètres dynamiques multi-utilisateurs