@paygentic/sdk 0.9.12 → 0.9.14

package/src/models/mintplanlineinput.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+
+/**
+ * One line of the new version: the price it bills, and the key that names it.
+ */
+export type MintPlanLineInput = {
+  /**
+   * Unique identifier for a price
+   */
+  priceId: string;
+  /**
+   * The key of the line. A key this plan already holds keeps that line, whatever its shape, because a line created before keys could be supplied carries a generated key. A key the plan does not hold names a new line and must match the format in `PlanLineKey`. Omit this to receive a generated key.
+   */
+  key?: string | undefined;
+};
+
+/** @internal */
+export type MintPlanLineInput$Outbound = {
+  priceId: string;
+  key?: string | undefined;
+};
+
+/** @internal */
+export const MintPlanLineInput$outboundSchema: z.ZodType<
+  MintPlanLineInput$Outbound,
+  z.ZodTypeDef,
+  MintPlanLineInput
+> = z.object({
+  priceId: z.string(),
+  key: z.string().optional(),
+});
+
+export function mintPlanLineInputToJSON(
+  mintPlanLineInput: MintPlanLineInput,
+): string {
+  return JSON.stringify(
+    MintPlanLineInput$outboundSchema.parse(mintPlanLineInput),
+  );
+}

package/src/models/mintplanlineref.ts

@@ -0,0 +1,31 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import {
+  MintPlanLineInput,
+  MintPlanLineInput$Outbound,
+  MintPlanLineInput$outboundSchema,
+} from "./mintplanlineinput.js";
+
+/**
+ * Either a price ID on its own, or a price ID with the key that names its line.
+ */
+export type MintPlanLineRef = MintPlanLineInput | string;
+
+/** @internal */
+export type MintPlanLineRef$Outbound = MintPlanLineInput$Outbound | string;
+
+/** @internal */
+export const MintPlanLineRef$outboundSchema: z.ZodType<
+  MintPlanLineRef$Outbound,
+  z.ZodTypeDef,
+  MintPlanLineRef
+> = z.union([MintPlanLineInput$outboundSchema, z.string()]);
+
+export function mintPlanLineRefToJSON(
+  mintPlanLineRef: MintPlanLineRef,
+): string {
+  return JSON.stringify(MintPlanLineRef$outboundSchema.parse(mintPlanLineRef));
+}

package/src/models/mintplanversionrequest.ts

@@ -3,61 +3,30 @@
  */
 
 import * as z from "zod/v3";
-
-export type ReplacePrice = {
-  /**
-   * Unique identifier for a price
-   */
-  replacesPriceId: string;
-  /**
-   * Unique identifier for a price
-   */
-  withPriceId: string;
-};
+import {
+  MintPlanLineRef,
+  MintPlanLineRef$Outbound,
+  MintPlanLineRef$outboundSchema,
+} from "./mintplanlineref.js";
 
 /**
- * A reference-by-id price diff applied to the prices of the plan's current version. Every id references an existing price created via POST /prices; inline price definitions are not accepted. A mint must carry at least one price change, so an empty body is rejected. A version must carry at least one price, so a diff that would leave none is rejected.
+ * The price set the new version is to hold. Every price ID references an existing price created via POST /prices; inline price definitions are not accepted. The change against the plan's current version follows from the keys: a key on both sides with a different price ID replaces that line and keeps its identity, a key only in this request adds a line, and a key the current version holds and this request omits removes that line. An entry with no key adds a line under a generated key; it is never matched to an existing line by price ID. A version must carry at least one price, so an empty set is rejected.
  */
 export type MintPlanVersionRequest = {
   /**
-   * Prices to add to the version. Each must not already be on the plan's current version.
-   */
-  addPrices?: Array<string> | undefined;
-  /**
-   * Prices to remove. Each must be on the plan's current version.
+   * The full price set the new version holds. To move off the previous addPrices, removePrices and replacePrices fields: a replacePrices entry becomes the same key with the new price ID, a removePrices entry becomes an omitted key, and an addPrices entry becomes a new entry.
    */
-  removePrices?: Array<string> | undefined;
+  prices: Array<MintPlanLineRef>;
   /**
-   * Prices to swap in place, preserving the slot's lineage so the price keeps its identity where the plan is configured for stable price ids. replacesPriceId must be on the plan's current version; withPriceId is the new price.
+   * The ID of the plan version you read the current price set from. Supply it to be told when the plan has moved on: the request is rejected with 409 if the plan's current version is no longer this one, so a set built from a stale read cannot drop a line another caller has just added. Omit it to write the set unconditionally.
    */
-  replacePrices?: Array<ReplacePrice> | undefined;
-};
-
-/** @internal */
-export type ReplacePrice$Outbound = {
-  replacesPriceId: string;
-  withPriceId: string;
+  basedOnVersionId?: string | undefined;
 };
 
-/** @internal */
-export const ReplacePrice$outboundSchema: z.ZodType<
-  ReplacePrice$Outbound,
-  z.ZodTypeDef,
-  ReplacePrice
-> = z.object({
-  replacesPriceId: z.string(),
-  withPriceId: z.string(),
-});
-
-export function replacePriceToJSON(replacePrice: ReplacePrice): string {
-  return JSON.stringify(ReplacePrice$outboundSchema.parse(replacePrice));
-}
-
 /** @internal */
 export type MintPlanVersionRequest$Outbound = {
-  addPrices?: Array<string> | undefined;
-  removePrices?: Array<string> | undefined;
-  replacePrices?: Array<ReplacePrice$Outbound> | undefined;
+  prices: Array<MintPlanLineRef$Outbound>;
+  basedOnVersionId?: string | undefined;
 };
 
 /** @internal */
@@ -66,9 +35,8 @@ export const MintPlanVersionRequest$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   MintPlanVersionRequest
 > = z.object({
-  addPrices: z.array(z.string()).optional(),
-  removePrices: z.array(z.string()).optional(),
-  replacePrices: z.array(z.lazy(() => ReplacePrice$outboundSchema)).optional(),
+  prices: z.array(MintPlanLineRef$outboundSchema),
+  basedOnVersionId: z.string().optional(),
 });
 
 export function mintPlanVersionRequestToJSON(

package/src/models/operations/createexternalreference.ts

@@ -6,6 +6,9 @@ import * as z from "zod/v3";
 import * as models from "../index.js";
 
 export type CreateExternalReferenceRequest = {
+  /**
+   * Unique identifier for an organization
+   */
   merchantId: string;
   /**
    * The type of Paygentic entity this external reference points at

package/src/models/operations/createitem.ts

@@ -5,6 +5,9 @@
 import * as z from "zod/v3";
 
 export type CreateItemRequest = {
+  /**
+   * Unique identifier for an organization
+   */
   merchantId: string;
   /**
    * Canonical sellable name for the Item

package/src/models/operations/createplan.ts

@@ -99,9 +99,9 @@ export type CreatePlanRequest = {
    */
   name: string;
   /**
-   * Array of price IDs to associate with this plan
+   * The prices this plan starts with. An entry is either a price ID on its own, or an object that names a price ID and the key by which you address that line. A price ID on its own receives a generated key.
    */
-  prices?: Array<string> | undefined;
+  prices?: Array<models.PlanLineRef> | undefined;
   /**
    * Unique identifier for a product
    */
@@ -167,7 +167,7 @@ export type CreatePlanRequest$Outbound = {
   invoiceDisplayName?: string | undefined;
   merchantId: string;
   name: string;
-  prices?: Array<string> | undefined;
+  prices?: Array<models.PlanLineRef$Outbound> | undefined;
   productId: string;
   taxBehavior: string;
   renewalReminderEnabled: boolean;
@@ -193,7 +193,7 @@ export const CreatePlanRequest$outboundSchema: z.ZodType<
   invoiceDisplayName: z.string().optional(),
   merchantId: z.string(),
   name: z.string(),
-  prices: z.array(z.string()).optional(),
+  prices: z.array(models.PlanLineRef$outboundSchema).optional(),
   productId: z.string(),
   taxBehavior: CreatePlanTaxBehavior$outboundSchema.default("exclusive"),
   renewalReminderEnabled: z.boolean().default(true),

package/src/models/operations/createsubscription.ts

@@ -117,6 +117,10 @@ export type CreateSubscriptionRequest = {
    * Number of minutes until the payment session expires. Defaults to 240 minutes (4 hours) if not provided.
    */
   sessionExpiryMinutes?: number | undefined;
+  /**
+   * How the subscription follows new versions of its plan. `floating` follows the plan's default version: when the default changes, the subscription bills from the new default from its next billing period. `pinned` keeps the plan version that the subscription holds. A subscription created without a value is `floating`. A change to this value does not change a billing period that has already started.
+   */
+  versionPolicy?: models.SubscriptionVersionPolicy | undefined;
   /**
    * Free-form merchant metadata to attach to the subscription. Values must be strings, numbers, or booleans.
    */
@@ -215,6 +219,7 @@ export type CreateSubscriptionRequest$Outbound = {
   renewalReminderDays?: number | null | undefined;
   paymentTermDays?: number | undefined;
   sessionExpiryMinutes?: number | undefined;
+  versionPolicy?: string | undefined;
   metadata?: { [k: string]: models.SubscriptionMetadata$Outbound } | undefined;
 };
 
@@ -240,6 +245,7 @@ export const CreateSubscriptionRequest$outboundSchema: z.ZodType<
   renewalReminderDays: z.nullable(z.number().int()).optional(),
   paymentTermDays: z.number().int().optional(),
   sessionExpiryMinutes: z.number().optional(),
+  versionPolicy: models.SubscriptionVersionPolicy$outboundSchema.optional(),
   metadata: z.record(models.SubscriptionMetadata$outboundSchema).optional(),
 });
 

package/src/models/operations/editsubscriptionintervals.ts

@@ -0,0 +1,47 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import * as models from "../index.js";
+
+export type EditSubscriptionIntervalsRequest = {
+  /**
+   * The subscription ID
+   */
+  id: string;
+  editSubscriptionIntervalsRequest: models.EditSubscriptionIntervalsRequest;
+};
+
+/** @internal */
+export type EditSubscriptionIntervalsRequest$Outbound = {
+  id: string;
+  EditSubscriptionIntervalsRequest:
+    models.EditSubscriptionIntervalsRequest$Outbound;
+};
+
+/** @internal */
+export const EditSubscriptionIntervalsRequest$outboundSchema: z.ZodType<
+  EditSubscriptionIntervalsRequest$Outbound,
+  z.ZodTypeDef,
+  EditSubscriptionIntervalsRequest
+> = z.object({
+  id: z.string(),
+  editSubscriptionIntervalsRequest:
+    models.EditSubscriptionIntervalsRequest$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    editSubscriptionIntervalsRequest: "EditSubscriptionIntervalsRequest",
+  });
+});
+
+export function editSubscriptionIntervalsRequestToJSON(
+  editSubscriptionIntervalsRequest: EditSubscriptionIntervalsRequest,
+): string {
+  return JSON.stringify(
+    EditSubscriptionIntervalsRequest$outboundSchema.parse(
+      editSubscriptionIntervalsRequest,
+    ),
+  );
+}

package/src/models/operations/getrevenue.ts

@@ -31,6 +31,18 @@ export const GroupBy = {
  */
 export type GroupBy = ClosedEnum<typeof GroupBy>;
 
+/**
+ * Which date places revenue inside the window. 'issued' (default) counts whole invoices by their issue date, the basis revenue is recognised on. 'billingPeriod' counts invoice lines by the start of the period each line bills, so a window covering one billing period returns that period's charges, whichever invoices carry them: this month's advance fee and this month's arrears usage. Paid, outstanding and written-off follow each line's invoice; a refund splits across its invoice's lines by subtotal; payments not tied to an invoice are excluded because they bill no period.
+ */
+export const PeriodBasis = {
+  Issued: "issued",
+  BillingPeriod: "billingPeriod",
+} as const;
+/**
+ * Which date places revenue inside the window. 'issued' (default) counts whole invoices by their issue date, the basis revenue is recognised on. 'billingPeriod' counts invoice lines by the start of the period each line bills, so a window covering one billing period returns that period's charges, whichever invoices carry them: this month's advance fee and this month's arrears usage. Paid, outstanding and written-off follow each line's invoice; a refund splits across its invoice's lines by subtotal; payments not tied to an invoice are excluded because they bill no period.
+ */
+export type PeriodBasis = ClosedEnum<typeof PeriodBasis>;
+
 export type GetRevenueRequest = {
   /**
    * Start of the time range (ISO 8601 format)
@@ -64,6 +76,10 @@ export type GetRevenueRequest = {
    * Group invoice data by dimension. Allowed values: 'plan' (max 5 groups, top 4 + 'other' when exceeding), 'customer' (max 25 groups, top 24 + 'other' when exceeding, sorted by revenue descending), 'currency' (one entry per currency, primary currency first then alphabetical). Note: groupBy values are mutually exclusive — combining them returns a 400 error. When groupBy=currency is active, top-level netRevenue, invoices, and payments fields are omitted; currencyBreakdown is the sole data source.
    */
   groupBy?: GroupBy | undefined;
+  /**
+   * Which date places revenue inside the window. 'issued' (default) counts whole invoices by their issue date, the basis revenue is recognised on. 'billingPeriod' counts invoice lines by the start of the period each line bills, so a window covering one billing period returns that period's charges, whichever invoices carry them: this month's advance fee and this month's arrears usage. Paid, outstanding and written-off follow each line's invoice; a refund splits across its invoice's lines by subtotal; payments not tied to an invoice are excluded because they bill no period.
+   */
+  periodBasis?: PeriodBasis | undefined;
 };
 
 /** @internal */
@@ -75,6 +91,10 @@ export const GetRevenueBucketWidth$outboundSchema: z.ZodNativeEnum<
 export const GroupBy$outboundSchema: z.ZodNativeEnum<typeof GroupBy> = z
   .nativeEnum(GroupBy);
 
+/** @internal */
+export const PeriodBasis$outboundSchema: z.ZodNativeEnum<typeof PeriodBasis> = z
+  .nativeEnum(PeriodBasis);
+
 /** @internal */
 export type GetRevenueRequest$Outbound = {
   startTime: string;
@@ -85,6 +105,7 @@ export type GetRevenueRequest$Outbound = {
   subscriptionIds?: Array<string> | undefined;
   currency?: string | undefined;
   groupBy?: string | undefined;
+  periodBasis: string;
 };
 
 /** @internal */
@@ -101,6 +122,7 @@ export const GetRevenueRequest$outboundSchema: z.ZodType<
   subscriptionIds: z.array(z.string()).optional(),
   currency: z.string().optional(),
   groupBy: GroupBy$outboundSchema.optional(),
+  periodBasis: PeriodBasis$outboundSchema.default("issued"),
 });
 
 export function getRevenueRequestToJSON(

package/src/models/operations/getsubscriptionintervals.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+
+export type GetSubscriptionIntervalsRequest = {
+  /**
+   * The subscription ID
+   */
+  id: string;
+};
+
+/** @internal */
+export type GetSubscriptionIntervalsRequest$Outbound = {
+  id: string;
+};
+
+/** @internal */
+export const GetSubscriptionIntervalsRequest$outboundSchema: z.ZodType<
+  GetSubscriptionIntervalsRequest$Outbound,
+  z.ZodTypeDef,
+  GetSubscriptionIntervalsRequest
+> = z.object({
+  id: z.string(),
+});
+
+export function getSubscriptionIntervalsRequestToJSON(
+  getSubscriptionIntervalsRequest: GetSubscriptionIntervalsRequest,
+): string {
+  return JSON.stringify(
+    GetSubscriptionIntervalsRequest$outboundSchema.parse(
+      getSubscriptionIntervalsRequest,
+    ),
+  );
+}

package/src/models/operations/index.ts

@@ -41,6 +41,7 @@ export * from "./deletesubscriptionadjustment.js";
 export * from "./deletetestclock.js";
 export * from "./disconnectmerchantintegration.js";
 export * from "./downloadinvoicepdf.js";
+export * from "./editsubscriptionintervals.js";
 export * from "./generateportallink.js";
 export * from "./generatescheduleinvoices.js";
 export * from "./getapproval.js";
@@ -71,6 +72,7 @@ export * from "./getrevenue.js";
 export * from "./getsource.js";
 export * from "./getsourcerule.js";
 export * from "./getsubscription.js";
+export * from "./getsubscriptionintervals.js";
 export * from "./gettestclock.js";
 export * from "./getuser.js";
 export * from "./ingestevent.js";

package/src/models/operations/listbillingschedules.ts

@@ -32,7 +32,7 @@ export type ListBillingSchedulesObject = ClosedEnum<
  */
 export type ListBillingSchedulesResponse = {
   object: ListBillingSchedulesObject;
-  data: Array<models.SchemasBillingSchedule>;
+  data: Array<models.BillingSchedule>;
   /**
    * Offset-based pagination response.
    */
@@ -77,7 +77,7 @@ export const ListBillingSchedulesResponse$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   object: ListBillingSchedulesObject$inboundSchema,
-  data: z.array(models.SchemasBillingSchedule$inboundSchema),
+  data: z.array(models.BillingSchedule$inboundSchema),
   pagination: models.OffsetPagination$inboundSchema,
 });
 

package/src/models/operations/listpaymentsessions.ts

@@ -84,7 +84,7 @@ export type ListPaymentSessionsObject = ClosedEnum<
  */
 export type ListPaymentSessionsResponse = {
   object: ListPaymentSessionsObject;
-  data: Array<models.SchemasPaymentSession>;
+  data: Array<models.PaymentSession>;
   /**
    * Offset-based pagination response.
    */
@@ -146,7 +146,7 @@ export const ListPaymentSessionsResponse$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   object: ListPaymentSessionsObject$inboundSchema,
-  data: z.array(models.SchemasPaymentSession$inboundSchema),
+  data: z.array(models.PaymentSession$inboundSchema),
   pagination: models.OffsetPagination$inboundSchema,
 });
 

package/src/models/operations/listprices.ts

@@ -37,7 +37,7 @@ export type ListPricesPagination = {
  * List of prices
  */
 export type ListPricesResponse = {
-  data?: Array<models.SchemasPrice> | undefined;
+  data?: Array<models.Price> | undefined;
   pagination?: ListPricesPagination | undefined;
 };
 
@@ -96,7 +96,7 @@ export const ListPricesResponse$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  data: z.array(models.SchemasPrice$inboundSchema).optional(),
+  data: z.array(models.Price$inboundSchema).optional(),
   pagination: z.lazy(() => ListPricesPagination$inboundSchema).optional(),
 });
 

package/src/models/operations/updatesubscription.ts

@@ -5,6 +5,7 @@
 import * as z from "zod/v3";
 import { remap as remap$ } from "../../lib/primitives.js";
 import { ClosedEnum } from "../../types/enums.js";
+import * as models from "../index.js";
 
 export const UpdateSubscriptionStatus = {
   Active: "active",
@@ -55,6 +56,10 @@ export type UpdateSubscriptionRequestBody = {
    * Payment term in days ("Net X") applied to subsequently generated invoices: invoice dueAt = invoice issue date + paymentTermDays. A non-zero value is only valid alongside bankTransferOnly=true. Set 0 for "due on issue". Already-issued invoices keep their snapshotted dueAt.
    */
   paymentTermDays?: number | undefined;
+  /**
+   * How the subscription follows new versions of its plan. `floating` follows the plan's default version: when the default changes, the subscription bills from the new default from its next billing period. `pinned` keeps the plan version that the subscription holds. A subscription created without a value is `floating`. A change to this value does not change a billing period that has already started.
+   */
+  versionPolicy?: models.SubscriptionVersionPolicy | undefined;
 };
 
 export type UpdateSubscriptionRequest = {
@@ -80,6 +85,7 @@ export type UpdateSubscriptionRequestBody$Outbound = {
   renewalReminderEnabled?: boolean | null | undefined;
   renewalReminderDays?: number | null | undefined;
   paymentTermDays?: number | undefined;
+  versionPolicy?: string | undefined;
 };
 
 /** @internal */
@@ -99,6 +105,7 @@ export const UpdateSubscriptionRequestBody$outboundSchema: z.ZodType<
   renewalReminderEnabled: z.nullable(z.boolean()).optional(),
   renewalReminderDays: z.nullable(z.number().int()).optional(),
   paymentTermDays: z.number().int().optional(),
+  versionPolicy: models.SubscriptionVersionPolicy$outboundSchema.optional(),
 });
 
 export function updateSubscriptionRequestBodyToJSON(

package/src/models/order.ts

@@ -6,11 +6,11 @@ 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 {
-  BillingSchedule,
-  BillingSchedule$inboundSchema,
-} from "./billingschedule.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import {
+  OrderBillingSchedule,
+  OrderBillingSchedule$inboundSchema,
+} from "./orderbillingschedule.js";
 import { OrderLineItem, OrderLineItem$inboundSchema } from "./orderlineitem.js";
 
 export const OrderObject = {
@@ -55,7 +55,7 @@ export type Order = {
   defaultPaymentTermDays: number;
   metadata: { [k: string]: any };
   lineItems: Array<OrderLineItem>;
-  billingSchedules: Array<BillingSchedule>;
+  billingSchedules: Array<OrderBillingSchedule>;
   createdAt: Date;
   updatedAt: Date;
 };
@@ -102,7 +102,7 @@ export const Order$inboundSchema: z.ZodType<Order, z.ZodTypeDef, unknown> = z
     defaultPaymentTermDays: z.number().int(),
     metadata: z.record(z.any()),
     lineItems: z.array(OrderLineItem$inboundSchema),
-    billingSchedules: z.array(BillingSchedule$inboundSchema),
+    billingSchedules: z.array(OrderBillingSchedule$inboundSchema),
     createdAt: z.string().datetime({ offset: true }).transform(v =>
       new Date(v)
     ),

package/src/models/orderapproval.ts

@@ -0,0 +1,81 @@
+/*
+ * 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 OrderApprovalObject = {
+  Approval: "approval",
+} as const;
+export type OrderApprovalObject = ClosedEnum<typeof OrderApprovalObject>;
+
+export const OrderApprovalDecision = {
+  Pending: "pending",
+  Approved: "approved",
+  Rejected: "rejected",
+  Cancelled: "cancelled",
+} as const;
+export type OrderApprovalDecision = ClosedEnum<typeof OrderApprovalDecision>;
+
+export type OrderApproval = {
+  id: string;
+  object: OrderApprovalObject;
+  merchantId: string;
+  resourceType: string;
+  resourceId: string;
+  kind: string;
+  decision: OrderApprovalDecision;
+  requester: string;
+  reviewer?: string | null | undefined;
+  note?: string | null | undefined;
+  dataSnapshotHash: string;
+  decidedAt?: Date | null | undefined;
+  createdAt: Date;
+};
+
+/** @internal */
+export const OrderApprovalObject$inboundSchema: z.ZodNativeEnum<
+  typeof OrderApprovalObject
+> = z.nativeEnum(OrderApprovalObject);
+
+/** @internal */
+export const OrderApprovalDecision$inboundSchema: z.ZodNativeEnum<
+  typeof OrderApprovalDecision
+> = z.nativeEnum(OrderApprovalDecision);
+
+/** @internal */
+export const OrderApproval$inboundSchema: z.ZodType<
+  OrderApproval,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  object: OrderApprovalObject$inboundSchema,
+  merchantId: z.string(),
+  resourceType: z.string(),
+  resourceId: z.string(),
+  kind: z.string(),
+  decision: OrderApprovalDecision$inboundSchema,
+  requester: z.string(),
+  reviewer: z.nullable(z.string()).optional(),
+  note: z.nullable(z.string()).optional(),
+  dataSnapshotHash: z.string(),
+  decidedAt: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ).optional(),
+  createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+});
+
+export function orderApprovalFromJSON(
+  jsonString: string,
+): SafeParseResult<OrderApproval, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => OrderApproval$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'OrderApproval' from JSON`,
+  );
+}