feat: Scottzilla Payments — multi-provider payment + API key management

README.md

@@ -1,10 +1,61 @@
 ---
 title: Scottzilla Payments
-emoji: 🐠
-colorFrom: blue
-colorTo: blue
+emoji: 💰
+colorFrom: green
+colorTo: yellow
 sdk: docker
-pinned: false
+app_port: 7860
+pinned: true
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 💰 Scottzilla Payments
+
+Multi-provider payment server for the Scottzilla AI platform. Handles subscriptions, API key management, and usage metering across **Stripe, PayPal, Coinbase Commerce, Cash App (via Square), and Gumroad**.
+
+## Pricing Tiers
+
+| Tier | Price | Requests/day | Models | Features |
+|---|---|---|---|---|
+| **Free** | $0 | 25 | ChatGPT-5 only | Basic chat |
+| **Pro** | $9.99/mo | 500 | All 16 models | Smart routing, tools, priority |
+| **Ultra** | $29.99/mo | 5,000 | All 16 + image gen | Everything + image editing |
+| **Enterprise** | $99.99/mo | Unlimited | All + dedicated | SLA, custom models, API |
+| **Pay-as-you-go** | $0.001/req | Unlimited | All 16 models | No subscription needed |
+
+## Payment Providers
+
+| Provider | Subscriptions | One-time | Crypto | Link |
+|---|---|---|---|---|
+| **Stripe** | ✅ | ✅ | ❌ | Cards, Apple Pay, Google Pay |
+| **PayPal** | ✅ | ✅ | ❌ | PayPal balance, cards |
+| **Coinbase Commerce** | ❌ | ✅ | ✅ | BTC, ETH, USDC, etc. |
+| **Square (Cash App)** | ❌ | ✅ | ❌ | Cash App Pay |
+| **Gumroad** | ✅ | ✅ | ❌ | Simple checkout, built-in affiliate |
+
+## API Endpoints
+
+| Endpoint | Description |
+|---|---|
+| `GET /` | Dashboard + status |
+| `POST /api/keys/create` | Generate new API key |
+| `GET /api/keys/verify/:key` | Verify key + get tier/usage |
+| `POST /api/checkout/:provider` | Create checkout session |
+| `POST /api/webhooks/:provider` | Payment webhooks |
+| `GET /api/usage/:key` | Usage stats |
+| `GET /api/pricing` | Current pricing tiers |
+
+## Setup
+
+Add these secrets in Space Settings:
+
+| Secret | Required | Description |
+|---|---|---|
+| `STRIPE_SECRET_KEY` | For Stripe | `sk_live_...` or `sk_test_...` |
+| `STRIPE_WEBHOOK_SECRET` | For Stripe | `whsec_...` |
+| `PAYPAL_CLIENT_ID` | For PayPal | OAuth client ID |
+| `PAYPAL_CLIENT_SECRET` | For PayPal | OAuth secret |
+| `COINBASE_API_KEY` | For Coinbase | Commerce API key |
+| `COINBASE_WEBHOOK_SECRET` | For Coinbase | Webhook shared secret |
+| `SQUARE_ACCESS_TOKEN` | For Cash App | Square access token |
+| `GUMROAD_ACCESS_TOKEN` | For Gumroad | API access token |
+| `JWT_SECRET` | Required | Random string for API key signing |