Revenuecat

重要ルール:

• SDK 初期化はアプリ起動時の早い段階で行う
• Public API Key のみ使用。Secret Key は絶対にクライアントに含めない
• appUserID に Supabase の auth.uid() を設定してユーザー紐付け

Supabase Auth との連携

// ログイン後に RevenueCat ユーザーIDを設定
const onLogin = async (supabaseUserId: string) => {
  const { customerInfo } = await Purchases.logIn(supabaseUserId);
  return customerInfo;
};

// ログアウト時
const onLogout = async () => {
  await Purchases.logOut(); // 匿名IDにリセット
};

Entitlement チェック

import Purchases, { CustomerInfo } from 'react-native-purchases';

const checkProAccess = async (): Promise<boolean> => {
  const customerInfo = await Purchases.getCustomerInfo();
  return customerInfo.entitlements.active['pro'] !== undefined;
};

// リアルタイムリスナー
Purchases.addCustomerInfoUpdateListener((customerInfo: CustomerInfo) => {
  const isPro = customerInfo.entitlements.active['pro'] !== undefined;
  // Zustand store を更新
  useSubscriptionStore.getState().setIsPro(isPro);
});

Offering & Package 取得

const getOfferings = async () => {
  const offerings = await Purchases.getOfferings();
  const current = offerings.current;
  if (!current) return null;

  return {
    monthly: current.monthly,     // $rc_monthly パッケージ
    annual: current.annual,       // $rc_annual パッケージ
    // カスタムパッケージ
    introAnnual: current.availablePackages.find(
      (p) => p.identifier === 'intro_annual'
    ),
  };
};

購入フロー

import Purchases, { PurchasesPackage } from 'react-native-purchases';

const purchasePackage = async (pkg: PurchasesPackage) => {
  try {
    const { customerInfo } = await Purchases.purchasePackage(pkg);
    if (customerInfo.entitlements.active['pro']) {
      // 購入成功 → ペイウォールを閉じる
      return { success: true };
    }
    return { success: false, error: 'Entitlement not active' };
  } catch (e: any) {
    if (e.userCancelled) {
      return { success: false, cancelled: true };
    }
    return { success: false, error: e.message };
  }
};

購入復元

// ユーザー操作（ボタンタップ）からのみ呼ぶこと
const restorePurchases = async () => {
  try {
    const customerInfo = await Purchases.restorePurchases();
    return customerInfo.entitlements.active['pro'] !== undefined;
  } catch (e) {
    console.error('Restore failed:', e);
    return false;
  }
};

重要: restorePurchases は自動的に呼ばない。必ずユーザーのボタンタップから。

AltMe 課金設計

Offering 構成

Offering: default
├── $rc_monthly   → 月額 ¥4,980
├── $rc_annual    → 年額 ¥39,800（月換算 ¥3,317、33%OFF）
└── intro_annual  → 初回限定 ¥29,800（50%OFF、24時間限定）

Entitlement

Entitlement: "pro"
├── OpenClaw インスタンスアクセス
├── 無制限チャット
├── 詳細性格分析
├── 日記機能
├── 感情トラッキング
└── 全期間データアクセス

サブスクリプションステータス

auto_renewal_status

Day 0 課金ファネル

インストール → オンボーディング（性格診断）→ AI分身お披露目
  → チャット3回（無料制限） → フルスクリーンペイウォール
  → 3日間無料トライアル or 即時課金

ペイウォール設計チェックリスト

[ ] 年額プランを先に表示（アンカリング効果）
[ ] 月額換算を表示（¥3,317/月）
[ ] 初回限定オファーのカウントダウンタイマー
[ ] 閉じるボタンは小さく配置（Apple審査基準に準拠）
[ ] 3日間無料トライアルを明記
[ ] 復元ボタンを必ず配置（App Store審査要件）
[ ] プライバシーポリシー・利用規約リンク

Webhook イベント概要

RevenueCat → Supabase Edge Function でサブスクリプション状態を同期:

詳細: references/webhook-events.md

レート制限

参照ドキュメント

SDK & 実装パターン

• references/sdk-patterns.md — SDK初期化全パターン、Zustand統合、購入フロー、復元、Supabase Auth連携、サンドボックステスト手順

REST API v2

• references/api-v2.md — 全エンドポイント詳細（Projects, Customers 16EP, Subscriptions, Products, Offerings, Entitlements 8EP, Purchases, Paywalls, Integrations, Virtual Currencies, Charts & Metrics）

Webhook

• references/webhook-events.md — 全17イベントタイプ、ペイロード例（JSON）、AltMe での処理パターン、OpenClaw インスタンス管理連動

エラーハンドリング

• references/error-handling.md — HTTP エラーコード、PURCHASES_ERROR_CODE 全22コード、日本語エラーメッセージ、リトライ戦略、レート制限詳細

メトリクス

• references/metrics.md — Charts & Metrics API、21種類のチャート、AltMe KPI（MRR, Day 0課金率, Trial転換率, 解約率, LTV）のAPI取得パターン

ツール

• scripts/rc-api.sh — REST API v2 CLIラッパー（GET/POST/PUT/DELETE 対応）

外部リソース

• RevenueCat Docs: https://www.revenuecat.com/docs
• RevenueCat LLM Docs: https://www.revenuecat.com/docs/llms.txt
• Status Page: https://status.revenuecat.com