@dodopayments/tanstack 0.1.2 → 0.2.0

package/README.md

@@ -36,6 +36,14 @@ export const ServerRoute = createServerFileRoute("/api/checkout").methods({
       type: "static", // optional, defaults to 'static'
     })(request);
   },
+  POST: async ({ request }) => {
+    return Checkout({
+      bearerToken: process.env.DODO_PAYMENTS_API_KEY,
+      returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
+      environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
+      type: "session", // or "dynamic" for dynamic link
+    })(request);
+  },
 });
 ```
 
@@ -146,7 +154,7 @@ export const ServerRoute = createServerFileRoute("/api/checkout")
         bearerToken: process.env.DODO_PAYMENTS_API_KEY,
         returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
         environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
-        type: "dynamic", // for dynamic checkout
+        type: "session", // or "dynamic" for dynamic link
       })(request)
     }
   })
@@ -160,7 +168,7 @@ Configuration & Usage:
 
     environment: (Optional) Set to "test_mode" for testing, or omit/set to "live_mode" for production.
 
-    type: (Optional) Set to "static" for GET/static checkout, "dynamic" for POST/dynamic checkout. Defaults to "static".
+    type: (Optional) Set to "static" for GET/static checkout, "dynamic" for POST/dynamic checkout, or "session" for POST/checkout sessions.
 
 Static Checkout (GET) Query Parameters:
 
@@ -176,12 +184,23 @@ Static Checkout (GET) Query Parameters:
 
     Metadata (optional): Any query parameter starting with metadata_ (e.g., ?metadata_userId=abc123)
 
-Dynamic Checkout (POST): Parameters are sent as a JSON body. Supports both one-time and recurring payments. For a complete list of supported POST body fields, refer to:
+    Returns: {"checkout_url": "https://checkout.dodopayments.com/..."}
+
+Dynamic Checkout (POST) - Returns JSON with checkout_url: Parameters are sent as a JSON body. Supports both one-time and recurring payments. Returns: {"checkout_url": "https://checkout.dodopayments.com/..."}. For a complete list of supported POST body fields, refer to:
 
     Docs - One Time Payment Product: https://docs.dodopayments.com/api-reference/payments/post-payments
 
     Docs - Subscription Product: https://docs.dodopayments.com/api-reference/subscriptions/post-subscriptions
 
+Checkout Sessions (POST) - (Recommended) A more customizable checkout experience. Returns JSON with checkout_url: Parameters are sent as a JSON body. Supports both one-time and recurring payments. Returns: {"checkout_url": "https://checkout.dodopayments.com/session/..."}. For a complete list of supported POST body fields, refer to:
+
+    Docs - One Time Payment Product: https://docs.dodopayments.com/api-reference/payments/post-payments
+
+    Docs - Subscription Product: https://docs.dodopayments.com/api-reference/subscriptions/post-subscriptions
+
+  Required fields for checkout sessions:
+      product_cart (array): Array of products with product_id and quantity
+
 Error Handling: If productId is missing or other query parameters are invalid, the handler will return a 400 response.
 
 If Customer Portal Route Handler is selected:
@@ -317,7 +336,7 @@ Example .env file:
 DODO_PAYMENTS_API_KEY=your-api-key
 DODO_PAYMENTS_WEBHOOK_KEY=your-webhook-secret
 DODO_PAYMENTS_RETURN_URL=your-return-url
-DODO_PAYMENTS_ENVIRONMENT="test" or "live"
+DODO_PAYMENTS_ENVIRONMENT="test_mode" or "live_mode"
 
 Usage in your code:
 

package/dist/checkout/checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/checkout/checkout.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,qBAAqB,EAGtB,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,qBAAqB,IAC7B,SAAS,OAAO,8CA0DxC"}
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/checkout/checkout.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,qBAAqB,EAItB,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,qBAAqB,IAC7B,SAAS,OAAO,8CAyFxC"}