diff --git a/.env.example b/.env.example
index d1a5c6f..2e1cd65 100644
--- a/.env.example
+++ b/.env.example
@@ -1,7 +1,7 @@
-# Update these with your Supabase details from your project settings > API
-# https://app.supabase.com/project/_/settings/api
+# Update these with your Supabase details from your project settings > API keys
+# https://supabase.com/dashboard/project/<project-ref>/settings/api-keys
 NEXT_PUBLIC_SUPABASE_URL=your-project-url
-NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=your-publishable-or-anon-key
+NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY=your-publishable-or-anon-key
 SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
 
 # x402 / Circle Nanopayments
diff --git a/README.md b/README.md
index b8b8cb9..a985f9a 100644
--- a/README.md
+++ b/README.md
@@ -143,7 +143,7 @@ Copy `.env.example` to `.env.local` and fill in the required values:
 ```bash
 # Supabase
 NEXT_PUBLIC_SUPABASE_URL=your-project-url
-NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=your-publishable-or-anon-key
+NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY=your-publishable-or-anon-key
 SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
 
 # x402 / Circle Nanopayments
@@ -161,7 +161,7 @@ BUYER_PRIVATE_KEY=0xYourBuyerPrivateKey
 | Variable | Scope | Purpose |
 | --- | --- | --- |
 | `NEXT_PUBLIC_SUPABASE_URL` | Public | Supabase project URL. |
-| `NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY` | Public | Supabase anonymous / publishable key. |
+| `NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY` | Public | Supabase anonymous / publishable key. |
 | `SUPABASE_SERVICE_ROLE_KEY` | Server-side | Supabase service-role key, used to record payment events and withdrawals. |
 | `SELLER_ADDRESS` | Server-side | EVM wallet address for receiving USDC payments. |
 | `SELLER_PRIVATE_KEY` | Server-side | Seller wallet private key, used for Gateway balance queries and withdrawals. |
diff --git a/lib/supabase/client.ts b/lib/supabase/client.ts
index b787d67..5988952 100644
--- a/lib/supabase/client.ts
+++ b/lib/supabase/client.ts
@@ -21,6 +21,6 @@ import { createBrowserClient } from "@supabase/ssr";
 export function createClient() {
   return createBrowserClient(
     process.env.NEXT_PUBLIC_SUPABASE_URL!,
-    process.env.NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY!,
+    process.env.NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY!,
   );
 }
diff --git a/lib/supabase/proxy.ts b/lib/supabase/proxy.ts
index c2d9bb9..82ad9ee 100644
--- a/lib/supabase/proxy.ts
+++ b/lib/supabase/proxy.ts
@@ -26,7 +26,7 @@ export async function updateSession(request: NextRequest) {
 
   const supabase = createServerClient(
     process.env.NEXT_PUBLIC_SUPABASE_URL!,
-    process.env.NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY!,
+    process.env.NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY!,
     {
       cookies: {
         getAll() {
diff --git a/lib/supabase/server.ts b/lib/supabase/server.ts
index 03834af..9e84bd8 100644
--- a/lib/supabase/server.ts
+++ b/lib/supabase/server.ts
@@ -29,7 +29,7 @@ export async function createClient() {
 
   return createServerClient(
     process.env.NEXT_PUBLIC_SUPABASE_URL!,
-    process.env.NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY!,
+    process.env.NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY!,
     {
       cookies: {
         getAll() {