@moovio/sdk 0.0.0-dev.28 → 0.0.0-dev.29

package/src/models/components/cardpaymentrefundprocessingdetails.ts

@@ -0,0 +1,60 @@
+/*
+ * 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 {
+  CardTransactionFailureCode,
+  CardTransactionFailureCode$inboundSchema,
+  CardTransactionFailureCode$outboundSchema,
+} from "./cardtransactionfailurecode.js";
+
+export type CardPaymentRefundProcessingDetails = {
+  failureCode?: CardTransactionFailureCode | undefined;
+};
+
+/** @internal */
+export const CardPaymentRefundProcessingDetails$inboundSchema: z.ZodType<
+  CardPaymentRefundProcessingDetails,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  failureCode: types.optional(CardTransactionFailureCode$inboundSchema),
+});
+/** @internal */
+export type CardPaymentRefundProcessingDetails$Outbound = {
+  failureCode?: string | undefined;
+};
+
+/** @internal */
+export const CardPaymentRefundProcessingDetails$outboundSchema: z.ZodType<
+  CardPaymentRefundProcessingDetails$Outbound,
+  z.ZodTypeDef,
+  CardPaymentRefundProcessingDetails
+> = z.object({
+  failureCode: CardTransactionFailureCode$outboundSchema.optional(),
+});
+
+export function cardPaymentRefundProcessingDetailsToJSON(
+  cardPaymentRefundProcessingDetails: CardPaymentRefundProcessingDetails,
+): string {
+  return JSON.stringify(
+    CardPaymentRefundProcessingDetails$outboundSchema.parse(
+      cardPaymentRefundProcessingDetails,
+    ),
+  );
+}
+export function cardPaymentRefundProcessingDetailsFromJSON(
+  jsonString: string,
+): SafeParseResult<CardPaymentRefundProcessingDetails, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      CardPaymentRefundProcessingDetails$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CardPaymentRefundProcessingDetails' from JSON`,
+  );
+}

package/src/models/components/cardpaymenttransferprocessingdetails.ts

@@ -0,0 +1,72 @@
+/*
+ * 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 {
+  CardTransactionFailureCode,
+  CardTransactionFailureCode$inboundSchema,
+  CardTransactionFailureCode$outboundSchema,
+} from "./cardtransactionfailurecode.js";
+
+export type CardPaymentTransferProcessingDetails = {
+  authorizationCode?: string | undefined;
+  networkTransactionID?: string | undefined;
+  networkResponseCode?: string | undefined;
+  failureCode?: CardTransactionFailureCode | undefined;
+};
+
+/** @internal */
+export const CardPaymentTransferProcessingDetails$inboundSchema: z.ZodType<
+  CardPaymentTransferProcessingDetails,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  authorizationCode: types.optional(types.string()),
+  networkTransactionID: types.optional(types.string()),
+  networkResponseCode: types.optional(types.string()),
+  failureCode: types.optional(CardTransactionFailureCode$inboundSchema),
+});
+/** @internal */
+export type CardPaymentTransferProcessingDetails$Outbound = {
+  authorizationCode?: string | undefined;
+  networkTransactionID?: string | undefined;
+  networkResponseCode?: string | undefined;
+  failureCode?: string | undefined;
+};
+
+/** @internal */
+export const CardPaymentTransferProcessingDetails$outboundSchema: z.ZodType<
+  CardPaymentTransferProcessingDetails$Outbound,
+  z.ZodTypeDef,
+  CardPaymentTransferProcessingDetails
+> = z.object({
+  authorizationCode: z.string().optional(),
+  networkTransactionID: z.string().optional(),
+  networkResponseCode: z.string().optional(),
+  failureCode: CardTransactionFailureCode$outboundSchema.optional(),
+});
+
+export function cardPaymentTransferProcessingDetailsToJSON(
+  cardPaymentTransferProcessingDetails: CardPaymentTransferProcessingDetails,
+): string {
+  return JSON.stringify(
+    CardPaymentTransferProcessingDetails$outboundSchema.parse(
+      cardPaymentTransferProcessingDetails,
+    ),
+  );
+}
+export function cardPaymentTransferProcessingDetailsFromJSON(
+  jsonString: string,
+): SafeParseResult<CardPaymentTransferProcessingDetails, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      CardPaymentTransferProcessingDetails$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CardPaymentTransferProcessingDetails' from JSON`,
+  );
+}

package/src/models/components/createcancellation.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";
+import {
+  AmountDecimal,
+  AmountDecimal$inboundSchema,
+  AmountDecimal$Outbound,
+  AmountDecimal$outboundSchema,
+} from "./amountdecimal.js";
+
+export type CreateCancellation = {
+  amount?: AmountDecimal | undefined;
+};
+
+/** @internal */
+export const CreateCancellation$inboundSchema: z.ZodType<
+  CreateCancellation,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  amount: types.optional(AmountDecimal$inboundSchema),
+});
+/** @internal */
+export type CreateCancellation$Outbound = {
+  amount?: AmountDecimal$Outbound | undefined;
+};
+
+/** @internal */
+export const CreateCancellation$outboundSchema: z.ZodType<
+  CreateCancellation$Outbound,
+  z.ZodTypeDef,
+  CreateCancellation
+> = z.object({
+  amount: AmountDecimal$outboundSchema.optional(),
+});
+
+export function createCancellationToJSON(
+  createCancellation: CreateCancellation,
+): string {
+  return JSON.stringify(
+    CreateCancellation$outboundSchema.parse(createCancellation),
+  );
+}
+export function createCancellationFromJSON(
+  jsonString: string,
+): SafeParseResult<CreateCancellation, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreateCancellation$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateCancellation' from JSON`,
+  );
+}

package/src/models/components/createcapture.ts

@@ -0,0 +1,128 @@
+/*
+ * 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";
+import {
+  CreateTransferAmountDetails,
+  CreateTransferAmountDetails$inboundSchema,
+  CreateTransferAmountDetails$Outbound,
+  CreateTransferAmountDetails$outboundSchema,
+} from "./createtransferamountdetails.js";
+import {
+  CreateTransferLineItems,
+  CreateTransferLineItems$inboundSchema,
+  CreateTransferLineItems$Outbound,
+  CreateTransferLineItems$outboundSchema,
+} from "./createtransferlineitems.js";
+
+/**
+ * Request to capture funds against an authorized transfer.
+ */
+export type CreateCapture = {
+  /**
+   * Payment method of the merchant account to capture funds into. For card-acquiring transfers, this must be a moov-wallet payment method.
+   */
+  destinationPaymentMethodID: string;
+  /**
+   * Amount to capture. If omitted, the remaining authorized amount is captured.
+   */
+  amount?: AmountDecimal | undefined;
+  /**
+   * Indicates whether this is the final capture against the authorization. When `true`, any remaining authorized amount is voided.
+   */
+  isFinal?: boolean | undefined;
+  /**
+   * An optional description of the capture that is used on receipts and for your own internal use.
+   */
+  description?: string | undefined;
+  /**
+   * Free-form key-value pair list. Useful for storing information that is not captured elsewhere.
+   */
+  metadata?: { [k: string]: string } | undefined;
+  /**
+   * Optional alias from a foreign/external system which can be used to reference this resource.
+   */
+  foreignID?: string | undefined;
+  /**
+   * An optional collection of line items for a transfer.
+   *
+   * @remarks
+   * When line items are provided, their total plus tax must equal the transfer amount.
+   */
+  lineItems?: CreateTransferLineItems | undefined;
+  amountDetails?: CreateTransferAmountDetails | undefined;
+  /**
+   * The facilitator fee amount applied to the capture.
+   */
+  facilitatorFeeAmount?: AmountDecimal | undefined;
+};
+
+/** @internal */
+export const CreateCapture$inboundSchema: z.ZodType<
+  CreateCapture,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  destinationPaymentMethodID: types.string(),
+  amount: types.optional(AmountDecimal$inboundSchema),
+  isFinal: types.optional(types.boolean()),
+  description: types.optional(types.string()),
+  metadata: types.optional(z.record(types.string())),
+  foreignID: types.optional(types.string()),
+  lineItems: types.optional(CreateTransferLineItems$inboundSchema),
+  amountDetails: types.optional(CreateTransferAmountDetails$inboundSchema),
+  facilitatorFeeAmount: types.optional(AmountDecimal$inboundSchema),
+});
+/** @internal */
+export type CreateCapture$Outbound = {
+  destinationPaymentMethodID: string;
+  amount?: AmountDecimal$Outbound | undefined;
+  isFinal?: boolean | undefined;
+  description?: string | undefined;
+  metadata?: { [k: string]: string } | undefined;
+  foreignID?: string | undefined;
+  lineItems?: CreateTransferLineItems$Outbound | undefined;
+  amountDetails?: CreateTransferAmountDetails$Outbound | undefined;
+  facilitatorFeeAmount?: AmountDecimal$Outbound | undefined;
+};
+
+/** @internal */
+export const CreateCapture$outboundSchema: z.ZodType<
+  CreateCapture$Outbound,
+  z.ZodTypeDef,
+  CreateCapture
+> = z.object({
+  destinationPaymentMethodID: z.string(),
+  amount: AmountDecimal$outboundSchema.optional(),
+  isFinal: z.boolean().optional(),
+  description: z.string().optional(),
+  metadata: z.record(z.string()).optional(),
+  foreignID: z.string().optional(),
+  lineItems: CreateTransferLineItems$outboundSchema.optional(),
+  amountDetails: CreateTransferAmountDetails$outboundSchema.optional(),
+  facilitatorFeeAmount: AmountDecimal$outboundSchema.optional(),
+});
+
+export function createCaptureToJSON(createCapture: CreateCapture): string {
+  return JSON.stringify(CreateCapture$outboundSchema.parse(createCapture));
+}
+export function createCaptureFromJSON(
+  jsonString: string,
+): SafeParseResult<CreateCapture, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreateCapture$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateCapture' from JSON`,
+  );
+}

package/src/models/components/createdtransfer.ts

@@ -8,29 +8,11 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import * as types from "../../types/primitives.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 import {
-  Amount,
-  Amount$inboundSchema,
-  Amount$Outbound,
-  Amount$outboundSchema,
-} from "./amount.js";
-import {
-  Cancellation,
-  Cancellation$inboundSchema,
-  Cancellation$Outbound,
-  Cancellation$outboundSchema,
-} from "./cancellation.js";
-import {
-  CardAcquiringDispute,
-  CardAcquiringDispute$inboundSchema,
-  CardAcquiringDispute$Outbound,
-  CardAcquiringDispute$outboundSchema,
-} from "./cardacquiringdispute.js";
-import {
-  CardAcquiringRefund,
-  CardAcquiringRefund$inboundSchema,
-  CardAcquiringRefund$Outbound,
-  CardAcquiringRefund$outboundSchema,
-} from "./cardacquiringrefund.js";
+  AmountDecimal,
+  AmountDecimal$inboundSchema,
+  AmountDecimal$Outbound,
+  AmountDecimal$outboundSchema,
+} from "./amountdecimal.js";
 import {
   FacilitatorFee,
   FacilitatorFee$inboundSchema,
@@ -50,11 +32,11 @@ import {
   TransferAmountDetails$outboundSchema,
 } from "./transferamountdetails.js";
 import {
-  TransferCapture,
-  TransferCapture$inboundSchema,
-  TransferCapture$Outbound,
-  TransferCapture$outboundSchema,
-} from "./transfercapture.js";
+  TransferAuthorization,
+  TransferAuthorization$inboundSchema,
+  TransferAuthorization$Outbound,
+  TransferAuthorization$outboundSchema,
+} from "./transferauthorization.js";
 import {
   TransferDestination,
   TransferDestination$inboundSchema,
@@ -72,6 +54,18 @@ import {
   TransferLineItems$Outbound,
   TransferLineItems$outboundSchema,
 } from "./transferlineitems.js";
+import {
+  TransferProcessingDetails,
+  TransferProcessingDetails$inboundSchema,
+  TransferProcessingDetails$Outbound,
+  TransferProcessingDetails$outboundSchema,
+} from "./transferprocessingdetails.js";
+import {
+  TransferRailOptions,
+  TransferRailOptions$inboundSchema,
+  TransferRailOptions$Outbound,
+  TransferRailOptions$outboundSchema,
+} from "./transferrailoptions.js";
 import {
   TransferSource,
   TransferSource$inboundSchema,
@@ -83,9 +77,18 @@ import {
   TransferStatus$inboundSchema,
   TransferStatus$outboundSchema,
 } from "./transferstatus.js";
+import {
+  TransferType,
+  TransferType$inboundSchema,
+  TransferType$outboundSchema,
+} from "./transfertype.js";
 
 export type CreatedTransfer = {
   transferID: string;
+  /**
+   * The rail and direction used to move funds for a transfer.
+   */
+  transferType: TransferType;
   createdOn: Date;
   source?: TransferSource | undefined;
   destination?: TransferDestination | undefined;
@@ -98,7 +101,7 @@ export type CreatedTransfer = {
    * Reason for a transfer's failure.
    */
   failureReason?: TransferFailureReason | undefined;
-  amount?: Amount | undefined;
+  amount?: AmountDecimal | undefined;
   /**
    * An optional description of the transfer that is used on receipts and for your own internal use.
    */
@@ -114,21 +117,14 @@ export type CreatedTransfer = {
   /**
    * Fees charged to your platform account for transfers.
    */
-  moovFee?: number | undefined;
-  /**
-   * Same as `moovFee`, but a decimal-formatted numerical string that represents up to 9 decimal place precision.
-   */
-  moovFeeDecimal?: string | undefined;
+  moovFee?: AmountDecimal | undefined;
   /**
    * Processing and pass-through costs that add up to the moovFee.
    */
   moovFeeDetails?: MoovFeeDetails | undefined;
   groupID?: string | undefined;
-  cancellations?: Array<Cancellation> | undefined;
-  refundedAmount?: Amount | undefined;
-  refunds?: Array<CardAcquiringRefund> | undefined;
-  disputedAmount?: Amount | undefined;
-  disputes?: Array<CardAcquiringDispute> | undefined;
+  refundedAmount?: AmountDecimal | undefined;
+  disputedAmount?: AmountDecimal | undefined;
   sweepID?: string | undefined;
   scheduleID?: string | undefined;
   occurrenceID?: string | undefined;
@@ -145,10 +141,9 @@ export type CreatedTransfer = {
    */
   lineItems?: TransferLineItems | undefined;
   amountDetails?: TransferAmountDetails | undefined;
-  /**
-   * The card authorization and capture IDs associated with a transfer.
-   */
-  capture?: TransferCapture | undefined;
+  authorization?: TransferAuthorization | undefined;
+  options: TransferRailOptions;
+  processingDetails: TransferProcessingDetails;
 };
 
 /** @internal */
@@ -158,25 +153,22 @@ export const CreatedTransfer$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   transferID: types.string(),
+  transferType: TransferType$inboundSchema,
   createdOn: types.date(),
   source: types.optional(TransferSource$inboundSchema),
   destination: types.optional(TransferDestination$inboundSchema),
   completedOn: types.optional(types.date()),
   status: types.optional(TransferStatus$inboundSchema),
   failureReason: types.optional(TransferFailureReason$inboundSchema),
-  amount: types.optional(Amount$inboundSchema),
+  amount: types.optional(AmountDecimal$inboundSchema),
   description: types.optional(types.string()),
   metadata: types.optional(z.record(types.string())),
   facilitatorFee: types.optional(FacilitatorFee$inboundSchema),
-  moovFee: types.optional(types.number()),
-  moovFeeDecimal: types.optional(types.string()),
+  moovFee: types.optional(AmountDecimal$inboundSchema),
   moovFeeDetails: types.optional(MoovFeeDetails$inboundSchema),
   groupID: types.optional(types.string()),
-  cancellations: types.optional(z.array(Cancellation$inboundSchema)),
-  refundedAmount: types.optional(Amount$inboundSchema),
-  refunds: types.optional(z.array(CardAcquiringRefund$inboundSchema)),
-  disputedAmount: types.optional(Amount$inboundSchema),
-  disputes: types.optional(z.array(CardAcquiringDispute$inboundSchema)),
+  refundedAmount: types.optional(AmountDecimal$inboundSchema),
+  disputedAmount: types.optional(AmountDecimal$inboundSchema),
   sweepID: types.optional(types.string()),
   scheduleID: types.optional(types.string()),
   occurrenceID: types.optional(types.string()),
@@ -184,30 +176,29 @@ export const CreatedTransfer$inboundSchema: z.ZodType<
   foreignID: types.optional(types.string()),
   lineItems: types.optional(TransferLineItems$inboundSchema),
   amountDetails: types.optional(TransferAmountDetails$inboundSchema),
-  capture: types.optional(TransferCapture$inboundSchema),
+  authorization: types.optional(TransferAuthorization$inboundSchema),
+  options: TransferRailOptions$inboundSchema,
+  processingDetails: TransferProcessingDetails$inboundSchema,
 });
 /** @internal */
 export type CreatedTransfer$Outbound = {
   transferID: string;
+  transferType: string;
   createdOn: string;
   source?: TransferSource$Outbound | undefined;
   destination?: TransferDestination$Outbound | undefined;
   completedOn?: string | undefined;
   status?: string | undefined;
   failureReason?: string | undefined;
-  amount?: Amount$Outbound | undefined;
+  amount?: AmountDecimal$Outbound | undefined;
   description?: string | undefined;
   metadata?: { [k: string]: string } | undefined;
   facilitatorFee?: FacilitatorFee$Outbound | undefined;
-  moovFee?: number | undefined;
-  moovFeeDecimal?: string | undefined;
+  moovFee?: AmountDecimal$Outbound | undefined;
   moovFeeDetails?: MoovFeeDetails$Outbound | undefined;
   groupID?: string | undefined;
-  cancellations?: Array<Cancellation$Outbound> | undefined;
-  refundedAmount?: Amount$Outbound | undefined;
-  refunds?: Array<CardAcquiringRefund$Outbound> | undefined;
-  disputedAmount?: Amount$Outbound | undefined;
-  disputes?: Array<CardAcquiringDispute$Outbound> | undefined;
+  refundedAmount?: AmountDecimal$Outbound | undefined;
+  disputedAmount?: AmountDecimal$Outbound | undefined;
   sweepID?: string | undefined;
   scheduleID?: string | undefined;
   occurrenceID?: string | undefined;
@@ -215,7 +206,9 @@ export type CreatedTransfer$Outbound = {
   foreignID?: string | undefined;
   lineItems?: TransferLineItems$Outbound | undefined;
   amountDetails?: TransferAmountDetails$Outbound | undefined;
-  capture?: TransferCapture$Outbound | undefined;
+  authorization?: TransferAuthorization$Outbound | undefined;
+  options: TransferRailOptions$Outbound;
+  processingDetails: TransferProcessingDetails$Outbound;
 };
 
 /** @internal */
@@ -225,25 +218,22 @@ export const CreatedTransfer$outboundSchema: z.ZodType<
   CreatedTransfer
 > = z.object({
   transferID: z.string(),
+  transferType: TransferType$outboundSchema,
   createdOn: z.date().transform(v => v.toISOString()),
   source: TransferSource$outboundSchema.optional(),
   destination: TransferDestination$outboundSchema.optional(),
   completedOn: z.date().transform(v => v.toISOString()).optional(),
   status: TransferStatus$outboundSchema.optional(),
   failureReason: TransferFailureReason$outboundSchema.optional(),
-  amount: Amount$outboundSchema.optional(),
+  amount: AmountDecimal$outboundSchema.optional(),
   description: z.string().optional(),
   metadata: z.record(z.string()).optional(),
   facilitatorFee: FacilitatorFee$outboundSchema.optional(),
-  moovFee: z.number().int().optional(),
-  moovFeeDecimal: z.string().optional(),
+  moovFee: AmountDecimal$outboundSchema.optional(),
   moovFeeDetails: MoovFeeDetails$outboundSchema.optional(),
   groupID: z.string().optional(),
-  cancellations: z.array(Cancellation$outboundSchema).optional(),
-  refundedAmount: Amount$outboundSchema.optional(),
-  refunds: z.array(CardAcquiringRefund$outboundSchema).optional(),
-  disputedAmount: Amount$outboundSchema.optional(),
-  disputes: z.array(CardAcquiringDispute$outboundSchema).optional(),
+  refundedAmount: AmountDecimal$outboundSchema.optional(),
+  disputedAmount: AmountDecimal$outboundSchema.optional(),
   sweepID: z.string().optional(),
   scheduleID: z.string().optional(),
   occurrenceID: z.string().optional(),
@@ -251,7 +241,9 @@ export const CreatedTransfer$outboundSchema: z.ZodType<
   foreignID: z.string().optional(),
   lineItems: TransferLineItems$outboundSchema.optional(),
   amountDetails: TransferAmountDetails$outboundSchema.optional(),
-  capture: TransferCapture$outboundSchema.optional(),
+  authorization: TransferAuthorization$outboundSchema.optional(),
+  options: TransferRailOptions$outboundSchema,
+  processingDetails: TransferProcessingDetails$outboundSchema,
 });
 
 export function createdTransferToJSON(

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 {
+  AmountDecimal,
+  AmountDecimal$inboundSchema,
+  AmountDecimal$Outbound,
+  AmountDecimal$outboundSchema,
+} from "./amountdecimal.js";
 import {
   RefundAmountDetails,
   RefundAmountDetails$inboundSchema,
@@ -19,13 +25,17 @@ import {
  *
  * @remarks
  *
- * This request body is optional, an empty body will issue a refund for the full amount of the original transfer.
+ * Before v2026.10, this request body may be omitted. In v2026.10 and later, send an empty object to refund the full amount of the original transfer.
  */
 export type CreateRefund = {
   /**
-   * Amount to refund in cents. If null, the original transfer's full amount will be refunded.
+   * Amount to refund. Before v2026.10, specify the amount in integer cents. If omitted, the original transfer's full amount will be refunded.
+   */
+  amount?: AmountDecimal | undefined;
+  /**
+   * ID of the capture to refund. Required for multi-capture card payment transfers.
    */
-  amount?: number | undefined;
+  captureID?: string | undefined;
   /**
    * Breakdown of the refunded amount.
    */
@@ -38,12 +48,14 @@ export const CreateRefund$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  amount: types.optional(types.number()),
+  amount: types.optional(AmountDecimal$inboundSchema),
+  captureID: types.optional(types.string()),
   amountDetails: types.optional(RefundAmountDetails$inboundSchema),
 });
 /** @internal */
 export type CreateRefund$Outbound = {
-  amount?: number | undefined;
+  amount?: AmountDecimal$Outbound | undefined;
+  captureID?: string | undefined;
   amountDetails?: RefundAmountDetails$Outbound | undefined;
 };
 
@@ -53,7 +65,8 @@ export const CreateRefund$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   CreateRefund
 > = z.object({
-  amount: z.number().int().optional(),
+  amount: AmountDecimal$outboundSchema.optional(),
+  captureID: z.string().optional(),
   amountDetails: RefundAmountDetails$outboundSchema.optional(),
 });
 

package/src/models/components/createreversal.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 {
+  AmountDecimal,
+  AmountDecimal$inboundSchema,
+  AmountDecimal$Outbound,
+  AmountDecimal$outboundSchema,
+} from "./amountdecimal.js";
 import {
   ReversalAmountDetails,
   ReversalAmountDetails$inboundSchema,
@@ -16,9 +22,9 @@ import {
 
 export type CreateReversal = {
   /**
-   * Amount to reverse in cents. Partial amounts will automatically trigger a refund instead of a cancellation.
+   * Amount to reverse. Before v2026.10, specify the amount in integer cents. Partial amounts automatically trigger a refund instead of a cancellation.
    */
-  amount: number;
+  amount: AmountDecimal;
   /**
    * Breakdown of the reversed amount.
    */
@@ -31,12 +37,12 @@ export const CreateReversal$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  amount: types.number(),
+  amount: AmountDecimal$inboundSchema,
   amountDetails: types.optional(ReversalAmountDetails$inboundSchema),
 });
 /** @internal */
 export type CreateReversal$Outbound = {
-  amount: number;
+  amount: AmountDecimal$Outbound;
   amountDetails?: ReversalAmountDetails$Outbound | undefined;
 };
 
@@ -46,7 +52,7 @@ export const CreateReversal$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   CreateReversal
 > = z.object({
-  amount: z.number().int(),
+  amount: AmountDecimal$outboundSchema,
   amountDetails: ReversalAmountDetails$outboundSchema.optional(),
 });