@moovio/sdk 25.6.6 → 25.6.8

package/src/mcp-server/tools/transfersCreateCancellation.ts

@@ -14,6 +14,9 @@ export const tool$transfersCreateCancellation: ToolDefinition<typeof args> = {
   name: "transfers-create-cancellation",
   description: `  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.`,
   args,

package/src/mcp-server/tools/transfersCreateReversal.ts

@@ -13,7 +13,10 @@ const args = {
 export const tool$transfersCreateReversal: ToolDefinition<typeof args> = {
   name: "transfers-create-reversal",
   description:
-    `Reverses a card transfer by initiating a cancellation or refund depending on the transaction status. 
+    `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.
 

package/src/mcp-server/tools/transfersListCancellations.ts

@@ -13,7 +13,7 @@ const args = {
 export const tool$transfersListCancellations: ToolDefinition<typeof args> = {
   name: "transfers-list-cancellations",
   description: `  Get a list of cancellations for a transfer.
-  
+
   To access this endpoint using a [token](https://docs.moov.io/api/authentication/access-tokens/) you'll need 
   to specify the \`/accounts/{accountID}/transfers.read\` scope.`,
   args,

package/src/models/components/adjustmentfees.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 { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  BillingAdjustment,
+  BillingAdjustment$inboundSchema,
+  BillingAdjustment$Outbound,
+  BillingAdjustment$outboundSchema,
+} from "./billingadjustment.js";
+import {
+  BillingCountAndAmount,
+  BillingCountAndAmount$inboundSchema,
+  BillingCountAndAmount$Outbound,
+  BillingCountAndAmount$outboundSchema,
+} from "./billingcountandamount.js";
+
+/**
+ * A detailed breakdown of adjustment (correction) fees by fee name.
+ */
+export type AdjustmentFees = {
+  /**
+   * Adjustment fees grouped by fee name.
+   */
+  items: Array<BillingAdjustment>;
+  /**
+   * Total adjustment fees.
+   */
+  total: BillingCountAndAmount;
+};
+
+/** @internal */
+export const AdjustmentFees$inboundSchema: z.ZodType<
+  AdjustmentFees,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  items: z.array(BillingAdjustment$inboundSchema),
+  total: BillingCountAndAmount$inboundSchema,
+});
+/** @internal */
+export type AdjustmentFees$Outbound = {
+  items: Array<BillingAdjustment$Outbound>;
+  total: BillingCountAndAmount$Outbound;
+};
+
+/** @internal */
+export const AdjustmentFees$outboundSchema: z.ZodType<
+  AdjustmentFees$Outbound,
+  z.ZodTypeDef,
+  AdjustmentFees
+> = z.object({
+  items: z.array(BillingAdjustment$outboundSchema),
+  total: BillingCountAndAmount$outboundSchema,
+});
+
+export function adjustmentFeesToJSON(adjustmentFees: AdjustmentFees): string {
+  return JSON.stringify(AdjustmentFees$outboundSchema.parse(adjustmentFees));
+}
+export function adjustmentFeesFromJSON(
+  jsonString: string,
+): SafeParseResult<AdjustmentFees, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AdjustmentFees$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AdjustmentFees' from JSON`,
+  );
+}

package/src/models/components/applicationscope.ts

@@ -29,7 +29,7 @@ export const ApplicationScope = {
   FilesWrite: "files.write",
   IssuedCardsRead: "issued-cards.read",
   IssuedCardsWrite: "issued-cards.write",
-  IssuedCardsReadSecure: "issued-cards.read-secure",
+  IssuedCardsReadPrivate: "issued-cards.read-private",
   PaymentMethodsRead: "payment-methods.read",
   PingRead: "ping.read",
   ProfileEnrichmentRead: "profile-enrichment.read",

package/src/models/components/billingadjustment.ts

@@ -0,0 +1,77 @@
+/*
+ * 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";
+import {
+  AmountDecimal,
+  AmountDecimal$inboundSchema,
+  AmountDecimal$Outbound,
+  AmountDecimal$outboundSchema,
+} from "./amountdecimal.js";
+
+/**
+ * An adjustment (correction) fee grouped by its statement line-item name.
+ */
+export type BillingAdjustment = {
+  /**
+   * The name of the adjustment fee, shown as the statement line item.
+   */
+  feeName: string;
+  /**
+   * The number of adjustments with this fee name.
+   */
+  count: number;
+  /**
+   * The total amount for this fee name. May be negative for a credit/refund.
+   */
+  amount: AmountDecimal;
+};
+
+/** @internal */
+export const BillingAdjustment$inboundSchema: z.ZodType<
+  BillingAdjustment,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  feeName: z.string(),
+  count: z.number().int(),
+  amount: AmountDecimal$inboundSchema,
+});
+/** @internal */
+export type BillingAdjustment$Outbound = {
+  feeName: string;
+  count: number;
+  amount: AmountDecimal$Outbound;
+};
+
+/** @internal */
+export const BillingAdjustment$outboundSchema: z.ZodType<
+  BillingAdjustment$Outbound,
+  z.ZodTypeDef,
+  BillingAdjustment
+> = z.object({
+  feeName: z.string(),
+  count: z.number().int(),
+  amount: AmountDecimal$outboundSchema,
+});
+
+export function billingAdjustmentToJSON(
+  billingAdjustment: BillingAdjustment,
+): string {
+  return JSON.stringify(
+    BillingAdjustment$outboundSchema.parse(billingAdjustment),
+  );
+}
+export function billingAdjustmentFromJSON(
+  jsonString: string,
+): SafeParseResult<BillingAdjustment, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => BillingAdjustment$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'BillingAdjustment' from JSON`,
+  );
+}

package/src/models/components/billingsummary.ts

@@ -110,11 +110,11 @@ export type BillingSummaryPlatformFees = {
 };
 
 /**
- * The total amount of adjustment fees. This field is deprecated and will be removed in a future release.
+ * The total amount of adjustment fees. This field is deprecated and will be removed in a future release. Use adjustments.total.
  *
  * @deprecated class: This will be removed in a future release, please migrate away from it as soon as possible.
  */
-export type AdjustmentFees = {
+export type BillingSummaryAdjustmentFees = {
   /**
    * A 3-letter ISO 4217 currency code.
    */
@@ -176,11 +176,11 @@ export type BillingSummary = {
    */
   accountFees?: BillingSummaryDetails | undefined;
   /**
-   * The total amount of adjustment fees. This field is deprecated and will be removed in a future release.
+   * The total amount of adjustment fees. This field is deprecated and will be removed in a future release. Use adjustments.total.
    *
    * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
-  adjustmentFees?: AdjustmentFees | undefined;
+  adjustmentFees?: BillingSummaryAdjustmentFees | undefined;
   /**
    * The total amount of other card fees. This field is deprecated and will be removed in a future release. Use summary.otherCardFees.
    *
@@ -215,6 +215,10 @@ export type BillingSummary = {
    * Final partner payment after deducting monthlyPartnerCosts.
    */
   netPartnerPayment?: AmountDecimal | undefined;
+  /**
+   * Final partner payment after deducting monthlyPartnerCosts and any adjustments.
+   */
+  totalNetPartnerPayment?: AmountDecimal | undefined;
 };
 
 /** @internal */
@@ -357,8 +361,8 @@ export function billingSummaryPlatformFeesFromJSON(
 }
 
 /** @internal */
-export const AdjustmentFees$inboundSchema: z.ZodType<
-  AdjustmentFees,
+export const BillingSummaryAdjustmentFees$inboundSchema: z.ZodType<
+  BillingSummaryAdjustmentFees,
   z.ZodTypeDef,
   unknown
 > = z.object({
@@ -366,31 +370,37 @@ export const AdjustmentFees$inboundSchema: z.ZodType<
   valueDecimal: z.string(),
 });
 /** @internal */
-export type AdjustmentFees$Outbound = {
+export type BillingSummaryAdjustmentFees$Outbound = {
   currency: string;
   valueDecimal: string;
 };
 
 /** @internal */
-export const AdjustmentFees$outboundSchema: z.ZodType<
-  AdjustmentFees$Outbound,
+export const BillingSummaryAdjustmentFees$outboundSchema: z.ZodType<
+  BillingSummaryAdjustmentFees$Outbound,
   z.ZodTypeDef,
-  AdjustmentFees
+  BillingSummaryAdjustmentFees
 > = z.object({
   currency: z.string(),
   valueDecimal: z.string(),
 });
 
-export function adjustmentFeesToJSON(adjustmentFees: AdjustmentFees): string {
-  return JSON.stringify(AdjustmentFees$outboundSchema.parse(adjustmentFees));
+export function billingSummaryAdjustmentFeesToJSON(
+  billingSummaryAdjustmentFees: BillingSummaryAdjustmentFees,
+): string {
+  return JSON.stringify(
+    BillingSummaryAdjustmentFees$outboundSchema.parse(
+      billingSummaryAdjustmentFees,
+    ),
+  );
 }
-export function adjustmentFeesFromJSON(
+export function billingSummaryAdjustmentFeesFromJSON(
   jsonString: string,
-): SafeParseResult<AdjustmentFees, SDKValidationError> {
+): SafeParseResult<BillingSummaryAdjustmentFees, SDKValidationError> {
   return safeParse(
     jsonString,
-    (x) => AdjustmentFees$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'AdjustmentFees' from JSON`,
+    (x) => BillingSummaryAdjustmentFees$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'BillingSummaryAdjustmentFees' from JSON`,
   );
 }
 
@@ -444,7 +454,8 @@ export const BillingSummary$inboundSchema: z.ZodType<
   platformFees: z.lazy(() => BillingSummaryPlatformFees$inboundSchema)
     .optional(),
   accountFees: BillingSummaryDetails$inboundSchema.optional(),
-  adjustmentFees: z.lazy(() => AdjustmentFees$inboundSchema).optional(),
+  adjustmentFees: z.lazy(() => BillingSummaryAdjustmentFees$inboundSchema)
+    .optional(),
   otherFees: z.lazy(() => OtherFees$inboundSchema).optional(),
   otherCardFees: BillingSummaryDetails$inboundSchema.optional(),
   total: AmountDecimal$inboundSchema.optional(),
@@ -453,6 +464,7 @@ export const BillingSummary$inboundSchema: z.ZodType<
   residualSubtotal: AmountDecimal$inboundSchema.optional(),
   monthlyPartnerCosts: PartnerFees$inboundSchema.optional(),
   netPartnerPayment: AmountDecimal$inboundSchema.optional(),
+  totalNetPartnerPayment: AmountDecimal$inboundSchema.optional(),
 });
 /** @internal */
 export type BillingSummary$Outbound = {
@@ -461,7 +473,7 @@ export type BillingSummary$Outbound = {
   instantPayments?: BillingSummaryDetails$Outbound | undefined;
   platformFees?: BillingSummaryPlatformFees$Outbound | undefined;
   accountFees?: BillingSummaryDetails$Outbound | undefined;
-  adjustmentFees?: AdjustmentFees$Outbound | undefined;
+  adjustmentFees?: BillingSummaryAdjustmentFees$Outbound | undefined;
   otherFees?: OtherFees$Outbound | undefined;
   otherCardFees?: BillingSummaryDetails$Outbound | undefined;
   total?: AmountDecimal$Outbound | undefined;
@@ -470,6 +482,7 @@ export type BillingSummary$Outbound = {
   residualSubtotal?: AmountDecimal$Outbound | undefined;
   monthlyPartnerCosts?: PartnerFees$Outbound | undefined;
   netPartnerPayment?: AmountDecimal$Outbound | undefined;
+  totalNetPartnerPayment?: AmountDecimal$Outbound | undefined;
 };
 
 /** @internal */
@@ -484,7 +497,8 @@ export const BillingSummary$outboundSchema: z.ZodType<
   platformFees: z.lazy(() => BillingSummaryPlatformFees$outboundSchema)
     .optional(),
   accountFees: BillingSummaryDetails$outboundSchema.optional(),
-  adjustmentFees: z.lazy(() => AdjustmentFees$outboundSchema).optional(),
+  adjustmentFees: z.lazy(() => BillingSummaryAdjustmentFees$outboundSchema)
+    .optional(),
   otherFees: z.lazy(() => OtherFees$outboundSchema).optional(),
   otherCardFees: BillingSummaryDetails$outboundSchema.optional(),
   total: AmountDecimal$outboundSchema.optional(),
@@ -493,6 +507,7 @@ export const BillingSummary$outboundSchema: z.ZodType<
   residualSubtotal: AmountDecimal$outboundSchema.optional(),
   monthlyPartnerCosts: PartnerFees$outboundSchema.optional(),
   netPartnerPayment: AmountDecimal$outboundSchema.optional(),
+  totalNetPartnerPayment: AmountDecimal$outboundSchema.optional(),
 });
 
 export function billingSummaryToJSON(billingSummary: BillingSummary): string {

package/src/models/components/cancellation.ts

@@ -12,6 +12,9 @@ import {
   CancellationStatus$outboundSchema,
 } from "./cancellationstatus.js";
 
+/**
+ * Cancellation of a transfer.
+ */
 export type Cancellation = {
   cancellationID: string;
   status: CancellationStatus;

package/src/models/components/createdtransfer.ts

@@ -91,6 +91,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?: Amount | undefined;
   /**
    * An optional description of the transfer that is used on receipts and for your own internal use.

package/src/models/components/createfeeplanagreement.ts

@@ -9,9 +9,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 */
@@ -21,10 +35,12 @@ export const CreateFeePlanAgreement$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   planID: z.string(),
+  priorAgreementID: z.string().optional(),
 });
 /** @internal */
 export type CreateFeePlanAgreement$Outbound = {
   planID: string;
+  priorAgreementID?: string | undefined;
 };
 
 /** @internal */
@@ -34,6 +50,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

@@ -97,6 +97,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;
   /**
    * An optional collection of line items for a payment link.

package/src/models/components/createrefund.ts

@@ -16,7 +16,7 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  */
 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?: number | undefined;
 };

package/src/models/components/createreversal.ts

@@ -9,7 +9,12 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 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: number;
 };

package/src/models/components/facilitatorfee.ts

@@ -12,7 +12,7 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  */
 export type FacilitatorFee = {
   /**
-   * Total facilitator fee in cents. Only either `total` or `totalDecimal` can be set.
+   * Total facilitator fee.
    */
   total?: number | undefined;
   /**
@@ -24,7 +24,7 @@ export type FacilitatorFee = {
    */
   totalDecimal?: string | undefined;
   /**
-   * Markup facilitator fee in cents. Only either `markup` or `markupDecimal` can be set.
+   * Markup facilitator fee.
    */
   markup?: number | undefined;
   /**

package/src/models/components/feeplanagreement.ts

@@ -71,6 +71,14 @@ export type FeePlanAgreement = {
    * Fixed recurring amount paid in the billing period regardless of usage.
    */
   monthlyPlatformFee: MonthlyPlatformFee;
+  /**
+   * The agreement this one replaced. Only set when the agreement was created by replacing another.
+   */
+  priorAgreementID?: string | undefined;
+  /**
+   * The date and time the prior agreement was terminated.
+   */
+  priorAgreementTerminatedOn?: Date | undefined;
 };
 
 /** @internal */
@@ -90,6 +98,10 @@ export const FeePlanAgreement$inboundSchema: z.ZodType<
   billableFees: z.array(BillableFee$inboundSchema),
   minimumCommitment: MinimumCommitment$inboundSchema,
   monthlyPlatformFee: MonthlyPlatformFee$inboundSchema,
+  priorAgreementID: z.string().optional(),
+  priorAgreementTerminatedOn: z.string().datetime({ offset: true }).transform(
+    v => new Date(v)
+  ).optional(),
 });
 /** @internal */
 export type FeePlanAgreement$Outbound = {
@@ -104,6 +116,8 @@ export type FeePlanAgreement$Outbound = {
   billableFees: Array<BillableFee$Outbound>;
   minimumCommitment: MinimumCommitment$Outbound;
   monthlyPlatformFee: MonthlyPlatformFee$Outbound;
+  priorAgreementID?: string | undefined;
+  priorAgreementTerminatedOn?: string | undefined;
 };
 
 /** @internal */
@@ -123,6 +137,9 @@ export const FeePlanAgreement$outboundSchema: z.ZodType<
   billableFees: z.array(BillableFee$outboundSchema),
   minimumCommitment: MinimumCommitment$outboundSchema,
   monthlyPlatformFee: MonthlyPlatformFee$outboundSchema,
+  priorAgreementID: z.string().optional(),
+  priorAgreementTerminatedOn: z.date().transform(v => v.toISOString())
+    .optional(),
 });
 
 export function feePlanAgreementToJSON(

package/src/models/components/fullissuedcard.ts

@@ -80,6 +80,7 @@ export type FullIssuedCard = {
    * @remarks
    *
    * - `active`: The card is operational and can approve authorizations.
+   * - `frozen`: The card is temporarily suspended and cannot approve authorizations. A frozen card can be reactivated by setting its state back to `active`.
    * - `closed`: The card is permanently deactivated and cannot approve authorizations. A card can be closed by request or when it expires.
    */
   state: IssuedCardState;
@@ -87,6 +88,9 @@ export type FullIssuedCard = {
    * Specifies the type of spend card to be issued. Presently supports virtual only, providing a digital number without a physical card.
    */
   formFactor: IssuedCardFormFactor;
+  /**
+   * Mutable spend controls for the card.
+   */
   controls?: IssuingControls | undefined;
   createdOn: Date;
   updatedOn: Date;

package/src/models/components/index.ts

@@ -35,6 +35,7 @@ export * from "./addresserror.js";
 export * from "./addresssuggestion.js";
 export * from "./addressupdate.js";
 export * from "./adjustment.js";
+export * from "./adjustmentfees.js";
 export * from "./amount.js";
 export * from "./amountdecimal.js";
 export * from "./amountdecimalvalidationerror.js";
@@ -69,6 +70,7 @@ export * from "./bankaccountwaitfor.js";
 export * from "./basicpaymentmethod.js";
 export * from "./batchgettransfersrequest.js";
 export * from "./billablefee.js";
+export * from "./billingadjustment.js";
 export * from "./billingcountandamount.js";
 export * from "./billinginterchangeprogramfee.js";
 export * from "./billingsummary.js";
@@ -477,6 +479,7 @@ export * from "./webhookdatacapabilityupdated.js";
 export * from "./webhookdatacardautoupdated.js";
 export * from "./webhookdatadisputecreated.js";
 export * from "./webhookdatadisputeupdated.js";
+export * from "./webhookdataeventtest.js";
 export * from "./webhookdatainvoicecreated.js";
 export * from "./webhookdatainvoiceupdated.js";
 export * from "./webhookdatanetworkidupdated.js";

package/src/models/components/issuedcard.ts

@@ -77,6 +77,7 @@ export type IssuedCard = {
    * @remarks
    *
    * - `active`: The card is operational and can approve authorizations.
+   * - `frozen`: The card is temporarily suspended and cannot approve authorizations. A frozen card can be reactivated by setting its state back to `active`.
    * - `closed`: The card is permanently deactivated and cannot approve authorizations. A card can be closed by request or when it expires.
    */
   state: IssuedCardState;
@@ -84,6 +85,9 @@ export type IssuedCard = {
    * Specifies the type of spend card to be issued. Presently supports virtual only, providing a digital number without a physical card.
    */
   formFactor: IssuedCardFormFactor;
+  /**
+   * Mutable spend controls for the card.
+   */
   controls?: IssuingControls | undefined;
   createdOn: Date;
   updatedOn: Date;

package/src/models/components/issuedcardauthorization.ts

@@ -26,6 +26,10 @@ import {
 export type IssuedCardAuthorization = {
   authorizationID: string;
   issuedCardID: string;
+  /**
+   * Last four digits of the card number. Omitted for authorizations recorded before this was captured.
+   */
+  lastFourCardNumber?: string | undefined;
   fundingWalletID: string;
   /**
    * The name of the network a card transaction is routed through.
@@ -55,6 +59,7 @@ export const IssuedCardAuthorization$inboundSchema: z.ZodType<
 > = z.object({
   authorizationID: z.string(),
   issuedCardID: z.string(),
+  lastFourCardNumber: z.string().optional(),
   fundingWalletID: z.string(),
   network: CardIssuingNetwork$inboundSchema,
   authorizedAmount: z.string(),
@@ -67,6 +72,7 @@ export const IssuedCardAuthorization$inboundSchema: z.ZodType<
 export type IssuedCardAuthorization$Outbound = {
   authorizationID: string;
   issuedCardID: string;
+  lastFourCardNumber?: string | undefined;
   fundingWalletID: string;
   network: string;
   authorizedAmount: string;
@@ -84,6 +90,7 @@ export const IssuedCardAuthorization$outboundSchema: z.ZodType<
 > = z.object({
   authorizationID: z.string(),
   issuedCardID: z.string(),
+  lastFourCardNumber: z.string().optional(),
   fundingWalletID: z.string(),
   network: CardIssuingNetwork$outboundSchema,
   authorizedAmount: z.string(),

package/src/models/components/issuedcardstate.ts

@@ -11,10 +11,12 @@ import { ClosedEnum } from "../../types/enums.js";
  * @remarks
  *
  * - `active`: The card is operational and can approve authorizations.
+ * - `frozen`: The card is temporarily suspended and cannot approve authorizations. A frozen card can be reactivated by setting its state back to `active`.
  * - `closed`: The card is permanently deactivated and cannot approve authorizations. A card can be closed by request or when it expires.
  */
 export const IssuedCardState = {
   Active: "active",
+  Frozen: "frozen",
   Closed: "closed",
 } as const;
 /**
@@ -23,6 +25,7 @@ export const IssuedCardState = {
  * @remarks
  *
  * - `active`: The card is operational and can approve authorizations.
+ * - `frozen`: The card is temporarily suspended and cannot approve authorizations. A frozen card can be reactivated by setting its state back to `active`.
  * - `closed`: The card is permanently deactivated and cannot approve authorizations. A card can be closed by request or when it expires.
  */
 export type IssuedCardState = ClosedEnum<typeof IssuedCardState>;

package/src/models/components/issuedcardtransaction.ts

@@ -16,6 +16,10 @@ import {
 export type IssuedCardTransaction = {
   cardTransactionID: string;
   issuedCardID: string;
+  /**
+   * Last four digits of the card number. Omitted for transactions recorded before this was captured.
+   */
+  lastFourCardNumber?: string | undefined;
   fundingWalletID: string;
   /**
    * A decimal-formatted numerical string that represents up to 2 decimal place precision. In USD for example, 12.34 is $12.34 and 0.99 is $0.99.
@@ -35,6 +39,7 @@ export const IssuedCardTransaction$inboundSchema: z.ZodType<
 > = z.object({
   cardTransactionID: z.string(),
   issuedCardID: z.string(),
+  lastFourCardNumber: z.string().optional(),
   fundingWalletID: z.string(),
   amount: z.string(),
   authorizationID: z.string().optional(),
@@ -48,6 +53,7 @@ export const IssuedCardTransaction$inboundSchema: z.ZodType<
 export type IssuedCardTransaction$Outbound = {
   cardTransactionID: string;
   issuedCardID: string;
+  lastFourCardNumber?: string | undefined;
   fundingWalletID: string;
   amount: string;
   authorizationID?: string | undefined;
@@ -64,6 +70,7 @@ export const IssuedCardTransaction$outboundSchema: z.ZodType<
 > = z.object({
   cardTransactionID: z.string(),
   issuedCardID: z.string(),
+  lastFourCardNumber: z.string().optional(),
   fundingWalletID: z.string(),
   amount: z.string(),
   authorizationID: z.string().optional(),