Stripe Billing · MakelyOS Scaffold

Ready for production wire — Boss plugs in publishable + secret keys in the morning, real $$ starts flowing.

🔑 Stripe API Keys

Publishable Key (pk_live_… or pk_test_…) Secret Key (sk_live_… or sk_test_…) Webhook Signing Secret (whsec_…) ⚠ Empty · awaiting Boss

⚙️ Mode Toggle

Environment Currency Statement Descriptor (what shows on card statements) ⏳ Test mode default

💳 Revenue Flow Scaffolds (UI built · backend awaits Boss approval)

💰

Wallet Topup

+ Add Credit pill → Stripe Checkout → webhook updates wallet balance

⏳ Awaiting keys

🔄

Monthly Subscription

$149/$299/$599/$999 tiers · Stripe Billing manages auto-charge

⏳ Awaiting keys

📦

Post Pack

One-time $X for X posts when quota runs out

⏳ Awaiting keys

📤

Per-Post Publish

Wallet debit per site · auto-topup when low

⏳ Awaiting keys

✨

AI Generation

$1 image · $1 desc · $2 video — debited from wallet

⏳ Awaiting keys

🔁

Auto-Replenish

Opt-in: auto-charge $200 when wallet drops below $50

⏳ Awaiting keys

↩️

Refund Flow

Boss-only · per refund-policy doctrine (1mo pro-rated)

⏳ Awaiting keys

⚠️

Disputes Dashboard

Auto-flag disputes · one-click evidence submission

⏳ Awaiting keys

🧪 Test Wire Sequence (recommended first)

✓ 1. Create Stripe account at dashboard.stripe.com

✓ 2. Get test mode keys (pk_test_… + sk_test_…)

⏳ 3. Paste keys above + save

○ 4. Run TEST wallet topup with card 4242 4242 4242 4242 (Stripe test card)

○ 5. Verify webhook fires + wallet updates

○ 6. Switch to LIVE mode + run real test charge ($1)

○ 7. Verify on bank statement

○ 8. Enable for all clients

📘 Stripe Keys Dashboard 📘 Subscriptions Docs 📘 Webhooks Setup 📘 Test Card Numbers

🛡 Boss Safety Checklist (before going LIVE)

✓ Test mode succeeds with at least 3 different test cards (Visa/MC/Amex)
✓ Webhook signing secret configured (prevents fake webhook attacks)
✓ Refund policy from legal pack matches Stripe configured refund window
✓ Statement descriptor approved with attorney Michael B.
✓ Privacy Policy mentions Stripe as a subprocessor (per DPA)
✓ Truist business account verified to receive deposits
✓ Tax settings configured (Stripe Tax for sales tax compliance)
✓ Boss has read https://stripe.com/files/legal/u-s-services-agreement.pdf
✓ Daily Stripe → Supabase sync cron tested in TEST mode first

✅ What ships when Boss approves the wire

Real-time charging on every Wallet Topup pill click
Auto-renew monthly subscriptions across all 10 active clients = $4,000+ MRR captured automatically
Post Pack purchases when clients exhaust quota → instant revenue
Per-post publish credits → granular monetization (~$1-4 × 30 sites × hundreds of posts/mo)
Refund + dispute handling from Master Admin in 2 clicks
Daily settlement to Boss's bank account
Full audit trail for every transaction

⚠ This scaffold makes ZERO live API calls. All buttons show alerts only until Boss explicitly authorizes go-live.