@paykit-sdk/stripe 1.1.101 → 1.1.103

package/dist/index.js

@@ -4406,7 +4406,9 @@ var StripeProvider = class extends core.AbstractPayKitProvider {
     };
     /**
      * Payment management
+     * Create a payment intent or checkout session for a payment
      */
+    // In packages/stripe/src/stripe-provider.ts
     this.createPayment = async (params) => {
       const { error, data } = core.createPaymentSchema.safeParse(params);
       if (error)
@@ -4415,19 +4417,73 @@ var StripeProvider = class extends core.AbstractPayKitProvider {
           method: "createPayment"
         });
       const { provider_metadata, customer, capture_method, ...rest } = data;
-      if (typeof customer === "object") {
-        throw new core.InvalidTypeError("customer", "string (customer ID)", "object", {
-          provider: this.providerName,
-          method: "createPayment"
+      const createCheckoutSession = async (customerEmail, customerId2) => {
+        const checkoutMetadata = core.stringifyMetadataValues({
+          ...rest.metadata,
+          ...provider_metadata?.metadata ?? {},
+          [core.PAYKIT_METADATA_KEY]: JSON.stringify({ itemId: data.item_id ?? null })
         });
-      }
-      const paymentMetadata = core.stringifyMetadataValues({
-        ...rest.metadata,
-        ...provider_metadata?.metadata ?? {},
-        [core.PAYKIT_METADATA_KEY]: JSON.stringify({ itemId: data.item_id ?? null })
-      });
+        const { success_url } = core.validateRequiredKeys(
+          ["success_url"],
+          provider_metadata,
+          "The following fields must be present in the provider_metadata of createPayment: {keys}"
+        );
+        const checkoutOptions = {
+          mode: "payment",
+          line_items: [
+            {
+              price_data: {
+                currency: rest.currency,
+                product_data: { name: `Payment for ${data.item_id || "item"}` },
+                unit_amount: rest.amount
+              },
+              quantity: 1
+            }
+          ],
+          metadata: checkoutMetadata,
+          payment_intent_data: {
+            capture_method,
+            setup_future_usage: "off_session"
+          },
+          success_url
+        };
+        if (customerId2) checkoutOptions.customer = customerId2;
+        else if (customerEmail) checkoutOptions.customer_email = customerEmail;
+        const checkoutSession = await this.stripe.checkout.sessions.create(checkoutOptions);
+        return {
+          id: checkoutSession.id,
+          amount: rest.amount,
+          currency: rest.currency,
+          customer: customerId2 ? customerId2 : customerEmail ? { email: customerEmail } : "",
+          status: "pending",
+          metadata: core.omitInternalMetadata(checkoutMetadata),
+          item_id: data.item_id ?? null,
+          requires_action: true,
+          payment_url: checkoutSession.url
+        };
+      };
+      let customerId;
+      if (typeof customer === "object" && "email" in customer) {
+        const existingCustomers = await this.stripe.customers.list({
+          email: customer.email,
+          limit: 1
+        });
+        if (existingCustomers.data.length > 0) customerId = existingCustomers.data[0].id;
+        else return createCheckoutSession(customer.email);
+      } else if (typeof customer === "string") {
+        customerId = customer;
+      } else
+        throw new core.InvalidTypeError(
+          "customer",
+          "string (customer ID) or object with email",
+          typeof customer,
+          {
+            provider: this.providerName,
+            method: "createPayment"
+          }
+        );
       const customerWithDefaultPaymentMethod = await this.stripe.customers.retrieve(
-        customer,
+        customerId,
         { expand: ["invoice_settings.default_payment_method"] }
       );
       if ("deleted" in customerWithDefaultPaymentMethod) {
@@ -4438,26 +4494,28 @@ var StripeProvider = class extends core.AbstractPayKitProvider {
       }
       let defaultPaymentMethod = customerWithDefaultPaymentMethod.invoice_settings?.default_payment_method;
       if (!defaultPaymentMethod) {
-        const paymentMethods = await this.stripe.paymentMethods.list({ customer });
+        const paymentMethods = await this.stripe.paymentMethods.list({
+          customer: customerId
+        });
         if (paymentMethods.data.length === 0) {
-          throw new core.ValidationError(
-            `Customer ${customer} has no payment methods. Add a payment method for the customer before creating a payment intent`,
-            { provider: this.providerName, method: "createPayment" }
-          );
+          return createCheckoutSession(void 0, customerId);
         }
         defaultPaymentMethod = paymentMethods.data[0].id;
       }
+      const paymentMetadata = core.stringifyMetadataValues({
+        ...rest.metadata,
+        ...provider_metadata?.metadata ?? {},
+        [core.PAYKIT_METADATA_KEY]: JSON.stringify({ itemId: data.item_id ?? null })
+      });
       const paymentIntentOptions = {
         currency: rest.currency,
         amount: rest.amount,
         metadata: paymentMetadata,
-        customer,
+        customer: customerId,
         capture_method,
         confirm: true,
-        // automatically confirms the payment
         payment_method: defaultPaymentMethod,
         off_session: true
-        // uses customer's default payment method, avoids 3Ds/authentication
       };
       if (data.billing) {
         paymentIntentOptions.shipping = {

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { schema, validateRequiredKeys, AbstractPayKitProvider, createCheckoutSchema, ValidationError, stringifyMetadataValues, InvalidTypeError, updateCheckoutSchema, ResourceNotFoundError, createCustomerSchema, createSubscriptionSchema, updateSubscriptionSchema, retrieveSubscriptionSchema, createPaymentSchema, PAYKIT_METADATA_KEY, updatePaymentSchema, retrievePaymentSchema, tryCatchAsync, deletePaymentSchema, capturePaymentSchema, createRefundSchema, WebhookError, paykitEvent$InboundSchema, billingModeSchema, omitInternalMetadata, invoiceStatusSchema } from '@paykit-sdk/core';
+import { schema, validateRequiredKeys, AbstractPayKitProvider, createCheckoutSchema, ValidationError, stringifyMetadataValues, InvalidTypeError, updateCheckoutSchema, ResourceNotFoundError, createCustomerSchema, createSubscriptionSchema, updateSubscriptionSchema, retrieveSubscriptionSchema, createPaymentSchema, PAYKIT_METADATA_KEY, updatePaymentSchema, retrievePaymentSchema, tryCatchAsync, deletePaymentSchema, capturePaymentSchema, createRefundSchema, WebhookError, omitInternalMetadata, paykitEvent$InboundSchema, billingModeSchema, invoiceStatusSchema } from '@paykit-sdk/core';
 import Stripe from 'stripe';
 
 var __defProp = Object.defineProperty;
@@ -4400,7 +4400,9 @@ var StripeProvider = class extends AbstractPayKitProvider {
     };
     /**
      * Payment management
+     * Create a payment intent or checkout session for a payment
      */
+    // In packages/stripe/src/stripe-provider.ts
     this.createPayment = async (params) => {
       const { error, data } = createPaymentSchema.safeParse(params);
       if (error)
@@ -4409,19 +4411,73 @@ var StripeProvider = class extends AbstractPayKitProvider {
           method: "createPayment"
         });
       const { provider_metadata, customer, capture_method, ...rest } = data;
-      if (typeof customer === "object") {
-        throw new InvalidTypeError("customer", "string (customer ID)", "object", {
-          provider: this.providerName,
-          method: "createPayment"
+      const createCheckoutSession = async (customerEmail, customerId2) => {
+        const checkoutMetadata = stringifyMetadataValues({
+          ...rest.metadata,
+          ...provider_metadata?.metadata ?? {},
+          [PAYKIT_METADATA_KEY]: JSON.stringify({ itemId: data.item_id ?? null })
         });
-      }
-      const paymentMetadata = stringifyMetadataValues({
-        ...rest.metadata,
-        ...provider_metadata?.metadata ?? {},
-        [PAYKIT_METADATA_KEY]: JSON.stringify({ itemId: data.item_id ?? null })
-      });
+        const { success_url } = validateRequiredKeys(
+          ["success_url"],
+          provider_metadata,
+          "The following fields must be present in the provider_metadata of createPayment: {keys}"
+        );
+        const checkoutOptions = {
+          mode: "payment",
+          line_items: [
+            {
+              price_data: {
+                currency: rest.currency,
+                product_data: { name: `Payment for ${data.item_id || "item"}` },
+                unit_amount: rest.amount
+              },
+              quantity: 1
+            }
+          ],
+          metadata: checkoutMetadata,
+          payment_intent_data: {
+            capture_method,
+            setup_future_usage: "off_session"
+          },
+          success_url
+        };
+        if (customerId2) checkoutOptions.customer = customerId2;
+        else if (customerEmail) checkoutOptions.customer_email = customerEmail;
+        const checkoutSession = await this.stripe.checkout.sessions.create(checkoutOptions);
+        return {
+          id: checkoutSession.id,
+          amount: rest.amount,
+          currency: rest.currency,
+          customer: customerId2 ? customerId2 : customerEmail ? { email: customerEmail } : "",
+          status: "pending",
+          metadata: omitInternalMetadata(checkoutMetadata),
+          item_id: data.item_id ?? null,
+          requires_action: true,
+          payment_url: checkoutSession.url
+        };
+      };
+      let customerId;
+      if (typeof customer === "object" && "email" in customer) {
+        const existingCustomers = await this.stripe.customers.list({
+          email: customer.email,
+          limit: 1
+        });
+        if (existingCustomers.data.length > 0) customerId = existingCustomers.data[0].id;
+        else return createCheckoutSession(customer.email);
+      } else if (typeof customer === "string") {
+        customerId = customer;
+      } else
+        throw new InvalidTypeError(
+          "customer",
+          "string (customer ID) or object with email",
+          typeof customer,
+          {
+            provider: this.providerName,
+            method: "createPayment"
+          }
+        );
       const customerWithDefaultPaymentMethod = await this.stripe.customers.retrieve(
-        customer,
+        customerId,
         { expand: ["invoice_settings.default_payment_method"] }
       );
       if ("deleted" in customerWithDefaultPaymentMethod) {
@@ -4432,26 +4488,28 @@ var StripeProvider = class extends AbstractPayKitProvider {
       }
       let defaultPaymentMethod = customerWithDefaultPaymentMethod.invoice_settings?.default_payment_method;
       if (!defaultPaymentMethod) {
-        const paymentMethods = await this.stripe.paymentMethods.list({ customer });
+        const paymentMethods = await this.stripe.paymentMethods.list({
+          customer: customerId
+        });
         if (paymentMethods.data.length === 0) {
-          throw new ValidationError(
-            `Customer ${customer} has no payment methods. Add a payment method for the customer before creating a payment intent`,
-            { provider: this.providerName, method: "createPayment" }
-          );
+          return createCheckoutSession(void 0, customerId);
         }
         defaultPaymentMethod = paymentMethods.data[0].id;
       }
+      const paymentMetadata = stringifyMetadataValues({
+        ...rest.metadata,
+        ...provider_metadata?.metadata ?? {},
+        [PAYKIT_METADATA_KEY]: JSON.stringify({ itemId: data.item_id ?? null })
+      });
       const paymentIntentOptions = {
         currency: rest.currency,
         amount: rest.amount,
         metadata: paymentMetadata,
-        customer,
+        customer: customerId,
         capture_method,
         confirm: true,
-        // automatically confirms the payment
         payment_method: defaultPaymentMethod,
         off_session: true
-        // uses customer's default payment method, avoids 3Ds/authentication
       };
       if (data.billing) {
         paymentIntentOptions.shipping = {

package/dist/stripe-provider.d.mts

@@ -33,6 +33,7 @@ declare class StripeProvider extends AbstractPayKitProvider implements PayKitPro
     deleteSubscription: (id: string) => Promise<null>;
     /**
      * Payment management
+     * Create a payment intent or checkout session for a payment
      */
     createPayment: (params: CreatePaymentSchema) => Promise<Payment>;
     updatePayment: (id: string, params: UpdatePaymentSchema) => Promise<Payment>;

package/dist/stripe-provider.d.ts

@@ -33,6 +33,7 @@ declare class StripeProvider extends AbstractPayKitProvider implements PayKitPro
     deleteSubscription: (id: string) => Promise<null>;
     /**
      * Payment management
+     * Create a payment intent or checkout session for a payment
      */
     createPayment: (params: CreatePaymentSchema) => Promise<Payment>;
     updatePayment: (id: string, params: UpdatePaymentSchema) => Promise<Payment>;

package/dist/stripe-provider.js

@@ -4406,7 +4406,9 @@ var StripeProvider = class extends core.AbstractPayKitProvider {
     };
     /**
      * Payment management
+     * Create a payment intent or checkout session for a payment
      */
+    // In packages/stripe/src/stripe-provider.ts
     this.createPayment = async (params) => {
       const { error, data } = core.createPaymentSchema.safeParse(params);
       if (error)
@@ -4415,19 +4417,73 @@ var StripeProvider = class extends core.AbstractPayKitProvider {
           method: "createPayment"
         });
       const { provider_metadata, customer, capture_method, ...rest } = data;
-      if (typeof customer === "object") {
-        throw new core.InvalidTypeError("customer", "string (customer ID)", "object", {
-          provider: this.providerName,
-          method: "createPayment"
+      const createCheckoutSession = async (customerEmail, customerId2) => {
+        const checkoutMetadata = core.stringifyMetadataValues({
+          ...rest.metadata,
+          ...provider_metadata?.metadata ?? {},
+          [core.PAYKIT_METADATA_KEY]: JSON.stringify({ itemId: data.item_id ?? null })
         });
-      }
-      const paymentMetadata = core.stringifyMetadataValues({
-        ...rest.metadata,
-        ...provider_metadata?.metadata ?? {},
-        [core.PAYKIT_METADATA_KEY]: JSON.stringify({ itemId: data.item_id ?? null })
-      });
+        const { success_url } = core.validateRequiredKeys(
+          ["success_url"],
+          provider_metadata,
+          "The following fields must be present in the provider_metadata of createPayment: {keys}"
+        );
+        const checkoutOptions = {
+          mode: "payment",
+          line_items: [
+            {
+              price_data: {
+                currency: rest.currency,
+                product_data: { name: `Payment for ${data.item_id || "item"}` },
+                unit_amount: rest.amount
+              },
+              quantity: 1
+            }
+          ],
+          metadata: checkoutMetadata,
+          payment_intent_data: {
+            capture_method,
+            setup_future_usage: "off_session"
+          },
+          success_url
+        };
+        if (customerId2) checkoutOptions.customer = customerId2;
+        else if (customerEmail) checkoutOptions.customer_email = customerEmail;
+        const checkoutSession = await this.stripe.checkout.sessions.create(checkoutOptions);
+        return {
+          id: checkoutSession.id,
+          amount: rest.amount,
+          currency: rest.currency,
+          customer: customerId2 ? customerId2 : customerEmail ? { email: customerEmail } : "",
+          status: "pending",
+          metadata: core.omitInternalMetadata(checkoutMetadata),
+          item_id: data.item_id ?? null,
+          requires_action: true,
+          payment_url: checkoutSession.url
+        };
+      };
+      let customerId;
+      if (typeof customer === "object" && "email" in customer) {
+        const existingCustomers = await this.stripe.customers.list({
+          email: customer.email,
+          limit: 1
+        });
+        if (existingCustomers.data.length > 0) customerId = existingCustomers.data[0].id;
+        else return createCheckoutSession(customer.email);
+      } else if (typeof customer === "string") {
+        customerId = customer;
+      } else
+        throw new core.InvalidTypeError(
+          "customer",
+          "string (customer ID) or object with email",
+          typeof customer,
+          {
+            provider: this.providerName,
+            method: "createPayment"
+          }
+        );
       const customerWithDefaultPaymentMethod = await this.stripe.customers.retrieve(
-        customer,
+        customerId,
         { expand: ["invoice_settings.default_payment_method"] }
       );
       if ("deleted" in customerWithDefaultPaymentMethod) {
@@ -4438,26 +4494,28 @@ var StripeProvider = class extends core.AbstractPayKitProvider {
       }
       let defaultPaymentMethod = customerWithDefaultPaymentMethod.invoice_settings?.default_payment_method;
       if (!defaultPaymentMethod) {
-        const paymentMethods = await this.stripe.paymentMethods.list({ customer });
+        const paymentMethods = await this.stripe.paymentMethods.list({
+          customer: customerId
+        });
         if (paymentMethods.data.length === 0) {
-          throw new core.ValidationError(
-            `Customer ${customer} has no payment methods. Add a payment method for the customer before creating a payment intent`,
-            { provider: this.providerName, method: "createPayment" }
-          );
+          return createCheckoutSession(void 0, customerId);
         }
         defaultPaymentMethod = paymentMethods.data[0].id;
       }
+      const paymentMetadata = core.stringifyMetadataValues({
+        ...rest.metadata,
+        ...provider_metadata?.metadata ?? {},
+        [core.PAYKIT_METADATA_KEY]: JSON.stringify({ itemId: data.item_id ?? null })
+      });
       const paymentIntentOptions = {
         currency: rest.currency,
         amount: rest.amount,
         metadata: paymentMetadata,
-        customer,
+        customer: customerId,
         capture_method,
         confirm: true,
-        // automatically confirms the payment
         payment_method: defaultPaymentMethod,
         off_session: true
-        // uses customer's default payment method, avoids 3Ds/authentication
       };
       if (data.billing) {
         paymentIntentOptions.shipping = {

package/dist/stripe-provider.mjs

@@ -1,4 +1,4 @@
-import { schema, AbstractPayKitProvider, createCheckoutSchema, ValidationError, stringifyMetadataValues, InvalidTypeError, updateCheckoutSchema, ResourceNotFoundError, createCustomerSchema, createSubscriptionSchema, updateSubscriptionSchema, retrieveSubscriptionSchema, createPaymentSchema, PAYKIT_METADATA_KEY, updatePaymentSchema, retrievePaymentSchema, tryCatchAsync, deletePaymentSchema, capturePaymentSchema, createRefundSchema, WebhookError, paykitEvent$InboundSchema, billingModeSchema, omitInternalMetadata, invoiceStatusSchema } from '@paykit-sdk/core';
+import { schema, AbstractPayKitProvider, createCheckoutSchema, ValidationError, stringifyMetadataValues, InvalidTypeError, updateCheckoutSchema, ResourceNotFoundError, createCustomerSchema, createSubscriptionSchema, updateSubscriptionSchema, retrieveSubscriptionSchema, createPaymentSchema, PAYKIT_METADATA_KEY, updatePaymentSchema, retrievePaymentSchema, tryCatchAsync, deletePaymentSchema, capturePaymentSchema, createRefundSchema, WebhookError, validateRequiredKeys, omitInternalMetadata, paykitEvent$InboundSchema, billingModeSchema, invoiceStatusSchema } from '@paykit-sdk/core';
 import Stripe from 'stripe';
 
 var __defProp = Object.defineProperty;
@@ -4400,7 +4400,9 @@ var StripeProvider = class extends AbstractPayKitProvider {
     };
     /**
      * Payment management
+     * Create a payment intent or checkout session for a payment
      */
+    // In packages/stripe/src/stripe-provider.ts
     this.createPayment = async (params) => {
       const { error, data } = createPaymentSchema.safeParse(params);
       if (error)
@@ -4409,19 +4411,73 @@ var StripeProvider = class extends AbstractPayKitProvider {
           method: "createPayment"
         });
       const { provider_metadata, customer, capture_method, ...rest } = data;
-      if (typeof customer === "object") {
-        throw new InvalidTypeError("customer", "string (customer ID)", "object", {
-          provider: this.providerName,
-          method: "createPayment"
+      const createCheckoutSession = async (customerEmail, customerId2) => {
+        const checkoutMetadata = stringifyMetadataValues({
+          ...rest.metadata,
+          ...provider_metadata?.metadata ?? {},
+          [PAYKIT_METADATA_KEY]: JSON.stringify({ itemId: data.item_id ?? null })
         });
-      }
-      const paymentMetadata = stringifyMetadataValues({
-        ...rest.metadata,
-        ...provider_metadata?.metadata ?? {},
-        [PAYKIT_METADATA_KEY]: JSON.stringify({ itemId: data.item_id ?? null })
-      });
+        const { success_url } = validateRequiredKeys(
+          ["success_url"],
+          provider_metadata,
+          "The following fields must be present in the provider_metadata of createPayment: {keys}"
+        );
+        const checkoutOptions = {
+          mode: "payment",
+          line_items: [
+            {
+              price_data: {
+                currency: rest.currency,
+                product_data: { name: `Payment for ${data.item_id || "item"}` },
+                unit_amount: rest.amount
+              },
+              quantity: 1
+            }
+          ],
+          metadata: checkoutMetadata,
+          payment_intent_data: {
+            capture_method,
+            setup_future_usage: "off_session"
+          },
+          success_url
+        };
+        if (customerId2) checkoutOptions.customer = customerId2;
+        else if (customerEmail) checkoutOptions.customer_email = customerEmail;
+        const checkoutSession = await this.stripe.checkout.sessions.create(checkoutOptions);
+        return {
+          id: checkoutSession.id,
+          amount: rest.amount,
+          currency: rest.currency,
+          customer: customerId2 ? customerId2 : customerEmail ? { email: customerEmail } : "",
+          status: "pending",
+          metadata: omitInternalMetadata(checkoutMetadata),
+          item_id: data.item_id ?? null,
+          requires_action: true,
+          payment_url: checkoutSession.url
+        };
+      };
+      let customerId;
+      if (typeof customer === "object" && "email" in customer) {
+        const existingCustomers = await this.stripe.customers.list({
+          email: customer.email,
+          limit: 1
+        });
+        if (existingCustomers.data.length > 0) customerId = existingCustomers.data[0].id;
+        else return createCheckoutSession(customer.email);
+      } else if (typeof customer === "string") {
+        customerId = customer;
+      } else
+        throw new InvalidTypeError(
+          "customer",
+          "string (customer ID) or object with email",
+          typeof customer,
+          {
+            provider: this.providerName,
+            method: "createPayment"
+          }
+        );
       const customerWithDefaultPaymentMethod = await this.stripe.customers.retrieve(
-        customer,
+        customerId,
         { expand: ["invoice_settings.default_payment_method"] }
       );
       if ("deleted" in customerWithDefaultPaymentMethod) {
@@ -4432,26 +4488,28 @@ var StripeProvider = class extends AbstractPayKitProvider {
       }
       let defaultPaymentMethod = customerWithDefaultPaymentMethod.invoice_settings?.default_payment_method;
       if (!defaultPaymentMethod) {
-        const paymentMethods = await this.stripe.paymentMethods.list({ customer });
+        const paymentMethods = await this.stripe.paymentMethods.list({
+          customer: customerId
+        });
         if (paymentMethods.data.length === 0) {
-          throw new ValidationError(
-            `Customer ${customer} has no payment methods. Add a payment method for the customer before creating a payment intent`,
-            { provider: this.providerName, method: "createPayment" }
-          );
+          return createCheckoutSession(void 0, customerId);
         }
         defaultPaymentMethod = paymentMethods.data[0].id;
       }
+      const paymentMetadata = stringifyMetadataValues({
+        ...rest.metadata,
+        ...provider_metadata?.metadata ?? {},
+        [PAYKIT_METADATA_KEY]: JSON.stringify({ itemId: data.item_id ?? null })
+      });
       const paymentIntentOptions = {
         currency: rest.currency,
         amount: rest.amount,
         metadata: paymentMetadata,
-        customer,
+        customer: customerId,
         capture_method,
         confirm: true,
-        // automatically confirms the payment
         payment_method: defaultPaymentMethod,
         off_session: true
-        // uses customer's default payment method, avoids 3Ds/authentication
       };
       if (data.billing) {
         paymentIntentOptions.shipping = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paykit-sdk/stripe",
-  "version": "1.1.101",
+  "version": "1.1.103",
   "description": "Stripe provider for PayKit",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",