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

package/src/models/operations/listbankaccountattestations.ts

@@ -0,0 +1,121 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import * as components from "../components/index.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type ListBankAccountAttestationsRequest = {
+  accountID: string;
+  bankAccountID: string;
+};
+
+export type ListBankAccountAttestationsResponse = {
+  headers: { [k: string]: Array<string> };
+  result: Array<components.BankAccountAttestationSummary>;
+};
+
+/** @internal */
+export const ListBankAccountAttestationsRequest$inboundSchema: z.ZodType<
+  ListBankAccountAttestationsRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  accountID: types.string(),
+  bankAccountID: types.string(),
+});
+/** @internal */
+export type ListBankAccountAttestationsRequest$Outbound = {
+  accountID: string;
+  bankAccountID: string;
+};
+
+/** @internal */
+export const ListBankAccountAttestationsRequest$outboundSchema: z.ZodType<
+  ListBankAccountAttestationsRequest$Outbound,
+  z.ZodTypeDef,
+  ListBankAccountAttestationsRequest
+> = z.object({
+  accountID: z.string(),
+  bankAccountID: z.string(),
+});
+
+export function listBankAccountAttestationsRequestToJSON(
+  listBankAccountAttestationsRequest: ListBankAccountAttestationsRequest,
+): string {
+  return JSON.stringify(
+    ListBankAccountAttestationsRequest$outboundSchema.parse(
+      listBankAccountAttestationsRequest,
+    ),
+  );
+}
+export function listBankAccountAttestationsRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<ListBankAccountAttestationsRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      ListBankAccountAttestationsRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListBankAccountAttestationsRequest' from JSON`,
+  );
+}
+
+/** @internal */
+export const ListBankAccountAttestationsResponse$inboundSchema: z.ZodType<
+  ListBankAccountAttestationsResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  Headers: z.record(z.array(z.string())).default({}),
+  Result: z.array(components.BankAccountAttestationSummary$inboundSchema),
+}).transform((v) => {
+  return remap$(v, {
+    "Headers": "headers",
+    "Result": "result",
+  });
+});
+/** @internal */
+export type ListBankAccountAttestationsResponse$Outbound = {
+  Headers: { [k: string]: Array<string> };
+  Result: Array<components.BankAccountAttestationSummary$Outbound>;
+};
+
+/** @internal */
+export const ListBankAccountAttestationsResponse$outboundSchema: z.ZodType<
+  ListBankAccountAttestationsResponse$Outbound,
+  z.ZodTypeDef,
+  ListBankAccountAttestationsResponse
+> = z.object({
+  headers: z.record(z.array(z.string())),
+  result: z.array(components.BankAccountAttestationSummary$outboundSchema),
+}).transform((v) => {
+  return remap$(v, {
+    headers: "Headers",
+    result: "Result",
+  });
+});
+
+export function listBankAccountAttestationsResponseToJSON(
+  listBankAccountAttestationsResponse: ListBankAccountAttestationsResponse,
+): string {
+  return JSON.stringify(
+    ListBankAccountAttestationsResponse$outboundSchema.parse(
+      listBankAccountAttestationsResponse,
+    ),
+  );
+}
+export function listBankAccountAttestationsResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<ListBankAccountAttestationsResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      ListBankAccountAttestationsResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListBankAccountAttestationsResponse' from JSON`,
+  );
+}

package/src/models/operations/listcaptures.ts

@@ -12,11 +12,11 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type ListCapturesRequest = {
   /**
-   * The merchant's Moov account ID.
+   * Moov account ID of an authorized partner or the transfer's source or destination.
    */
   accountID: string;
   /**
-   * Identifier for the transfer.
+   * Identifier for the auth-capture `card-payment` transfer.
    */
   transferID: string;
 };

package/src/models/operations/listconnectedaccountsforaccount.ts

@@ -68,6 +68,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

@@ -13,6 +13,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

@@ -12,6 +12,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

@@ -12,6 +12,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

@@ -12,6 +12,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

@@ -17,6 +17,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

@@ -16,6 +16,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

@@ -16,6 +16,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

@@ -16,11 +16,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.
    */
@@ -46,6 +53,7 @@ export const ListIssuedCardTransactionsRequest$inboundSchema: z.ZodType<
   skip: types.optional(types.number()),
   count: types.optional(types.number()),
   issuedCardID: types.optional(types.string()),
+  merchantName: types.optional(types.string()),
   startDateTime: types.optional(types.date()),
   endDateTime: types.optional(types.date()),
 });
@@ -55,6 +63,7 @@ export type ListIssuedCardTransactionsRequest$Outbound = {
   skip?: number | undefined;
   count?: number | undefined;
   issuedCardID?: string | undefined;
+  merchantName?: string | undefined;
   startDateTime?: string | undefined;
   endDateTime?: string | undefined;
 };
@@ -69,6 +78,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

@@ -12,6 +12,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

@@ -12,6 +12,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

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

package/src/models/operations/listresidualfees.ts

@@ -12,6 +12,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

@@ -12,6 +12,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

@@ -18,6 +18,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

@@ -20,6 +20,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

@@ -14,6 +14,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

@@ -12,6 +12,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

@@ -52,18 +52,17 @@ 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;
-  /**
-   * Optional comma-separated IDs to filter for transfers associated with specific card captures.
-   */
-  captureIDs?: Array<string> | undefined;
   /**
    * Optional, comma-separated transfer types by which the response is filtered.
    */
   transferTypes?: Array<components.TransferType> | undefined;
   skip?: number | undefined;
+  /**
+   * Page size. When omitted, the server defaults to `200`.
+   */
   count?: number | undefined;
   accountID: string;
 };
@@ -90,7 +89,6 @@ export const ListTransfersRequest$inboundSchema: z.ZodType<
   disputed: types.optional(types.boolean()),
   foreignID: types.optional(types.string()),
   authorizationIDs: types.optional(z.array(types.string())),
-  captureIDs: types.optional(z.array(types.string())),
   transferTypes: types.optional(z.array(components.TransferType$inboundSchema)),
   skip: types.optional(types.number()),
   count: types.optional(types.number()),
@@ -109,7 +107,6 @@ export type ListTransfersRequest$Outbound = {
   disputed?: boolean | undefined;
   foreignID?: string | undefined;
   authorizationIDs?: Array<string> | undefined;
-  captureIDs?: Array<string> | undefined;
   transferTypes?: Array<string> | undefined;
   skip?: number | undefined;
   count?: number | undefined;
@@ -133,7 +130,6 @@ export const ListTransfersRequest$outboundSchema: z.ZodType<
   disputed: z.boolean().optional(),
   foreignID: z.string().optional(),
   authorizationIDs: z.array(z.string()).optional(),
-  captureIDs: z.array(z.string()).optional(),
   transferTypes: z.array(components.TransferType$outboundSchema).optional(),
   skip: z.number().int().optional(),
   count: z.number().int().optional(),

package/src/models/operations/listwallets.ts

@@ -20,6 +20,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

@@ -13,6 +13,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

@@ -33,6 +33,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/bankaccounts.ts

@@ -4,13 +4,16 @@
 
 import { bankAccountsCompleteMicroDeposits } from "../funcs/bankAccountsCompleteMicroDeposits.js";
 import { bankAccountsCompleteVerification } from "../funcs/bankAccountsCompleteVerification.js";
+import { bankAccountsCreateAttestation } from "../funcs/bankAccountsCreateAttestation.js";
 import { bankAccountsDisable } from "../funcs/bankAccountsDisable.js";
 import { bankAccountsGet } from "../funcs/bankAccountsGet.js";
+import { bankAccountsGetAttestationEligibility } from "../funcs/bankAccountsGetAttestationEligibility.js";
 import { bankAccountsGetVerification } from "../funcs/bankAccountsGetVerification.js";
 import { bankAccountsInitiateMicroDeposits } from "../funcs/bankAccountsInitiateMicroDeposits.js";
 import { bankAccountsInitiateVerification } from "../funcs/bankAccountsInitiateVerification.js";
 import { bankAccountsLink } from "../funcs/bankAccountsLink.js";
 import { bankAccountsList } from "../funcs/bankAccountsList.js";
+import { bankAccountsListAttestations } from "../funcs/bankAccountsListAttestations.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
@@ -93,6 +96,66 @@ export class BankAccounts extends ClientSDK {
     ));
   }
 
+  /**
+   *   Submit a new authorization attestation for a bank account in an `errored` status due to an R29 ACH return (`Corporate Customer Advises Not Authorized`).
+   *
+   *   After obtaining new authorization from the receiver, submit an attestation with the date the authorization was obtained and a brief description of how the authorization was obtained. If the attestation is accepted, the bank account transitions from `errored` to `verified`.
+   *
+   *   Constraints
+   *
+   *   - The bank account's current errored status must be the result of an R29 return.
+   *   - `attestedAt` must be on or after the date of the bank account's most recent R29 return and cannot be a future date.
+   *   - Only one attestation may be submitted for a bank account. Use the [Get attestation eligibility](https://docs.moov.io/api/sources/bank-accounts/attestation-eligibility/) endpoint to confirm eligibility before submitting an attestation.
+   *
+   *   This endpoint is available only to allowlisted partners. Contact Moov Support for more information.
+   */
+  async createAttestation(
+    request: operations.CreateBankAccountAttestationRequest,
+    options?: RequestOptions,
+  ): Promise<operations.CreateBankAccountAttestationResponse> {
+    return unwrapAsync(bankAccountsCreateAttestation(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List the attestations submitted for a bank account.
+   */
+  async listAttestations(
+    request: operations.ListBankAccountAttestationsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ListBankAccountAttestationsResponse> {
+    return unwrapAsync(bankAccountsListAttestations(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Check whether a bank account is currently eligible for a new authorization attestation without submitting one.
+   *
+   * - `enabled` indicates whether the calling account has access to the attestations feature. If `enabled` is `false`, `eligible` is always `false`.
+   * - When `enabled` is `true`, `eligible` indicates whether the bank account currently meets the eligibility requirements for a new attestation: the bank account must be `errored` due to an R29 return, with no prior attestations.
+   *
+   * This endpoint always returns `200`, including when the bank account is not eligible. Check the `eligible` field to determine eligibility.
+   *
+   * To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
+   * you'll need to specify the `/accounts/{accountID}/bank-accounts.read` scope.
+   */
+  async getAttestationEligibility(
+    request: operations.GetBankAccountAttestationEligibilityRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetBankAccountAttestationEligibilityResponse> {
+    return unwrapAsync(bankAccountsGetAttestationEligibility(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * Micro-deposits help confirm bank account ownership, helping reduce fraud and the risk of unauthorized activity.
    * Use this method to initiate the micro-deposit verification, sending two small credit transfers to the bank account

package/src/sdk/cardissuing.ts

@@ -104,7 +104,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

@@ -152,6 +152,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.
    */
@@ -201,7 +204,8 @@ export class Transfers extends ClientSDK {
   }
 
   /**
-   * Create a capture against an authorized transfer.
+   * Create a capture against an auth-capture `card-payment` transfer.
+   * The `accountID` must identify the partner account for the transfer.
    *
    * To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
    * you'll need to specify the `/accounts/{accountID}/transfers.write` scope.
@@ -218,7 +222,7 @@ export class Transfers extends ClientSDK {
   }
 
   /**
-   * Get a list of captures for a transfer.
+   * Get a list of captures for an auth-capture `card-payment` transfer.
    *
    * To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
    * you'll need to specify the `/accounts/{accountID}/transfers.read` scope.
@@ -235,7 +239,7 @@ export class Transfers extends ClientSDK {
   }
 
   /**
-   * Get details of a capture for a transfer.
+   * Get details of a capture for an auth-capture `card-payment` transfer.
    *
    * To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
    * you'll need to specify the `/accounts/{accountID}/transfers.read` scope.
@@ -307,6 +311,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.
    *