@moovio/sdk 26.7.0-dev.2 → 26.7.0-dev.4

package/src/models/components/amountdetails.ts

@@ -0,0 +1,64 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  AmountDecimal,
+  AmountDecimal$inboundSchema,
+  AmountDecimal$Outbound,
+  AmountDecimal$outboundSchema,
+} from "./amountdecimal.js";
+
+export type AmountDetails = {
+  /**
+   * The amount of tax applied to the invoice.
+   */
+  tax?: AmountDecimal | undefined;
+  /**
+   * The amount of surcharge applied to the invoice.
+   */
+  surcharge?: AmountDecimal | undefined;
+};
+
+/** @internal */
+export const AmountDetails$inboundSchema: z.ZodType<
+  AmountDetails,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  tax: types.optional(AmountDecimal$inboundSchema),
+  surcharge: types.optional(AmountDecimal$inboundSchema),
+});
+/** @internal */
+export type AmountDetails$Outbound = {
+  tax?: AmountDecimal$Outbound | undefined;
+  surcharge?: AmountDecimal$Outbound | undefined;
+};
+
+/** @internal */
+export const AmountDetails$outboundSchema: z.ZodType<
+  AmountDetails$Outbound,
+  z.ZodTypeDef,
+  AmountDetails
+> = z.object({
+  tax: AmountDecimal$outboundSchema.optional(),
+  surcharge: AmountDecimal$outboundSchema.optional(),
+});
+
+export function amountDetailsToJSON(amountDetails: AmountDetails): string {
+  return JSON.stringify(AmountDetails$outboundSchema.parse(amountDetails));
+}
+export function amountDetailsFromJSON(
+  jsonString: string,
+): SafeParseResult<AmountDetails, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AmountDetails$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AmountDetails' from JSON`,
+  );
+}

package/src/models/components/amountdetailsupdate.ts

@@ -0,0 +1,68 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  AmountDecimalUpdate,
+  AmountDecimalUpdate$inboundSchema,
+  AmountDecimalUpdate$Outbound,
+  AmountDecimalUpdate$outboundSchema,
+} from "./amountdecimalupdate.js";
+
+export type AmountDetailsUpdate = {
+  /**
+   * The amount of tax applied to the invoice.
+   */
+  tax?: AmountDecimalUpdate | undefined;
+  /**
+   * The amount of surcharge applied to the invoice.
+   */
+  surcharge?: AmountDecimalUpdate | undefined;
+};
+
+/** @internal */
+export const AmountDetailsUpdate$inboundSchema: z.ZodType<
+  AmountDetailsUpdate,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  tax: types.optional(AmountDecimalUpdate$inboundSchema),
+  surcharge: types.optional(AmountDecimalUpdate$inboundSchema),
+});
+/** @internal */
+export type AmountDetailsUpdate$Outbound = {
+  tax?: AmountDecimalUpdate$Outbound | undefined;
+  surcharge?: AmountDecimalUpdate$Outbound | undefined;
+};
+
+/** @internal */
+export const AmountDetailsUpdate$outboundSchema: z.ZodType<
+  AmountDetailsUpdate$Outbound,
+  z.ZodTypeDef,
+  AmountDetailsUpdate
+> = z.object({
+  tax: AmountDecimalUpdate$outboundSchema.optional(),
+  surcharge: AmountDecimalUpdate$outboundSchema.optional(),
+});
+
+export function amountDetailsUpdateToJSON(
+  amountDetailsUpdate: AmountDetailsUpdate,
+): string {
+  return JSON.stringify(
+    AmountDetailsUpdate$outboundSchema.parse(amountDetailsUpdate),
+  );
+}
+export function amountDetailsUpdateFromJSON(
+  jsonString: string,
+): SafeParseResult<AmountDetailsUpdate, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AmountDetailsUpdate$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AmountDetailsUpdate' from JSON`,
+  );
+}

package/src/models/components/amountdetailsvalidationerror.ts

@@ -0,0 +1,58 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type AmountDetailsValidationError = {
+  tax?: string | undefined;
+  surcharge?: string | undefined;
+};
+
+/** @internal */
+export const AmountDetailsValidationError$inboundSchema: z.ZodType<
+  AmountDetailsValidationError,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  tax: types.optional(types.string()),
+  surcharge: types.optional(types.string()),
+});
+/** @internal */
+export type AmountDetailsValidationError$Outbound = {
+  tax?: string | undefined;
+  surcharge?: string | undefined;
+};
+
+/** @internal */
+export const AmountDetailsValidationError$outboundSchema: z.ZodType<
+  AmountDetailsValidationError$Outbound,
+  z.ZodTypeDef,
+  AmountDetailsValidationError
+> = z.object({
+  tax: z.string().optional(),
+  surcharge: z.string().optional(),
+});
+
+export function amountDetailsValidationErrorToJSON(
+  amountDetailsValidationError: AmountDetailsValidationError,
+): string {
+  return JSON.stringify(
+    AmountDetailsValidationError$outboundSchema.parse(
+      amountDetailsValidationError,
+    ),
+  );
+}
+export function amountDetailsValidationErrorFromJSON(
+  jsonString: string,
+): SafeParseResult<AmountDetailsValidationError, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AmountDetailsValidationError$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AmountDetailsValidationError' from JSON`,
+  );
+}

package/src/models/components/asynccreatedrefund.ts

@@ -13,6 +13,12 @@ import {
   Amount$Outbound,
   Amount$outboundSchema,
 } from "./amount.js";
+import {
+  RefundAmountDetails,
+  RefundAmountDetails$inboundSchema,
+  RefundAmountDetails$Outbound,
+  RefundAmountDetails$outboundSchema,
+} from "./refundamountdetails.js";
 
 /**
  * Asynchronous refund response
@@ -21,6 +27,7 @@ export type AsyncCreatedRefund = {
   refundID: string;
   createdOn: Date;
   amount: Amount;
+  amountDetails?: RefundAmountDetails | undefined;
 };
 
 /** @internal */
@@ -32,12 +39,14 @@ export const AsyncCreatedRefund$inboundSchema: z.ZodType<
   refundID: types.string(),
   createdOn: types.date(),
   amount: Amount$inboundSchema,
+  amountDetails: types.optional(RefundAmountDetails$inboundSchema),
 });
 /** @internal */
 export type AsyncCreatedRefund$Outbound = {
   refundID: string;
   createdOn: string;
   amount: Amount$Outbound;
+  amountDetails?: RefundAmountDetails$Outbound | undefined;
 };
 
 /** @internal */
@@ -49,6 +58,7 @@ export const AsyncCreatedRefund$outboundSchema: z.ZodType<
   refundID: z.string(),
   createdOn: z.date().transform(v => v.toISOString()),
   amount: Amount$outboundSchema,
+  amountDetails: RefundAmountDetails$outboundSchema.optional(),
 });
 
 export function asyncCreatedRefundToJSON(

package/src/models/components/capability.ts

@@ -30,7 +30,13 @@ export type Capability = {
    *
    * @remarks
    *
-   * The `production-app`, `platform.production-app`, and / or `platform.wallet-transfers` capabilities might appear in your list. These are read-only capabilities that Moov requests and uses for account verification purposes. These capabilities remains active with your account and require no additional action.
+   * **Deprecated capabilities**
+   *
+   * The `send-funds`, `collect-funds`, and `wallet` capability IDs are deprecated. Request granular capabilities instead (for example, `send-funds.ach`, `collect-funds.card-payments`, or `wallet.balance`). Deprecated values will be removed in a future API version.
+   *
+   * Read our [capabilities reference](https://docs.moov.io/guides/accounts/capabilities/reference/) to choose the right capabilities for your integration.
+   *
+   * The `production-app`, `platform.production-app`, and / or `platform.wallet-transfers` capabilities might appear in the list for your Partner account. These are read-only capabilities that Moov requests. These capabilities remain active with your account and require no additional action.
    */
   capability: CapabilityID;
   accountID: string;

package/src/models/components/capabilityid.ts

@@ -11,7 +11,13 @@ import { OpenEnum } from "../../types/enums.js";
  *
  * @remarks
  *
- * The `production-app`, `platform.production-app`, and / or `platform.wallet-transfers` capabilities might appear in your list. These are read-only capabilities that Moov requests and uses for account verification purposes. These capabilities remains active with your account and require no additional action.
+ * **Deprecated capabilities**
+ *
+ * The `send-funds`, `collect-funds`, and `wallet` capability IDs are deprecated. Request granular capabilities instead (for example, `send-funds.ach`, `collect-funds.card-payments`, or `wallet.balance`). Deprecated values will be removed in a future API version.
+ *
+ * Read our [capabilities reference](https://docs.moov.io/guides/accounts/capabilities/reference/) to choose the right capabilities for your integration.
+ *
+ * The `production-app`, `platform.production-app`, and / or `platform.wallet-transfers` capabilities might appear in the list for your Partner account. These are read-only capabilities that Moov requests. These capabilities remain active with your account and require no additional action.
  */
 export const CapabilityID = {
   Transfers: "transfers",
@@ -37,7 +43,13 @@ export const CapabilityID = {
  *
  * @remarks
  *
- * The `production-app`, `platform.production-app`, and / or `platform.wallet-transfers` capabilities might appear in your list. These are read-only capabilities that Moov requests and uses for account verification purposes. These capabilities remains active with your account and require no additional action.
+ * **Deprecated capabilities**
+ *
+ * The `send-funds`, `collect-funds`, and `wallet` capability IDs are deprecated. Request granular capabilities instead (for example, `send-funds.ach`, `collect-funds.card-payments`, or `wallet.balance`). Deprecated values will be removed in a future API version.
+ *
+ * Read our [capabilities reference](https://docs.moov.io/guides/accounts/capabilities/reference/) to choose the right capabilities for your integration.
+ *
+ * The `production-app`, `platform.production-app`, and / or `platform.wallet-transfers` capabilities might appear in the list for your Partner account. These are read-only capabilities that Moov requests. These capabilities remain active with your account and require no additional action.
  */
 export type CapabilityID = OpenEnum<typeof CapabilityID>;
 

package/src/models/components/cardacquiringrefund.ts

@@ -13,6 +13,12 @@ import {
   Amount$Outbound,
   Amount$outboundSchema,
 } from "./amount.js";
+import {
+  RefundAmountDetails,
+  RefundAmountDetails$inboundSchema,
+  RefundAmountDetails$Outbound,
+  RefundAmountDetails$outboundSchema,
+} from "./refundamountdetails.js";
 import {
   RefundCardDetails,
   RefundCardDetails$inboundSchema,
@@ -37,6 +43,7 @@ export type CardAcquiringRefund = {
   updatedOn: Date;
   status: RefundStatus;
   amount: Amount;
+  amountDetails?: RefundAmountDetails | undefined;
   cardDetails?: RefundCardDetails | undefined;
 };
 
@@ -51,6 +58,7 @@ export const CardAcquiringRefund$inboundSchema: z.ZodType<
   updatedOn: types.date(),
   status: RefundStatus$inboundSchema,
   amount: Amount$inboundSchema,
+  amountDetails: types.optional(RefundAmountDetails$inboundSchema),
   cardDetails: types.optional(RefundCardDetails$inboundSchema),
 });
 /** @internal */
@@ -60,6 +68,7 @@ export type CardAcquiringRefund$Outbound = {
   updatedOn: string;
   status: string;
   amount: Amount$Outbound;
+  amountDetails?: RefundAmountDetails$Outbound | undefined;
   cardDetails?: RefundCardDetails$Outbound | undefined;
 };
 
@@ -74,6 +83,7 @@ export const CardAcquiringRefund$outboundSchema: z.ZodType<
   updatedOn: z.date().transform(v => v.toISOString()),
   status: RefundStatus$outboundSchema,
   amount: Amount$outboundSchema,
+  amountDetails: RefundAmountDetails$outboundSchema.optional(),
   cardDetails: RefundCardDetails$outboundSchema.optional(),
 });
 

package/src/models/components/createaccount.ts

@@ -66,6 +66,15 @@ export type CreateAccount = {
    * User provided settings to manage an account.
    */
   settings?: Settings | undefined;
+  /**
+   * Capabilities to request when the account is created. Request granular capability IDs that match your use case.
+   *
+   * @remarks
+   *
+   * Read our [capabilities reference](https://docs.moov.io/guides/accounts/capabilities/reference/) to choose the right capabilities for your integration.
+   *
+   * The `send-funds`, `collect-funds`, and `wallet` capability IDs are deprecated. Use granular values such as `send-funds.ach`, `collect-funds.card-payments`, or `wallet.balance` instead.
+   */
   capabilities?: Array<CapabilityID> | undefined;
   /**
    * The operating mode for an account.

package/src/models/components/createinvoice.ts

@@ -8,11 +8,11 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import * as types from "../../types/primitives.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 import {
-  AmountDecimal,
-  AmountDecimal$inboundSchema,
-  AmountDecimal$Outbound,
-  AmountDecimal$outboundSchema,
-} from "./amountdecimal.js";
+  AmountDetails,
+  AmountDetails$inboundSchema,
+  AmountDetails$Outbound,
+  AmountDetails$outboundSchema,
+} from "./amountdetails.js";
 import {
   CreateInvoiceLineItems,
   CreateInvoiceLineItems$inboundSchema,
@@ -32,7 +32,7 @@ export type CreateInvoice = {
   lineItems: CreateInvoiceLineItems;
   invoiceDate?: Date | undefined;
   dueDate?: Date | undefined;
-  taxAmount?: AmountDecimal | undefined;
+  amountDetails?: AmountDetails | undefined;
 };
 
 /** @internal */
@@ -46,7 +46,7 @@ export const CreateInvoice$inboundSchema: z.ZodType<
   lineItems: CreateInvoiceLineItems$inboundSchema,
   invoiceDate: types.optional(types.date()),
   dueDate: types.optional(types.date()),
-  taxAmount: types.optional(AmountDecimal$inboundSchema),
+  amountDetails: types.optional(AmountDetails$inboundSchema),
 });
 /** @internal */
 export type CreateInvoice$Outbound = {
@@ -55,7 +55,7 @@ export type CreateInvoice$Outbound = {
   lineItems: CreateInvoiceLineItems$Outbound;
   invoiceDate?: string | undefined;
   dueDate?: string | undefined;
-  taxAmount?: AmountDecimal$Outbound | undefined;
+  amountDetails?: AmountDetails$Outbound | undefined;
 };
 
 /** @internal */
@@ -69,7 +69,7 @@ export const CreateInvoice$outboundSchema: z.ZodType<
   lineItems: CreateInvoiceLineItems$outboundSchema,
   invoiceDate: z.date().transform(v => v.toISOString()).optional(),
   dueDate: z.date().transform(v => v.toISOString()).optional(),
-  taxAmount: AmountDecimal$outboundSchema.optional(),
+  amountDetails: AmountDetails$outboundSchema.optional(),
 });
 
 export function createInvoiceToJSON(createInvoice: CreateInvoice): string {

package/src/models/components/createpaymentlink.ts

@@ -25,6 +25,12 @@ import {
   CreatePaymentLinkLineItems$Outbound,
   CreatePaymentLinkLineItems$outboundSchema,
 } from "./createpaymentlinklineitems.js";
+import {
+  PaymentLinkCustomAmountPaymentDetails,
+  PaymentLinkCustomAmountPaymentDetails$inboundSchema,
+  PaymentLinkCustomAmountPaymentDetails$Outbound,
+  PaymentLinkCustomAmountPaymentDetails$outboundSchema,
+} from "./paymentlinkcustomamountpaymentdetails.js";
 import {
   PaymentLinkCustomerOptions,
   PaymentLinkCustomerOptions$inboundSchema,
@@ -55,7 +61,7 @@ import {
  *
  * @remarks
  *
- * A payment link must include either `payment` or `payout` details, but not both. For payout payment links,
+ * A payment link must include exactly one of `payment`, `payout`, or `customAmountPayment` details. For payout payment links,
  * `maxUses` will automatically be set to 1, as these are intended for a one-time disbursement
  * to a specific recipient.
  */
@@ -75,8 +81,8 @@ export type CreatePaymentLink = {
    *
    * In API versions before `2026.07.00`, this was a required field.
    *
-   * In API version `2026.07.00` and beyond, this field is required for `fixed` payment amount types and omitted
-   * for `open` payment amount types.
+   * In API version `2026.07.00` and beyond, this field is required for `payment` and `payout` links and must be
+   * omitted for `customAmountPayment` links, where the payor chooses the amount.
    */
   amount?: Amount | undefined;
   /**
@@ -101,6 +107,10 @@ export type CreatePaymentLink = {
    */
   payment?: PaymentLinkPaymentDetails | undefined;
   payout?: PaymentLinkPayoutDetails | undefined;
+  /**
+   * Options for a custom amount payment link. Mutually exclusive with `payment` and `payout`.
+   */
+  customAmountPayment?: PaymentLinkCustomAmountPaymentDetails | undefined;
   /**
    * An optional collection of line items for a payment link.
    *
@@ -126,6 +136,9 @@ export const CreatePaymentLink$inboundSchema: z.ZodType<
   customer: types.optional(PaymentLinkCustomerOptions$inboundSchema),
   payment: types.optional(PaymentLinkPaymentDetails$inboundSchema),
   payout: types.optional(PaymentLinkPayoutDetails$inboundSchema),
+  customAmountPayment: types.optional(
+    PaymentLinkCustomAmountPaymentDetails$inboundSchema,
+  ),
   lineItems: types.optional(CreatePaymentLinkLineItems$inboundSchema),
   amountDetails: types.optional(CreatePaymentLinkAmountDetails$inboundSchema),
 });
@@ -140,6 +153,9 @@ export type CreatePaymentLink$Outbound = {
   customer?: PaymentLinkCustomerOptions$Outbound | undefined;
   payment?: PaymentLinkPaymentDetails$Outbound | undefined;
   payout?: PaymentLinkPayoutDetails$Outbound | undefined;
+  customAmountPayment?:
+    | PaymentLinkCustomAmountPaymentDetails$Outbound
+    | undefined;
   lineItems?: CreatePaymentLinkLineItems$Outbound | undefined;
   amountDetails?: CreatePaymentLinkAmountDetails$Outbound | undefined;
 };
@@ -159,6 +175,8 @@ export const CreatePaymentLink$outboundSchema: z.ZodType<
   customer: PaymentLinkCustomerOptions$outboundSchema.optional(),
   payment: PaymentLinkPaymentDetails$outboundSchema.optional(),
   payout: PaymentLinkPayoutDetails$outboundSchema.optional(),
+  customAmountPayment: PaymentLinkCustomAmountPaymentDetails$outboundSchema
+    .optional(),
   lineItems: CreatePaymentLinkLineItems$outboundSchema.optional(),
   amountDetails: CreatePaymentLinkAmountDetails$outboundSchema.optional(),
 });

package/src/models/components/createpaymentlinkamountdetails.ts

@@ -19,6 +19,10 @@ export type CreatePaymentLinkAmountDetails = {
    * The amount of tax applied to the payment link.
    */
   tax?: AmountDecimal | undefined;
+  /**
+   * The amount of surcharge applied to the payment link.
+   */
+  surcharge?: AmountDecimal | undefined;
 };
 
 /** @internal */
@@ -28,10 +32,12 @@ export const CreatePaymentLinkAmountDetails$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   tax: types.optional(AmountDecimal$inboundSchema),
+  surcharge: types.optional(AmountDecimal$inboundSchema),
 });
 /** @internal */
 export type CreatePaymentLinkAmountDetails$Outbound = {
   tax?: AmountDecimal$Outbound | undefined;
+  surcharge?: AmountDecimal$Outbound | undefined;
 };
 
 /** @internal */
@@ -41,6 +47,7 @@ export const CreatePaymentLinkAmountDetails$outboundSchema: z.ZodType<
   CreatePaymentLinkAmountDetails
 > = z.object({
   tax: AmountDecimal$outboundSchema.optional(),
+  surcharge: AmountDecimal$outboundSchema.optional(),
 });
 
 export function createPaymentLinkAmountDetailsToJSON(

package/src/models/components/createpaymentlinkamountdetailsvalidationerror.ts

@@ -10,6 +10,7 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type CreatePaymentLinkAmountDetailsValidationError = {
   tax?: string | undefined;
+  surcharge?: string | undefined;
 };
 
 /** @internal */
@@ -20,10 +21,12 @@ export const CreatePaymentLinkAmountDetailsValidationError$inboundSchema:
     unknown
   > = z.object({
     tax: types.optional(types.string()),
+    surcharge: types.optional(types.string()),
   });
 /** @internal */
 export type CreatePaymentLinkAmountDetailsValidationError$Outbound = {
   tax?: string | undefined;
+  surcharge?: string | undefined;
 };
 
 /** @internal */
@@ -34,6 +37,7 @@ export const CreatePaymentLinkAmountDetailsValidationError$outboundSchema:
     CreatePaymentLinkAmountDetailsValidationError
   > = z.object({
     tax: z.string().optional(),
+    surcharge: z.string().optional(),
   });
 
 export function createPaymentLinkAmountDetailsValidationErrorToJSON(

package/src/models/components/createrefund.ts

@@ -7,6 +7,12 @@ import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import * as types from "../../types/primitives.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  RefundAmountDetails,
+  RefundAmountDetails$inboundSchema,
+  RefundAmountDetails$Outbound,
+  RefundAmountDetails$outboundSchema,
+} from "./refundamountdetails.js";
 
 /**
  * Specifies a partial amount to refund.
@@ -20,6 +26,10 @@ export type CreateRefund = {
    * Amount to refund in cents. If null, the original transfer's full amount will be refunded.
    */
   amount?: number | undefined;
+  /**
+   * Breakdown of the refunded amount.
+   */
+  amountDetails?: RefundAmountDetails | undefined;
 };
 
 /** @internal */
@@ -29,10 +39,12 @@ export const CreateRefund$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   amount: types.optional(types.number()),
+  amountDetails: types.optional(RefundAmountDetails$inboundSchema),
 });
 /** @internal */
 export type CreateRefund$Outbound = {
   amount?: number | undefined;
+  amountDetails?: RefundAmountDetails$Outbound | undefined;
 };
 
 /** @internal */
@@ -42,6 +54,7 @@ export const CreateRefund$outboundSchema: z.ZodType<
   CreateRefund
 > = z.object({
   amount: z.number().int().optional(),
+  amountDetails: RefundAmountDetails$outboundSchema.optional(),
 });
 
 export function createRefundToJSON(createRefund: CreateRefund): string {

package/src/models/components/createreversal.ts

@@ -7,12 +7,22 @@ import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import * as types from "../../types/primitives.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  ReversalAmountDetails,
+  ReversalAmountDetails$inboundSchema,
+  ReversalAmountDetails$Outbound,
+  ReversalAmountDetails$outboundSchema,
+} from "./reversalamountdetails.js";
 
 export type CreateReversal = {
   /**
    * Amount to reverse in cents. Partial amounts will automatically trigger a refund instead of a cancellation.
    */
   amount: number;
+  /**
+   * Breakdown of the reversed amount.
+   */
+  amountDetails?: ReversalAmountDetails | undefined;
 };
 
 /** @internal */
@@ -22,10 +32,12 @@ export const CreateReversal$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   amount: types.number(),
+  amountDetails: types.optional(ReversalAmountDetails$inboundSchema),
 });
 /** @internal */
 export type CreateReversal$Outbound = {
   amount: number;
+  amountDetails?: ReversalAmountDetails$Outbound | undefined;
 };
 
 /** @internal */
@@ -35,6 +47,7 @@ export const CreateReversal$outboundSchema: z.ZodType<
   CreateReversal
 > = z.object({
   amount: z.number().int(),
+  amountDetails: ReversalAmountDetails$outboundSchema.optional(),
 });
 
 export function createReversalToJSON(createReversal: CreateReversal): string {

package/src/models/components/createtransferamountdetails.ts

@@ -23,6 +23,10 @@ export type CreateTransferAmountDetails = {
    * The amount of tax applied to the transfer.
    */
   tax?: AmountDecimal | undefined;
+  /**
+   * The amount of surcharge applied to the transfer.
+   */
+  surcharge?: AmountDecimal | undefined;
 };
 
 /** @internal */
@@ -33,11 +37,13 @@ export const CreateTransferAmountDetails$inboundSchema: z.ZodType<
 > = z.object({
   tip: types.optional(AmountDecimal$inboundSchema),
   tax: types.optional(AmountDecimal$inboundSchema),
+  surcharge: types.optional(AmountDecimal$inboundSchema),
 });
 /** @internal */
 export type CreateTransferAmountDetails$Outbound = {
   tip?: AmountDecimal$Outbound | undefined;
   tax?: AmountDecimal$Outbound | undefined;
+  surcharge?: AmountDecimal$Outbound | undefined;
 };
 
 /** @internal */
@@ -48,6 +54,7 @@ export const CreateTransferAmountDetails$outboundSchema: z.ZodType<
 > = z.object({
   tip: AmountDecimal$outboundSchema.optional(),
   tax: AmountDecimal$outboundSchema.optional(),
+  surcharge: AmountDecimal$outboundSchema.optional(),
 });
 
 export function createTransferAmountDetailsToJSON(

package/src/models/components/createtransferamountdetailsvalidationerror.ts

@@ -11,6 +11,7 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 export type CreateTransferAmountDetailsValidationError = {
   tip?: string | undefined;
   tax?: string | undefined;
+  surcharge?: string | undefined;
 };
 
 /** @internal */
@@ -19,11 +20,13 @@ export const CreateTransferAmountDetailsValidationError$inboundSchema:
     z.object({
       tip: types.optional(types.string()),
       tax: types.optional(types.string()),
+      surcharge: types.optional(types.string()),
     });
 /** @internal */
 export type CreateTransferAmountDetailsValidationError$Outbound = {
   tip?: string | undefined;
   tax?: string | undefined;
+  surcharge?: string | undefined;
 };
 
 /** @internal */
@@ -35,6 +38,7 @@ export const CreateTransferAmountDetailsValidationError$outboundSchema:
   > = z.object({
     tip: z.string().optional(),
     tax: z.string().optional(),
+    surcharge: z.string().optional(),
   });
 
 export function createTransferAmountDetailsValidationErrorToJSON(