@moovio/sdk 26.5.7 → 26.5.9

package/src/models/components/updateissuedcardstate.ts

@@ -9,15 +9,21 @@ import { ClosedEnum } from "../../types/enums.js";
  * Updates the state of a Moov issued card.
  *
  * @remarks
+ * - `active`: Reactivates a frozen card so it can approve authorizations again.
+ * - `frozen`: Temporarily suspends the card so it cannot approve authorizations. A card can be moved between `frozen` and `active` at will until it is `closed`, which is a terminal state.
  * - `closed`: The card is permanently deactivated and cannot approve authorizations. A card can be closed by request or when it expires.
  */
 export const UpdateIssuedCardState = {
+  Active: "active",
+  Frozen: "frozen",
   Closed: "closed",
 } as const;
 /**
  * Updates the state of a Moov issued card.
  *
  * @remarks
+ * - `active`: Reactivates a frozen card so it can approve authorizations again.
+ * - `frozen`: Temporarily suspends the card so it cannot approve authorizations. A card can be moved between `frozen` and `active` at will until it is `closed`, which is a terminal state.
  * - `closed`: The card is permanently deactivated and cannot approve authorizations. A card can be closed by request or when it expires.
  */
 export type UpdateIssuedCardState = ClosedEnum<typeof UpdateIssuedCardState>;

package/src/models/components/updatepaymentlink.ts

@@ -56,6 +56,9 @@ export type UpdatePaymentLink = {
    * Options for payment links used to collect payment.
    */
   payment?: PaymentLinkPaymentDetailsUpdate | undefined;
+  /**
+   * Options for payout links used to send a payout.
+   */
   payout?: PaymentLinkPayoutDetailsUpdate | undefined;
   /**
    * An optional collection of line items for a payment link.

package/src/models/components/webhookdata.ts

@@ -102,6 +102,12 @@ import {
   WebhookDataDisputeUpdated$Outbound,
   WebhookDataDisputeUpdated$outboundSchema,
 } from "./webhookdatadisputeupdated.js";
+import {
+  WebhookDataEventTest,
+  WebhookDataEventTest$inboundSchema,
+  WebhookDataEventTest$Outbound,
+  WebhookDataEventTest$outboundSchema,
+} from "./webhookdataeventtest.js";
 import {
   WebhookDataInvoiceCreated,
   WebhookDataInvoiceCreated$inboundSchema,
@@ -276,7 +282,8 @@ export type WebhookData =
   | WebhookDataAccountCreated
   | WebhookDataAccountUpdated
   | WebhookDataAccountDisconnected
-  | WebhookDataNetworkIDUpdated;
+  | WebhookDataNetworkIDUpdated
+  | WebhookDataEventTest;
 
 /** @internal */
 export const WebhookData$inboundSchema: z.ZodType<
@@ -322,6 +329,7 @@ export const WebhookData$inboundSchema: z.ZodType<
   WebhookDataAccountUpdated$inboundSchema,
   WebhookDataAccountDisconnected$inboundSchema,
   WebhookDataNetworkIDUpdated$inboundSchema,
+  WebhookDataEventTest$inboundSchema,
 ]);
 /** @internal */
 export type WebhookData$Outbound =
@@ -362,7 +370,8 @@ export type WebhookData$Outbound =
   | WebhookDataAccountCreated$Outbound
   | WebhookDataAccountUpdated$Outbound
   | WebhookDataAccountDisconnected$Outbound
-  | WebhookDataNetworkIDUpdated$Outbound;
+  | WebhookDataNetworkIDUpdated$Outbound
+  | WebhookDataEventTest$Outbound;
 
 /** @internal */
 export const WebhookData$outboundSchema: z.ZodType<
@@ -408,6 +417,7 @@ export const WebhookData$outboundSchema: z.ZodType<
   WebhookDataAccountUpdated$outboundSchema,
   WebhookDataAccountDisconnected$outboundSchema,
   WebhookDataNetworkIDUpdated$outboundSchema,
+  WebhookDataEventTest$outboundSchema,
 ]);
 
 export function webhookDataToJSON(webhookData: WebhookData): string {

package/src/models/components/webhookdataeventtest.ts

@@ -0,0 +1,54 @@
+/*
+ * 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 { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * The data payload sent for an `event.test` event, such as a webhook ping.
+ */
+export type WebhookDataEventTest = {
+  ping: boolean;
+};
+
+/** @internal */
+export const WebhookDataEventTest$inboundSchema: z.ZodType<
+  WebhookDataEventTest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  ping: z.boolean(),
+});
+/** @internal */
+export type WebhookDataEventTest$Outbound = {
+  ping: boolean;
+};
+
+/** @internal */
+export const WebhookDataEventTest$outboundSchema: z.ZodType<
+  WebhookDataEventTest$Outbound,
+  z.ZodTypeDef,
+  WebhookDataEventTest
+> = z.object({
+  ping: z.boolean(),
+});
+
+export function webhookDataEventTestToJSON(
+  webhookDataEventTest: WebhookDataEventTest,
+): string {
+  return JSON.stringify(
+    WebhookDataEventTest$outboundSchema.parse(webhookDataEventTest),
+  );
+}
+export function webhookDataEventTestFromJSON(
+  jsonString: string,
+): SafeParseResult<WebhookDataEventTest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => WebhookDataEventTest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'WebhookDataEventTest' from JSON`,
+  );
+}

package/src/models/components/webhookeventtype.ts

@@ -48,6 +48,7 @@ export const WebhookEventType = {
   WalletTransactionUpdated: "walletTransaction.updated",
   BillingStatementCreated: "billingStatement.created",
   AuthorizationExpiring: "authorization.expiring",
+  EventTest: "event.test",
 } as const;
 /**
  * The type of event that occurred.

package/src/models/errors/transfer.ts

@@ -23,6 +23,14 @@ export type TransferData = {
    * Reason for a transfer's failure.
    */
   failureReason?: components.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: components.Amount;
   /**
    * An optional description of the transfer that is used on receipts and for your own internal use.
@@ -105,6 +113,14 @@ export class Transfer extends MoovError {
    * Reason for a transfer's failure.
    */
   failureReason?: components.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: components.Amount;
   /**
    * An optional description of the transfer that is used on receipts and for your own internal use.

package/src/models/operations/listaccounts.ts

@@ -66,6 +66,9 @@ export type ListAccountsRequest = {
    */
   capabilityStatus?: components.CapabilityStatus | undefined;
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
 };
 

package/src/models/operations/listconnectedaccountsforaccount.ts

@@ -67,6 +67,9 @@ export type ListConnectedAccountsForAccountRequest = {
    */
   capabilityStatus?: components.CapabilityStatus | undefined;
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
 };
 

package/src/models/operations/listdisputes.ts

@@ -12,6 +12,9 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 export type ListDisputesRequest = {
   accountID: string;
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   /**
    * Optional date-time parameter to filter all disputes created on and after the provided date and time.

package/src/models/operations/listfeeplanagreements.ts

@@ -11,6 +11,9 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type ListFeePlanAgreementsRequest = {
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   accountID: string;
   /**

package/src/models/operations/listfeerevenue.ts

@@ -11,6 +11,9 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type ListFeeRevenueRequest = {
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   /**
    * The Partner's AccountID.

package/src/models/operations/listinvoices.ts

@@ -11,6 +11,9 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type ListInvoicesRequest = {
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   status?: components.InvoiceStatus | undefined;
   customerAccountID?: string | undefined;

package/src/models/operations/listissuedcardauthorizationevents.ts

@@ -16,6 +16,9 @@ export type ListIssuedCardAuthorizationEventsRequest = {
   accountID: string;
   authorizationID: string;
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
 };
 

package/src/models/operations/listissuedcardauthorizations.ts

@@ -15,6 +15,9 @@ export type ListIssuedCardAuthorizationsRequest = {
    */
   accountID: string;
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   /**
    * Optional ID of the issued card to filter results.

package/src/models/operations/listissuedcards.ts

@@ -15,6 +15,9 @@ export type ListIssuedCardsRequest = {
    */
   accountID: string;
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   /**
    * Optional, comma-separated states to filter the Moov list issued cards response. For example `active,closed`

package/src/models/operations/listissuedcardtransactions.ts

@@ -15,11 +15,18 @@ export type ListIssuedCardTransactionsRequest = {
    */
   accountID: string;
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   /**
    * Optional ID of the issued card to filter results.
    */
   issuedCardID?: string | undefined;
+  /**
+   * Optional case-insensitive substring match on the merchant name to filter results.
+   */
+  merchantName?: string | undefined;
   /**
    * Optional date-time which inclusively filters all card transactions created after this date-time.
    */
@@ -45,6 +52,7 @@ export const ListIssuedCardTransactionsRequest$inboundSchema: z.ZodType<
   skip: z.number().int().optional(),
   count: z.number().int().optional(),
   issuedCardID: z.string().optional(),
+  merchantName: z.string().optional(),
   startDateTime: z.string().datetime({ offset: true }).transform(v =>
     new Date(v)
   ).optional(),
@@ -57,6 +65,7 @@ export type ListIssuedCardTransactionsRequest$Outbound = {
   skip?: number | undefined;
   count?: number | undefined;
   issuedCardID?: string | undefined;
+  merchantName?: string | undefined;
   startDateTime?: string | undefined;
   endDateTime?: string | undefined;
 };
@@ -71,6 +80,7 @@ export const ListIssuedCardTransactionsRequest$outboundSchema: z.ZodType<
   skip: z.number().int().optional(),
   count: z.number().int().optional(),
   issuedCardID: z.string().optional(),
+  merchantName: z.string().optional(),
   startDateTime: z.date().transform(v => v.toISOString()).optional(),
   endDateTime: z.date().transform(v => v.toISOString()).optional(),
 });

package/src/models/operations/listpartnerpricingagreements.ts

@@ -11,6 +11,9 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type ListPartnerPricingAgreementsRequest = {
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   accountID: string;
   /**

package/src/models/operations/listpaymentlinks.ts

@@ -11,6 +11,9 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type ListPaymentLinksRequest = {
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   /**
    * A comma-separated list of payment link types to filter results.

package/src/models/operations/listproducts.ts

@@ -16,6 +16,9 @@ export type ListProductsRequest = {
    */
   title?: string | undefined;
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
 };
 

package/src/models/operations/listresidualfees.ts

@@ -11,6 +11,9 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type ListResidualFeesRequest = {
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   accountID: string;
   /**

package/src/models/operations/listresiduals.ts

@@ -11,6 +11,9 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type ListResidualsRequest = {
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   accountID: string;
   /**

package/src/models/operations/listschedules.ts

@@ -17,6 +17,9 @@ export type Hydrate = ClosedEnum<typeof Hydrate>;
 
 export type ListSchedulesRequest = {
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   hydrate?: Hydrate | undefined;
   accountID: string;

package/src/models/operations/liststatements.ts

@@ -19,6 +19,9 @@ export type ListStatementsRequest = {
    */
   billingPeriodEndDateTime?: Date | undefined;
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   accountID: string;
 };

package/src/models/operations/listsweeps.ts

@@ -13,6 +13,9 @@ export type ListSweepsRequest = {
   accountID: string;
   walletID: string;
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   /**
    * Optional parameter to filter by sweep status.

package/src/models/operations/listtickets.ts

@@ -11,6 +11,9 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type ListTicketsRequest = {
   cursor?: string | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   status?: components.TicketStatus | undefined;
   foreignID?: string | undefined;

package/src/models/operations/listtransfers.ts

@@ -51,7 +51,7 @@ export type ListTransfersRequest = {
    */
   foreignID?: string | undefined;
   /**
-   * Optional comma-separated IDs to filter for transfers associated with specific card authorizations.
+   * Optional comma-separated authorization IDs.
    */
   authorizationIDs?: Array<string> | undefined;
   /**
@@ -59,6 +59,9 @@ export type ListTransfersRequest = {
    */
   captureIDs?: Array<string> | undefined;
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   accountID: string;
 };

package/src/models/operations/listwallets.ts

@@ -19,6 +19,9 @@ export type ListWalletsRequest = {
    */
   walletType?: components.WalletType | undefined;
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   accountID: string;
 };

package/src/models/operations/listwallettransactions.ts

@@ -12,6 +12,9 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 export type ListWalletTransactionsRequest = {
   accountID: string;
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   walletID: string;
   /**

package/src/models/operations/retrievefees.ts

@@ -32,6 +32,9 @@ export type RetrieveFeesRequest = {
    */
   endDateTime?: string | undefined;
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
 };
 

package/src/sdk/cardissuing.ts

@@ -86,7 +86,7 @@ export class CardIssuing extends ClientSDK {
    * Only use this endpoint if you have provided Moov with a copy of your PCI attestation of compliance.
    *
    * To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
-   * you'll need to specify the `/accounts/{accountID}/issued-cards.read-secure` scope.
+   * you'll need to specify the `/accounts/{accountID}/issued-cards.read-private` scope.
    */
   async getFull(
     request: operations.GetFullIssuedCardRequest,

package/src/sdk/images.ts

@@ -35,7 +35,7 @@ export class Images extends ClientSDK {
 
   /**
    *   Upload a new PNG, JPEG, or WebP image with optional metadata.
-   *   Duplicate images, and requests larger than 16MB will be rejected.
+   *   Duplicate images return the existing image's metadata with a 409 status. Requests larger than 16MB will be rejected.
    */
   async upload(
     request: operations.UploadImageRequest,

package/src/sdk/institutions.ts

@@ -31,7 +31,7 @@ export class Institutions extends ClientSDK {
   }
 
   /**
-   * This endpoint has been deprecated and will be removed in a future release. Use [/institutions](https://docs.moov.io/api/enrichment/form-shortening/institutions/get/).
+   * This endpoint has been deprecated and will be removed in a future release. Use [/institutions](https://docs.moov.io/api/enrichment/institutions/get/).
    *
    * Search for institutions by either their name or routing number.
    *

package/src/sdk/transfers.ts

@@ -148,6 +148,9 @@ export class Transfers extends ClientSDK {
   /**
    *   Initiate a cancellation for a card, ACH, or queued transfer.
    *
+   *   In v2026.10 and later, an auth-capture `card-payment` transfer can be canceled before any captures exist.
+   *   For these transfers, a successful cancellation reduces `capturableAmount` without changing `authorizedAmount`.
+   *   For these transfers, a partial cancellation leaves the remaining `capturableAmount` available for capture.
    *   To access this endpoint using a [token](https://docs.moov.io/api/authentication/access-tokens/) you'll need
    *   to specify the `/accounts/{accountID}/transfers.write` scope.
    */
@@ -252,6 +255,9 @@ export class Transfers extends ClientSDK {
 
   /**
    * Reverses a card transfer by initiating a cancellation or refund depending on the transaction status.
+   * In v2026.10 and later, reversing an auth-capture `card-payment` transfer with no captures cancels the entire `capturableAmount`.
+   * In those API versions, an auth-capture `card-payment` transfer with one final capture is canceled or refunded depending on its processing state.
+   * Auth-capture `card-payment` transfers with a non-final capture or multiple captures are not supported in those API versions.
    * Read our [reversals guide](https://docs.moov.io/guides/money-movement/accept-payments/card-acceptance/reversals/)
    * to learn more.
    *