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

package/src/models/components/capture.ts

@@ -18,6 +18,11 @@ import {
   CaptureStatus$inboundSchema,
   CaptureStatus$outboundSchema,
 } from "./capturestatus.js";
+import {
+  CardTransactionFailureCode,
+  CardTransactionFailureCode$inboundSchema,
+  CardTransactionFailureCode$outboundSchema,
+} from "./cardtransactionfailurecode.js";
 import {
   TransferAmountDetails,
   TransferAmountDetails$inboundSchema,
@@ -32,7 +37,7 @@ import {
 } from "./transferlineitems.js";
 
 /**
- * Details of a capture against an authorized transfer.
+ * Details of a capture against an authorization.
  */
 export type Capture = {
   /**
@@ -41,7 +46,7 @@ export type Capture = {
   captureID: string;
   amount: AmountDecimal;
   /**
-   * Indicates whether this is the final capture against the authorization. When `true`, no further captures can be made.
+   * Indicates whether this is intended to be the final capture.
    */
   isFinal: boolean;
   status: CaptureStatus;
@@ -71,9 +76,13 @@ export type Capture = {
   lineItems?: TransferLineItems | undefined;
   amountDetails?: TransferAmountDetails | undefined;
   /**
-   * The facilitator fee amount applied to the capture.
+   * The facilitator fee applied to this capture.
+   *
+   * @remarks
+   * The transfer's facilitator fee is the sum of its capture fees.
    */
   facilitatorFeeAmount?: AmountDecimal | undefined;
+  failureCode?: CardTransactionFailureCode | undefined;
 };
 
 /** @internal */
@@ -91,6 +100,7 @@ export const Capture$inboundSchema: z.ZodType<Capture, z.ZodTypeDef, unknown> =
     lineItems: types.optional(TransferLineItems$inboundSchema),
     amountDetails: types.optional(TransferAmountDetails$inboundSchema),
     facilitatorFeeAmount: types.optional(AmountDecimal$inboundSchema),
+    failureCode: types.optional(CardTransactionFailureCode$inboundSchema),
   });
 /** @internal */
 export type Capture$Outbound = {
@@ -106,6 +116,7 @@ export type Capture$Outbound = {
   lineItems?: TransferLineItems$Outbound | undefined;
   amountDetails?: TransferAmountDetails$Outbound | undefined;
   facilitatorFeeAmount?: AmountDecimal$Outbound | undefined;
+  failureCode?: string | undefined;
 };
 
 /** @internal */
@@ -126,6 +137,7 @@ export const Capture$outboundSchema: z.ZodType<
   lineItems: TransferLineItems$outboundSchema.optional(),
   amountDetails: TransferAmountDetails$outboundSchema.optional(),
   facilitatorFeeAmount: AmountDecimal$outboundSchema.optional(),
+  failureCode: CardTransactionFailureCode$outboundSchema.optional(),
 });
 
 export function captureToJSON(capture: Capture): string {

package/src/models/components/capturestatus.ts

@@ -8,8 +8,6 @@ import { OpenEnum } from "../../types/enums.js";
 
 export const CaptureStatus = {
   Pending: "pending",
-  Submitted: "submitted",
-  Settled: "settled",
   Completed: "completed",
   Failed: "failed",
   Canceled: "canceled",

package/src/models/components/cardacquiringrefund.ts

@@ -44,7 +44,7 @@ export type CardAcquiringRefund = {
   status: RefundStatus;
   amount: AmountDecimal;
   /**
-   * ID of the capture this refund applies to, when applicable.
+   * ID of the capture refunded for an auth-capture `card-payment` transfer.
    */
   captureID?: string | undefined;
   amountDetails?: RefundAmountDetails | undefined;

package/src/models/components/cardissuing.ts

@@ -0,0 +1,61 @@
+/*
+ * 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 {
+  EstimatedActivity,
+  EstimatedActivity$inboundSchema,
+  EstimatedActivity$Outbound,
+  EstimatedActivity$outboundSchema,
+} from "./estimatedactivity.js";
+
+/**
+ * Underwriting data for the `card-issuing` capability.
+ *
+ * @remarks
+ *
+ * Issued cards are funded from the account's card-issuing wallet before they can be spent, so estimated activity is the only data collected.
+ */
+export type CardIssuing = {
+  estimatedActivity?: EstimatedActivity | undefined;
+};
+
+/** @internal */
+export const CardIssuing$inboundSchema: z.ZodType<
+  CardIssuing,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  estimatedActivity: types.optional(EstimatedActivity$inboundSchema),
+});
+/** @internal */
+export type CardIssuing$Outbound = {
+  estimatedActivity?: EstimatedActivity$Outbound | undefined;
+};
+
+/** @internal */
+export const CardIssuing$outboundSchema: z.ZodType<
+  CardIssuing$Outbound,
+  z.ZodTypeDef,
+  CardIssuing
+> = z.object({
+  estimatedActivity: EstimatedActivity$outboundSchema.optional(),
+});
+
+export function cardIssuingToJSON(cardIssuing: CardIssuing): string {
+  return JSON.stringify(CardIssuing$outboundSchema.parse(cardIssuing));
+}
+export function cardIssuingFromJSON(
+  jsonString: string,
+): SafeParseResult<CardIssuing, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CardIssuing$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CardIssuing' from JSON`,
+  );
+}

package/src/models/components/cardissuingerror.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 {
+  EstimatedActivityError,
+  EstimatedActivityError$inboundSchema,
+  EstimatedActivityError$Outbound,
+  EstimatedActivityError$outboundSchema,
+} from "./estimatedactivityerror.js";
+
+export type CardIssuingError = {
+  estimatedActivity?: EstimatedActivityError | undefined;
+};
+
+/** @internal */
+export const CardIssuingError$inboundSchema: z.ZodType<
+  CardIssuingError,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  estimatedActivity: types.optional(EstimatedActivityError$inboundSchema),
+});
+/** @internal */
+export type CardIssuingError$Outbound = {
+  estimatedActivity?: EstimatedActivityError$Outbound | undefined;
+};
+
+/** @internal */
+export const CardIssuingError$outboundSchema: z.ZodType<
+  CardIssuingError$Outbound,
+  z.ZodTypeDef,
+  CardIssuingError
+> = z.object({
+  estimatedActivity: EstimatedActivityError$outboundSchema.optional(),
+});
+
+export function cardIssuingErrorToJSON(
+  cardIssuingError: CardIssuingError,
+): string {
+  return JSON.stringify(
+    CardIssuingError$outboundSchema.parse(cardIssuingError),
+  );
+}
+export function cardIssuingErrorFromJSON(
+  jsonString: string,
+): SafeParseResult<CardIssuingError, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CardIssuingError$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CardIssuingError' from JSON`,
+  );
+}

package/src/models/components/cardpaymenttransactionstatus.ts

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../../types/enums.js";
+import { OpenEnum } from "../../types/enums.js";
+
+/**
+ * Status of a card payment transaction.
+ */
+export const CardPaymentTransactionStatus = {
+  Initiated: "initiated",
+  Confirmed: "confirmed",
+  Canceled: "canceled",
+  Settled: "settled",
+  Failed: "failed",
+  Completed: "completed",
+} as const;
+/**
+ * Status of a card payment transaction.
+ */
+export type CardPaymentTransactionStatus = OpenEnum<
+  typeof CardPaymentTransactionStatus
+>;
+
+/** @internal */
+export const CardPaymentTransactionStatus$inboundSchema: z.ZodType<
+  CardPaymentTransactionStatus,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(CardPaymentTransactionStatus);
+/** @internal */
+export const CardPaymentTransactionStatus$outboundSchema: z.ZodType<
+  string,
+  z.ZodTypeDef,
+  CardPaymentTransactionStatus
+> = openEnums.outboundSchema(CardPaymentTransactionStatus);

package/src/models/components/cardpaymenttransferprocessingdetails.ts

@@ -7,6 +7,11 @@ 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 {
+  CardPaymentTransactionStatus,
+  CardPaymentTransactionStatus$inboundSchema,
+  CardPaymentTransactionStatus$outboundSchema,
+} from "./cardpaymenttransactionstatus.js";
 import {
   CardTransactionFailureCode,
   CardTransactionFailureCode$inboundSchema,
@@ -14,10 +19,17 @@ import {
 } from "./cardtransactionfailurecode.js";
 
 export type CardPaymentTransferProcessingDetails = {
+  /**
+   * Status of a card payment transaction.
+   */
+  status?: CardPaymentTransactionStatus | undefined;
   authorizationCode?: string | undefined;
   networkTransactionID?: string | undefined;
-  networkResponseCode?: string | undefined;
   failureCode?: CardTransactionFailureCode | undefined;
+  /**
+   * The retrieval reference number assigned by the card network to the card payment.
+   */
+  retrievalReferenceNumber?: string | undefined;
 };
 
 /** @internal */
@@ -26,17 +38,19 @@ export const CardPaymentTransferProcessingDetails$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
+  status: types.optional(CardPaymentTransactionStatus$inboundSchema),
   authorizationCode: types.optional(types.string()),
   networkTransactionID: types.optional(types.string()),
-  networkResponseCode: types.optional(types.string()),
   failureCode: types.optional(CardTransactionFailureCode$inboundSchema),
+  retrievalReferenceNumber: types.optional(types.string()),
 });
 /** @internal */
 export type CardPaymentTransferProcessingDetails$Outbound = {
+  status?: string | undefined;
   authorizationCode?: string | undefined;
   networkTransactionID?: string | undefined;
-  networkResponseCode?: string | undefined;
   failureCode?: string | undefined;
+  retrievalReferenceNumber?: string | undefined;
 };
 
 /** @internal */
@@ -45,10 +59,11 @@ export const CardPaymentTransferProcessingDetails$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   CardPaymentTransferProcessingDetails
 > = z.object({
+  status: CardPaymentTransactionStatus$outboundSchema.optional(),
   authorizationCode: z.string().optional(),
   networkTransactionID: z.string().optional(),
-  networkResponseCode: z.string().optional(),
   failureCode: CardTransactionFailureCode$outboundSchema.optional(),
+  retrievalReferenceNumber: z.string().optional(),
 });
 
 export function cardPaymentTransferProcessingDetailsToJSON(

package/src/models/components/cardtransactionfailurecode.ts

@@ -30,6 +30,22 @@ export const CardTransactionFailureCode = {
   IssuerNotAvailable: "issuer-not-available",
   CouldNotRoute: "could-not-route",
   CardholderAccountClosed: "cardholder-account-closed",
+  AccountClosed: "account-closed",
+  AccountNotActivated: "account-not-activated",
+  AuthenticationFailed: "authentication-failed",
+  AuthenticationRequired: "authentication-required",
+  CardholderActionRequired: "cardholder-action-required",
+  FormatError: "format-error",
+  InvalidPin: "invalid-pin",
+  OfflineApproved: "offline-approved",
+  OfflineDeclined: "offline-declined",
+  PartialApproval: "partial-approval",
+  PaymentStopped: "payment-stopped",
+  PinRequired: "pin-required",
+  RecordNotFound: "record-not-found",
+  SurchargeNotPermitted: "surcharge-not-permitted",
+  TransactionReversed: "transaction-reversed",
+  VerificationFailed: "verification-failed",
   UnknownIssue: "unknown-issue",
   DuplicateTransaction: "duplicate-transaction",
 } as const;

package/src/models/components/createbankaccountattestation.ts

@@ -0,0 +1,69 @@
+/*
+ * 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";
+
+/**
+ * Request body for creating a R29 re-authorization attestation for an errored bank account.
+ */
+export type CreateBankAccountAttestation = {
+  /**
+   * Date on which new authorization was obtained from the receiver, formatted as YYYY-MM-DD.
+   */
+  attestedAt: Date;
+  /**
+   * Freeform text description describing how the authorization was obtained.
+   */
+  description: string;
+};
+
+/** @internal */
+export const CreateBankAccountAttestation$inboundSchema: z.ZodType<
+  CreateBankAccountAttestation,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  attestedAt: types.date(),
+  description: types.string(),
+});
+/** @internal */
+export type CreateBankAccountAttestation$Outbound = {
+  attestedAt: string;
+  description: string;
+};
+
+/** @internal */
+export const CreateBankAccountAttestation$outboundSchema: z.ZodType<
+  CreateBankAccountAttestation$Outbound,
+  z.ZodTypeDef,
+  CreateBankAccountAttestation
+> = z.object({
+  attestedAt: z.date().transform(v =>
+    v.toISOString().slice(0, "YYYY-MM-DD".length)
+  ),
+  description: z.string(),
+});
+
+export function createBankAccountAttestationToJSON(
+  createBankAccountAttestation: CreateBankAccountAttestation,
+): string {
+  return JSON.stringify(
+    CreateBankAccountAttestation$outboundSchema.parse(
+      createBankAccountAttestation,
+    ),
+  );
+}
+export function createBankAccountAttestationFromJSON(
+  jsonString: string,
+): SafeParseResult<CreateBankAccountAttestation, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreateBankAccountAttestation$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateBankAccountAttestation' from JSON`,
+  );
+}

package/src/models/components/createcancellation.ts

@@ -14,7 +14,17 @@ import {
   AmountDecimal$outboundSchema,
 } from "./amountdecimal.js";
 
+/**
+ * Cancellation request.
+ */
 export type CreateCancellation = {
+  /**
+   * Amount to void. This field can only be set for an auth-capture `card-payment` transfer.
+   *
+   * @remarks
+   * This cannot exceed `capturableAmount`.
+   * Omit this field to void the entire `capturableAmount`.
+   */
   amount?: AmountDecimal | undefined;
 };
 

package/src/models/components/createcapture.ts

@@ -27,7 +27,7 @@ import {
 } from "./createtransferlineitems.js";
 
 /**
- * Request to capture funds against an authorized transfer.
+ * Request to capture funds against an authorization.
  */
 export type CreateCapture = {
   /**
@@ -35,11 +35,17 @@ export type CreateCapture = {
    */
   destinationPaymentMethodID: string;
   /**
-   * Amount to capture. If omitted, the remaining authorized amount is captured.
+   * Amount to capture.
+   *
+   * @remarks
+   * If omitted, the remaining capturable amount is captured.
    */
   amount?: AmountDecimal | undefined;
   /**
-   * Indicates whether this is the final capture against the authorization. When `true`, any remaining authorized amount is voided.
+   * Indicates whether this is intended to be the final capture.
+   *
+   * @remarks
+   * When `true`, any remaining capturable amount is voided.
    */
   isFinal?: boolean | undefined;
   /**
@@ -63,7 +69,10 @@ export type CreateCapture = {
   lineItems?: CreateTransferLineItems | undefined;
   amountDetails?: CreateTransferAmountDetails | undefined;
   /**
-   * The facilitator fee amount applied to the capture.
+   * The facilitator fee applied to this capture.
+   *
+   * @remarks
+   * The transfer's facilitator fee is the sum of its capture fees.
    */
   facilitatorFeeAmount?: AmountDecimal | undefined;
 };

package/src/models/components/createdtransfer.ts

@@ -101,6 +101,14 @@ export type CreatedTransfer = {
    * Reason for a transfer's failure.
    */
   failureReason?: TransferFailureReason | undefined;
+  /**
+   * Amount associated with this transfer.
+   *
+   * @remarks
+   * In v2026.10 and later, an auth-capture `card-payment` transfer reports the approved authorization amount until a final capture is created.
+   * For these transfers, when a final capture is created, this is updated to the cumulative captured amount.
+   * For other transfer types, this is the transfer amount.
+   */
   amount?: AmountDecimal | undefined;
   /**
    * An optional description of the transfer that is used on receipts and for your own internal use.
@@ -141,6 +149,12 @@ export type CreatedTransfer = {
    */
   lineItems?: TransferLineItems | undefined;
   amountDetails?: TransferAmountDetails | undefined;
+  /**
+   * Authorization amounts.
+   *
+   * @remarks
+   * This field is present only for an auth-capture `card-payment` transfer.
+   */
   authorization?: TransferAuthorization | undefined;
   options: TransferRailOptions;
   processingDetails: TransferProcessingDetails;

package/src/models/components/createfeeplanagreement.ts

@@ -10,9 +10,23 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type CreateFeePlanAgreement = {
   /**
-   * A unique identifier for a Moov resource. Supports UUID format (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx) or typed format with base32-encoded UUID and type suffix (e.g., kuoaydiojf7uszaokc2ggnaaaa_xfer).
+   * A unique identifier for a fee plan: the pricing terms, such as flat-rate or cost-plus, that an account
+   *
+   * @remarks
+   * is charged under its fee plan agreement. Use GET /accounts/{accountID}/fee-plans to list the fee plans
+   * available to assign to a given account.
    */
   planID: string;
+  /**
+   * The account's active fee plan agreement to supersede. When set, that agreement is terminated and
+   *
+   * @remarks
+   * the new one takes its place in a single operation, so the account is never without an active fee
+   * plan agreement. This new agreement always receives a newly issued agreementID.
+   *
+   * Omit it if the account doesn't already have an active fee plan agreement.
+   */
+  priorAgreementID?: string | undefined;
 };
 
 /** @internal */
@@ -22,10 +36,12 @@ export const CreateFeePlanAgreement$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   planID: types.string(),
+  priorAgreementID: types.optional(types.string()),
 });
 /** @internal */
 export type CreateFeePlanAgreement$Outbound = {
   planID: string;
+  priorAgreementID?: string | undefined;
 };
 
 /** @internal */
@@ -35,6 +51,7 @@ export const CreateFeePlanAgreement$outboundSchema: z.ZodType<
   CreateFeePlanAgreement
 > = z.object({
   planID: z.string(),
+  priorAgreementID: z.string().optional(),
 });
 
 export function createFeePlanAgreementToJSON(

package/src/models/components/createpaymentlink.ts

@@ -106,6 +106,9 @@ export type CreatePaymentLink = {
    * Options for payment links used to collect payment.
    */
   payment?: PaymentLinkPaymentDetails | undefined;
+  /**
+   * Options for payout links used to send a payout.
+   */
   payout?: PaymentLinkPayoutDetails | undefined;
   /**
    * Options for a custom amount payment link. Mutually exclusive with `payment` and `payout`.

package/src/models/components/createrefund.ts

@@ -29,11 +29,11 @@ import {
  */
 export type CreateRefund = {
   /**
-   * Amount to refund. Before v2026.10, specify the amount in integer cents. If omitted, the original transfer's full amount will be refunded.
+   * Amount to refund. 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.
+   * ID of the capture to refund. This field is only relevant for an auth-capture `card-payment` transfer.
    */
   captureID?: string | undefined;
   /**

package/src/models/components/createreversal.ts

@@ -22,7 +22,12 @@ import {
 
 export type CreateReversal = {
   /**
-   * Amount to reverse. Before v2026.10, specify the amount in integer cents. Partial amounts automatically trigger a refund instead of a cancellation.
+   * Amount to reverse.
+   *
+   * @remarks
+   * Before v2026.10, specify the amount in integer cents.
+   * For supported auth-capture `card-payment` reversals in v2026.10 and later, a transfer with no captures uses the full `capturableAmount`.
+   * For those transfers with one final capture, a cancellation uses the full capture amount, while a refund may be partial.
    */
   amount: AmountDecimal;
   /**

package/src/models/components/createtransfer.ts

@@ -85,7 +85,7 @@ export type CreateTransfer = {
   lineItems?: CreateTransferLineItems | undefined;
   amountDetails?: CreateTransferAmountDetails | undefined;
   /**
-   * Indicates which party bears fees for the transfer, keyed by fee type.
+   * Indicates which party bears fees for a transfer, keyed by fee type.
    */
   feePaidBy?: TransferFeePaidBy | undefined;
 };

package/src/models/components/createtransferdestination.ts

@@ -19,6 +19,12 @@ import {
   CreateTransferDestinationCard$Outbound,
   CreateTransferDestinationCard$outboundSchema,
 } from "./createtransferdestinationcard.js";
+import {
+  CreateTransferDestinationWire,
+  CreateTransferDestinationWire$inboundSchema,
+  CreateTransferDestinationWire$Outbound,
+  CreateTransferDestinationWire$outboundSchema,
+} from "./createtransferdestinationwire.js";
 
 /**
  * The final stage of a transfer and the ultimate recipient of the funds.
@@ -27,6 +33,10 @@ export type CreateTransferDestination = {
   paymentMethodID: string;
   cardDetails?: CreateTransferDestinationCard | undefined;
   achDetails?: CreateTransferDestinationACH | undefined;
+  /**
+   * Wire-specific options supplied when creating a transfer.
+   */
+  wireDetails?: CreateTransferDestinationWire | undefined;
 };
 
 /** @internal */
@@ -38,12 +48,14 @@ export const CreateTransferDestination$inboundSchema: z.ZodType<
   paymentMethodID: types.string(),
   cardDetails: types.optional(CreateTransferDestinationCard$inboundSchema),
   achDetails: types.optional(CreateTransferDestinationACH$inboundSchema),
+  wireDetails: types.optional(CreateTransferDestinationWire$inboundSchema),
 });
 /** @internal */
 export type CreateTransferDestination$Outbound = {
   paymentMethodID: string;
   cardDetails?: CreateTransferDestinationCard$Outbound | undefined;
   achDetails?: CreateTransferDestinationACH$Outbound | undefined;
+  wireDetails?: CreateTransferDestinationWire$Outbound | undefined;
 };
 
 /** @internal */
@@ -55,6 +67,7 @@ export const CreateTransferDestination$outboundSchema: z.ZodType<
   paymentMethodID: z.string(),
   cardDetails: CreateTransferDestinationCard$outboundSchema.optional(),
   achDetails: CreateTransferDestinationACH$outboundSchema.optional(),
+  wireDetails: CreateTransferDestinationWire$outboundSchema.optional(),
 });
 
 export function createTransferDestinationToJSON(