@paygentic/sdk 0.7.2 → 0.7.3

package/src/models/paymentsession.ts

@@ -9,13 +9,16 @@ import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
 
 export const PaymentSessionObject = {
-  PaymentSession: "payment_session",
+  PaymentSession: "paymentSession",
 } as const;
 export type PaymentSessionObject = ClosedEnum<typeof PaymentSessionObject>;
 
-/**
- * Lifecycle status of the session.
- */
+export const Mode = {
+  Payment: "payment",
+  Setup: "setup",
+} as const;
+export type Mode = ClosedEnum<typeof Mode>;
+
 export const PaymentSessionStatus = {
   Pending: "pending",
   Processing: "processing",
@@ -24,47 +27,26 @@ export const PaymentSessionStatus = {
   Expired: "expired",
   Cancelled: "cancelled",
 } as const;
-/**
- * Lifecycle status of the session.
- */
 export type PaymentSessionStatus = ClosedEnum<typeof PaymentSessionStatus>;
 
 export type PaymentSession = {
   object: PaymentSessionObject;
   /**
-   * Payment session ID (ps_*).
+   * Payment session identifier (e.g. `ps_...`).
    */
   id: string;
-  /**
-   * Type of entity the session pays for (invoice, subscription, payment, topup).
-   */
-  entityType: string;
-  /**
-   * ID of the entity the session pays for.
-   */
-  entityId: string;
-  /**
-   * Amount in decimal dollars.
-   */
-  amount: string;
-  /**
-   * ISO 4217 currency code.
-   */
-  currency: string;
-  /**
-   * Lifecycle status of the session.
-   */
+  mode: Mode;
   status: PaymentSessionStatus;
   /**
-   * Stripe Connect account ID (acct_*) when the session is routed to a connected account.
-   */
-  merchantPaymentAccountId?: string | null | undefined;
-  /**
-   * Timestamp the session reached terminal completion. Null until the session completes.
+   * Hosted page URL. Redirect the customer here, or load it inside an iframe — when iframed, the page reports outcomes via `postMessage` (`payment_success` / `payment_error`) to the parent window.
    */
+  url: string;
+  successRedirectUrl?: string | null | undefined;
+  failureRedirectUrl?: string | null | undefined;
+  metadata?: { [k: string]: any } | undefined;
+  expiresAt: Date;
   completedAt?: Date | null | undefined;
   createdAt: Date;
-  updatedAt: Date;
 };
 
 /** @internal */
@@ -72,6 +54,11 @@ export const PaymentSessionObject$inboundSchema: z.ZodNativeEnum<
   typeof PaymentSessionObject
 > = z.nativeEnum(PaymentSessionObject);
 
+/** @internal */
+export const Mode$inboundSchema: z.ZodNativeEnum<typeof Mode> = z.nativeEnum(
+  Mode,
+);
+
 /** @internal */
 export const PaymentSessionStatus$inboundSchema: z.ZodNativeEnum<
   typeof PaymentSessionStatus
@@ -85,17 +72,17 @@ export const PaymentSession$inboundSchema: z.ZodType<
 > = z.object({
   object: PaymentSessionObject$inboundSchema,
   id: z.string(),
-  entityType: z.string(),
-  entityId: z.string(),
-  amount: z.string(),
-  currency: z.string(),
+  mode: Mode$inboundSchema,
   status: PaymentSessionStatus$inboundSchema,
-  merchantPaymentAccountId: z.nullable(z.string()).optional(),
+  url: z.string(),
+  successRedirectUrl: z.nullable(z.string()).optional(),
+  failureRedirectUrl: z.nullable(z.string()).optional(),
+  metadata: z.record(z.any()).optional(),
+  expiresAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   completedAt: z.nullable(
     z.string().datetime({ offset: true }).transform(v => new Date(v)),
   ).optional(),
   createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
-  updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
 });
 
 export function paymentSessionFromJSON(

package/src/models/schemaspaymentsession.ts

@@ -0,0 +1,113 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { ClosedEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+
+export const SchemasPaymentSessionObject = {
+  PaymentSession: "payment_session",
+} as const;
+export type SchemasPaymentSessionObject = ClosedEnum<
+  typeof SchemasPaymentSessionObject
+>;
+
+/**
+ * Lifecycle status of the session.
+ */
+export const SchemasPaymentSessionStatus = {
+  Pending: "pending",
+  Processing: "processing",
+  Completed: "completed",
+  Failed: "failed",
+  Expired: "expired",
+  Cancelled: "cancelled",
+} as const;
+/**
+ * Lifecycle status of the session.
+ */
+export type SchemasPaymentSessionStatus = ClosedEnum<
+  typeof SchemasPaymentSessionStatus
+>;
+
+export type SchemasPaymentSession = {
+  object: SchemasPaymentSessionObject;
+  /**
+   * Payment session ID (ps_*).
+   */
+  id: string;
+  /**
+   * Type of entity the session pays for (invoice, subscription, payment, topup).
+   */
+  entityType: string;
+  /**
+   * ID of the entity the session pays for.
+   */
+  entityId: string;
+  /**
+   * Amount in decimal dollars.
+   */
+  amount: string;
+  /**
+   * ISO 4217 currency code.
+   */
+  currency: string;
+  /**
+   * Lifecycle status of the session.
+   */
+  status: SchemasPaymentSessionStatus;
+  /**
+   * Stripe Connect account ID (acct_*) when the session is routed to a connected account.
+   */
+  merchantPaymentAccountId?: string | null | undefined;
+  /**
+   * Timestamp the session reached terminal completion. Null until the session completes.
+   */
+  completedAt?: Date | null | undefined;
+  createdAt: Date;
+  updatedAt: Date;
+};
+
+/** @internal */
+export const SchemasPaymentSessionObject$inboundSchema: z.ZodNativeEnum<
+  typeof SchemasPaymentSessionObject
+> = z.nativeEnum(SchemasPaymentSessionObject);
+
+/** @internal */
+export const SchemasPaymentSessionStatus$inboundSchema: z.ZodNativeEnum<
+  typeof SchemasPaymentSessionStatus
+> = z.nativeEnum(SchemasPaymentSessionStatus);
+
+/** @internal */
+export const SchemasPaymentSession$inboundSchema: z.ZodType<
+  SchemasPaymentSession,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  object: SchemasPaymentSessionObject$inboundSchema,
+  id: z.string(),
+  entityType: z.string(),
+  entityId: z.string(),
+  amount: z.string(),
+  currency: z.string(),
+  status: SchemasPaymentSessionStatus$inboundSchema,
+  merchantPaymentAccountId: z.nullable(z.string()).optional(),
+  completedAt: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ).optional(),
+  createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+});
+
+export function schemasPaymentSessionFromJSON(
+  jsonString: string,
+): SafeParseResult<SchemasPaymentSession, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SchemasPaymentSession$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SchemasPaymentSession' from JSON`,
+  );
+}

package/src/sdk/customers.ts

@@ -3,9 +3,11 @@
  */
 
 import { customersCreate } from "../funcs/customersCreate.js";
+import { customersCreateCustomerPaymentMethod } from "../funcs/customersCreateCustomerPaymentMethod.js";
 import { customersDelete } from "../funcs/customersDelete.js";
 import { customersGet } from "../funcs/customersGet.js";
 import { customersList } from "../funcs/customersList.js";
+import { customersListCustomerPaymentMethods } from "../funcs/customersListCustomerPaymentMethods.js";
 import { customersUpdate } from "../funcs/customersUpdate.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
@@ -85,4 +87,38 @@ export class Customers extends ClientSDK {
       options,
     ));
   }
+
+  /**
+   * List payment methods
+   *
+   * @remarks
+   * List off-session payment methods saved for this customer.
+   */
+  async listCustomerPaymentMethods(
+    request: operations.ListCustomerPaymentMethodsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ListCustomerPaymentMethodsResponse> {
+    return unwrapAsync(customersListCustomerPaymentMethods(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Set up a payment method
+   *
+   * @remarks
+   * Create a payment session that captures a new off-session payment method for this customer without charging. The response contains a hosted-page URL — redirect the customer to it, or load it inside an iframe (when iframed, the page reports outcomes via `postMessage` to the parent window).
+   */
+  async createCustomerPaymentMethod(
+    request: operations.CreateCustomerPaymentMethodRequest,
+    options?: RequestOptions,
+  ): Promise<models.PaymentSession> {
+    return unwrapAsync(customersCreateCustomerPaymentMethod(
+      this,
+      request,
+      options,
+    ));
+  }
 }