@dodopayments/sveltekit 0.1.2 → 0.2.0

package/README.md

@@ -34,10 +34,19 @@ import {
 const checkoutGetHandler = Checkout({
   bearerToken: DODO_PAYMENTS_API_KEY,
   returnUrl: DODO_PAYMENTS_RETURN_URL,
-  environment: environment,
-  type: "static", // optional, defaults to 'static'
+  environment: DODO_PAYMENTS_ENVIRONMENT,
+  type: "static",
+});
+
+const checkoutPostHandler = Checkout({
+  bearerToken: DODO_PAYMENTS_API_KEY,
+  returnUrl: DODO_PAYMENTS_RETURN_URL,
+  environment: DODO_PAYMENTS_ENVIRONMENT,
+  type: "session", // or "dynamic" for dynamic link
 });
+
 export const GET = checkoutGetHandler.GET;
+export const POST = checkoutPostHandler.POST;
 ```
 
 ---
@@ -125,7 +134,7 @@ Here's how you should structure your response:
 
 If Checkout Route Handler is selected:
 
-Purpose: This handler redirects users to the Dodo Payments checkout page.
+Purpose: This handler manages different types of checkout flows. All checkout types (static, dynamic, and sessions) return JSON responses with checkout URLs for programmatic handling.
 File Creation: Create a new file at app/checkout/route.ts in your SvelteKit project.
 
 Code Snippet:
@@ -137,15 +146,15 @@ import { DODO_PAYMENTS_API_KEY, DODO_PAYMENTS_RETURN_URL, DODO_PAYMENTS_ENVIRONM
 const checkoutGetHandler = Checkout({
     bearerToken: DODO_PAYMENTS_API_KEY,
     returnUrl: DODO_PAYMENTS_RETURN_URL,
-    environment: environment,
-    type: "static", // optional, defaults to 'static'
+    environment: DODO_PAYMENTS_ENVIRONMENT,
+    type: "static",
 });
 
 const checkoutPostHandler = Checkout({
     bearerToken: DODO_PAYMENTS_API_KEY,
     returnUrl: DODO_PAYMENTS_RETURN_URL,
-    environment: environment,
-    type: "dynamic", // optional, defaults to 'static'
+    environment: DODO_PAYMENTS_ENVIRONMENT,
+    type: "session", // or "dynamic" for dynamic link
 });
 
 export const GET = checkoutGetHandler.GET;
@@ -159,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:
 
@@ -175,13 +184,24 @@ 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
 
-Error Handling: If productId is missing or other query parameters are invalid, the handler will return a 400 response.
+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 parameters are invalid, the handler will return a 400 response.
 
 If Customer Portal Route Handler is selected:
 
@@ -196,7 +216,7 @@ import { DODO_PAYMENTS_API_KEY, DODO_PAYMENTS_RETURN_URL, DODO_PAYMENTS_ENVIRONM
 
 const customerPortalHandler = CustomerPortal({
     bearerToken: DODO_PAYMENTS_API_KEY,
-    environment: environment,
+    environment: DODO_PAYMENTS_ENVIRONMENT,
 });
 
 export const GET = customerPortalHandler.GET;
@@ -309,7 +329,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,EAAS,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAEL,KAAK,qBAAqB,EAG3B,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,QAAQ,GAAI,QAAQ,qBAAqB;;;CAuErD,CAAC"}
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/checkout/checkout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAEL,KAAK,qBAAqB,EAI3B,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,QAAQ,GAAI,QAAQ,qBAAqB;;;CAmGrD,CAAC"}