SKPayments Architecture

Multi-app Stripe subscription gateway: checkout, webhooks, and LiteLLM tier provisioning

SKPayments Architecture Multi-app Stripe subscription gateway: checkout, webhooks, and LiteLLM tier provisioning User Browser · completes payment on Stripe · Client layer User Browser completes payment on Stripe App Backend · e.g. SKAI, any registered app · Client layer App Backend e.g. SKAI, any registered app Edge Network · DNS and tunnel ingress · Edge, Cloudflare tunnel Edge Network DNS and tunnel ingress Traefik · TLS termination and routing · Edge, Cloudflare tunnel Traefik TLS termination and routing SKPayment API · FastAPI, port 8000 · SKPayment deployment SKPayment API FastAPI, port 8000 SQLite · customer and subscription records · SKPayment deployment SQLite customer and subscription records apps.json · per-app registry, bind mounted read only · SKPayment deployment apps.json per-app registry, bind mounted read only LiteLLM, SKAI tier · budget and rate limits · Per-app LiteLLM LiteLLM, SKAI tier budget and rate limits LiteLLM, other apps · same update path, any app · Per-app LiteLLM LiteLLM, other apps same update path, any app Stripe Checkout · hosted payment session · Stripe Stripe Checkout hosted payment session Stripe Customer Portal · self-serve plan management · Stripe Stripe Customer Portal self-serve plan management Stripe Webhooks · subscription lifecycle events · Stripe Stripe Webhooks subscription lifecycle events HTTPS POST /checkout/{app_id} POST /webhook/stripe, signed create session redirect to pay portal link read and write read on restart POST /user/update POST /user/update Client layer Edge, Cloudflare tunnel SKPayment deployment Per-app LiteLLM Stripe Legend Frontend Backend Database Cloud External