mollie-api-typescript 0.8.4 → 0.8.5

package/src/models/captureresponse.ts

@@ -5,6 +5,8 @@
 import * as z from "zod/v3";
 import { remap as remap$ } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import {
   AmountNullable,
@@ -12,11 +14,6 @@ import {
   AmountNullable$Outbound,
   AmountNullable$outboundSchema,
 } from "./amountnullable.js";
-import {
-  CaptureStatus,
-  CaptureStatus$inboundSchema,
-  CaptureStatus$outboundSchema,
-} from "./capturestatus.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
 import {
   Metadata,
@@ -38,6 +35,40 @@ import {
   UrlNullable$outboundSchema,
 } from "./urlnullable.js";
 
+/**
+ * This optional field will contain the approximate amount that will be settled to your account, converted to the
+ *
+ * @remarks
+ * currency your account is settled in.
+ *
+ * Since the field contains an estimated amount during capture processing, it may change over time. To retrieve
+ * accurate settlement amounts we recommend using the [List balance transactions endpoint](list-balance-transactions)
+ * instead.
+ */
+export type CaptureResponseSettlementAmount = {
+  /**
+   * A three-character ISO 4217 currency code.
+   */
+  currency: string;
+  /**
+   * A string containing an exact monetary amount in the given currency.
+   */
+  value: string;
+};
+
+/**
+ * The capture's status.
+ */
+export const CaptureResponseStatus = {
+  Pending: "pending",
+  Succeeded: "succeeded",
+  Failed: "failed",
+} as const;
+/**
+ * The capture's status.
+ */
+export type CaptureResponseStatus = OpenEnum<typeof CaptureResponseStatus>;
+
 /**
  * An object with several relevant URLs. Every URL object will contain an `href` and a `type` field.
  */
@@ -69,6 +100,9 @@ export type CaptureResponse = {
    * Indicates the response contains a capture object. Will always contain the string `capture` for this endpoint.
    */
   resource: string;
+  /**
+   * The identifier uniquely referring to this capture. Example: `cpt_mNepDkEtco6ah3QNPUGYH`.
+   */
   id: string;
   /**
    * Whether this entity was created in live mode or in test mode.
@@ -83,13 +117,17 @@ export type CaptureResponse = {
    */
   amount: AmountNullable | null;
   /**
-   * In v2 endpoints, monetary amounts are represented as objects with a `currency` and `value` field.
-   */
-  settlementAmount?: AmountNullable | null | undefined;
-  /**
-   * The capture's status.
+   * This optional field will contain the approximate amount that will be settled to your account, converted to the
+   *
+   * @remarks
+   * currency your account is settled in.
+   *
+   * Since the field contains an estimated amount during capture processing, it may change over time. To retrieve
+   * accurate settlement amounts we recommend using the [List balance transactions endpoint](list-balance-transactions)
+   * instead.
    */
-  status: CaptureStatus;
+  settlementAmount?: CaptureResponseSettlementAmount | null | undefined;
+  status: CaptureResponseStatus;
   /**
    * Provide any data you like, for example a string or a JSON object. We will save the data alongside the entity. Whenever
    *
@@ -97,9 +135,27 @@ export type CaptureResponse = {
    * you fetch the entity with our API, we will also include the metadata. You can use up to approximately 1kB.
    */
   metadata?: Metadata | null | undefined;
+  /**
+   * The unique identifier of the payment this capture was created for. For example: `tr_5B8cwPMGnU6qLbRvo7qEZo`.
+   *
+   * @remarks
+   * The full payment object can be retrieved via the payment URL in the `_links` object.
+   */
   paymentId: string;
-  shipmentId?: string | undefined;
-  settlementId?: string | undefined;
+  /**
+   * The unique identifier of the shipment that triggered the creation of this capture, if applicable. For example:
+   *
+   * @remarks
+   * `shp_gNapNy9qQTUFZYnCrCF7J`.
+   */
+  shipmentId?: string | null | undefined;
+  /**
+   * The identifier referring to the settlement this capture was settled with. For example, `stl_BkEjN2eBb`. This field
+   *
+   * @remarks
+   * is omitted if the capture is not settled (yet).
+   */
+  settlementId?: string | null | undefined;
   /**
    * The entity's date and time of creation, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    */
@@ -110,6 +166,63 @@ export type CaptureResponse = {
   links: CaptureResponseLinks;
 };
 
+/** @internal */
+export const CaptureResponseSettlementAmount$inboundSchema: z.ZodType<
+  CaptureResponseSettlementAmount,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  currency: z.string(),
+  value: z.string(),
+});
+/** @internal */
+export type CaptureResponseSettlementAmount$Outbound = {
+  currency: string;
+  value: string;
+};
+
+/** @internal */
+export const CaptureResponseSettlementAmount$outboundSchema: z.ZodType<
+  CaptureResponseSettlementAmount$Outbound,
+  z.ZodTypeDef,
+  CaptureResponseSettlementAmount
+> = z.object({
+  currency: z.string(),
+  value: z.string(),
+});
+
+export function captureResponseSettlementAmountToJSON(
+  captureResponseSettlementAmount: CaptureResponseSettlementAmount,
+): string {
+  return JSON.stringify(
+    CaptureResponseSettlementAmount$outboundSchema.parse(
+      captureResponseSettlementAmount,
+    ),
+  );
+}
+export function captureResponseSettlementAmountFromJSON(
+  jsonString: string,
+): SafeParseResult<CaptureResponseSettlementAmount, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CaptureResponseSettlementAmount$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CaptureResponseSettlementAmount' from JSON`,
+  );
+}
+
+/** @internal */
+export const CaptureResponseStatus$inboundSchema: z.ZodType<
+  CaptureResponseStatus,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(CaptureResponseStatus);
+/** @internal */
+export const CaptureResponseStatus$outboundSchema: z.ZodType<
+  string,
+  z.ZodTypeDef,
+  CaptureResponseStatus
+> = openEnums.outboundSchema(CaptureResponseStatus);
+
 /** @internal */
 export const CaptureResponseLinks$inboundSchema: z.ZodType<
   CaptureResponseLinks,
@@ -172,12 +285,14 @@ export const CaptureResponse$inboundSchema: z.ZodType<
   mode: Mode$inboundSchema,
   description: z.string().optional(),
   amount: z.nullable(AmountNullable$inboundSchema),
-  settlementAmount: z.nullable(AmountNullable$inboundSchema).optional(),
-  status: CaptureStatus$inboundSchema,
+  settlementAmount: z.nullable(
+    z.lazy(() => CaptureResponseSettlementAmount$inboundSchema),
+  ).optional(),
+  status: CaptureResponseStatus$inboundSchema,
   metadata: z.nullable(Metadata$inboundSchema).optional(),
   paymentId: z.string(),
-  shipmentId: z.string().optional(),
-  settlementId: z.string().optional(),
+  shipmentId: z.nullable(z.string()).optional(),
+  settlementId: z.nullable(z.string()).optional(),
   createdAt: z.string(),
   _links: z.lazy(() => CaptureResponseLinks$inboundSchema),
 }).transform((v) => {
@@ -192,12 +307,15 @@ export type CaptureResponse$Outbound = {
   mode: string;
   description?: string | undefined;
   amount: AmountNullable$Outbound | null;
-  settlementAmount?: AmountNullable$Outbound | null | undefined;
+  settlementAmount?:
+    | CaptureResponseSettlementAmount$Outbound
+    | null
+    | undefined;
   status: string;
   metadata?: Metadata$Outbound | null | undefined;
   paymentId: string;
-  shipmentId?: string | undefined;
-  settlementId?: string | undefined;
+  shipmentId?: string | null | undefined;
+  settlementId?: string | null | undefined;
   createdAt: string;
   _links: CaptureResponseLinks$Outbound;
 };
@@ -213,12 +331,14 @@ export const CaptureResponse$outboundSchema: z.ZodType<
   mode: Mode$outboundSchema,
   description: z.string().optional(),
   amount: z.nullable(AmountNullable$outboundSchema),
-  settlementAmount: z.nullable(AmountNullable$outboundSchema).optional(),
-  status: CaptureStatus$outboundSchema,
+  settlementAmount: z.nullable(
+    z.lazy(() => CaptureResponseSettlementAmount$outboundSchema),
+  ).optional(),
+  status: CaptureResponseStatus$outboundSchema,
   metadata: z.nullable(Metadata$outboundSchema).optional(),
   paymentId: z.string(),
-  shipmentId: z.string().optional(),
-  settlementId: z.string().optional(),
+  shipmentId: z.nullable(z.string()).optional(),
+  settlementId: z.nullable(z.string()).optional(),
   createdAt: z.string(),
   links: z.lazy(() => CaptureResponseLinks$outboundSchema),
 }).transform((v) => {

package/src/models/componentssubtotals.ts

@@ -5,8 +5,37 @@
 import * as z from "zod/v3";
 import { remap as remap$ } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
-import { ClosedEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
+import {
+  BalanceCardAudience,
+  BalanceCardAudience$inboundSchema,
+  BalanceCardAudience$outboundSchema,
+} from "./balancecardaudience.js";
+import {
+  BalanceCardIssuer,
+  BalanceCardIssuer$inboundSchema,
+  BalanceCardIssuer$outboundSchema,
+} from "./balancecardissuer.js";
+import {
+  BalanceCardRegion,
+  BalanceCardRegion$inboundSchema,
+  BalanceCardRegion$outboundSchema,
+} from "./balancecardregion.js";
+import {
+  BalanceFeeType,
+  BalanceFeeType$inboundSchema,
+  BalanceFeeType$outboundSchema,
+} from "./balancefeetype.js";
+import {
+  BalancePrepaymentPartType,
+  BalancePrepaymentPartType$inboundSchema,
+  BalancePrepaymentPartType$outboundSchema,
+} from "./balanceprepaymentparttype.js";
+import {
+  BalanceTransactionType,
+  BalanceTransactionType$inboundSchema,
+  BalanceTransactionType$outboundSchema,
+} from "./balancetransactiontype.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
 import {
   PaymentMethod,
@@ -20,163 +49,6 @@ import {
   SubTotals$outboundSchema,
 } from "./subtotals.js";
 
-/**
- * In case of payments transactions with card, the card issuer will be available
- */
-export const ComponentsSubTotalsCardIssuer = {
-  Amex: "amex",
-  Maestro: "maestro",
-  CarteBancaire: "carte-bancaire",
-  Other: "other",
-} as const;
-/**
- * In case of payments transactions with card, the card issuer will be available
- */
-export type ComponentsSubTotalsCardIssuer = ClosedEnum<
-  typeof ComponentsSubTotalsCardIssuer
->;
-
-/**
- * In case of payments trnsactions with card, the card audience will be available.
- */
-export const ComponentsSubTotalsCardAudience = {
-  Corporate: "corporate",
-  Other: "other",
-} as const;
-/**
- * In case of payments trnsactions with card, the card audience will be available.
- */
-export type ComponentsSubTotalsCardAudience = ClosedEnum<
-  typeof ComponentsSubTotalsCardAudience
->;
-
-/**
- * In case of payments transactions with card, the card region will be available.
- */
-export const ComponentsSubTotalsCardRegion = {
-  IntraEea: "intra-eea",
-  IntraEu: "intra-eu",
-  Domestic: "domestic",
-  Other: "other",
-} as const;
-/**
- * In case of payments transactions with card, the card region will be available.
- */
-export type ComponentsSubTotalsCardRegion = ClosedEnum<
-  typeof ComponentsSubTotalsCardRegion
->;
-
-/**
- * Present when the transaction represents a fee.
- */
-export const ComponentsSubTotalsFeeType = {
-  PaymentFee: "payment-fee",
-  DirectDebitFailureFee: "direct-debit-failure-fee",
-  UnauthorizedDirectDebitFee: "unauthorized-direct-debit-fee",
-  BankChargedDirectDebitFailureFee: "bank-charged-direct-debit-failure-fee",
-  PartnerCommission: "partner-commission",
-  ApplicationFee: "application-fee",
-  CaptureFee: "capture-fee",
-  RefundFee: "refund-fee",
-  ChargebackFee: "chargeback-fee",
-  PaymentNotificationFee: "payment-notification-fee",
-  TransferNotificationFee: "transfer-notification-fee",
-  PayoutFee: "payout-fee",
-  FeeDiscount: "fee-discount",
-  FeeReimbursement: "fee-reimbursement",
-  PlatformVolumeFee: "platform-volume-fee",
-  PlatformConnectedOrganizationsFee: "platform-connected-organizations-fee",
-  BalanceChargeFee: "balance-charge-fee",
-  ThreedsAuthenticationAttemptFee: "3ds-authentication-attempt-fee",
-  TerminalMonthlyFee: "terminal-monthly-fee",
-  AcceptanceRiskFee: "acceptance-risk-fee",
-  TopUpFee: "top-up-fee",
-  PaymentGatewayFee: "payment-gateway-fee",
-  MastercardSpecialtyMerchantProgramProcessingFee:
-    "mastercard-specialty-merchant-program-processing-fee",
-  MastercardSpecialtyMerchantProgramRegistrationFee:
-    "mastercard-specialty-merchant-program-registration-fee",
-  VisaIntegrityRiskProgramProcessingFee:
-    "visa-integrity-risk-program-processing-fee",
-  VisaIntegrityRiskProgramRegistrationFee:
-    "visa-integrity-risk-program-registration-fee",
-  MinimumInvoiceAmountFee: "minimum-invoice-amount-fee",
-} as const;
-/**
- * Present when the transaction represents a fee.
- */
-export type ComponentsSubTotalsFeeType = ClosedEnum<
-  typeof ComponentsSubTotalsFeeType
->;
-
-/**
- * Prepayment part: fee itself, reimbursement, discount, VAT or rounding compensation.
- */
-export const ComponentsSubTotalsPrepaymentPartType = {
-  Fee: "fee",
-  FeeReimbursement: "fee-reimbursement",
-  FeeDiscount: "fee-discount",
-  FeeVat: "fee-vat",
-  FeeRoundingCompensation: "fee-rounding-compensation",
-} as const;
-/**
- * Prepayment part: fee itself, reimbursement, discount, VAT or rounding compensation.
- */
-export type ComponentsSubTotalsPrepaymentPartType = ClosedEnum<
-  typeof ComponentsSubTotalsPrepaymentPartType
->;
-
-/**
- * Represents the transaction type
- */
-export const ComponentsSubTotalsTransactionType = {
-  Payment: "payment",
-  SplitPayment: "split-payment",
-  FailedPayment: "failed-payment",
-  FailedPlatformSplitPayment: "failed-platform-split-payment",
-  FailedSplitPaymentCompensation: "failed-split-payment-compensation",
-  Capture: "capture",
-  SplitTransaction: "split-transaction",
-  Refund: "refund",
-  PlatformPaymentRefund: "platform-payment-refund",
-  ReturnedPlatformPaymentRefund: "returned-platform-payment-refund",
-  RefundCompensation: "refund-compensation",
-  ReturnedRefundCompensation: "returned-refund-compensation",
-  ReturnedRefund: "returned-refund",
-  Chargeback: "chargeback",
-  ChargebackReversal: "chargeback-reversal",
-  ChargebackCompensation: "chargeback-compensation",
-  ReversedChargebackCompensation: "reversed-chargeback-compensation",
-  PlatformPaymentChargeback: "platform-payment-chargeback",
-  ReversedPlatformPaymentChargeback: "reversed-platform-payment-chargeback",
-  FeePrepayment: "fee-prepayment",
-  OutgoingTransfer: "outgoing-transfer",
-  IncomingTransfer: "incoming-transfer",
-  CanceledTransfer: "canceled-transfer",
-  ReturnedTransfer: "returned-transfer",
-  BalanceReserve: "balance-reserve",
-  BalanceReserveReturn: "balance-reserve-return",
-  InvoiceRoundingCompensation: "invoice-rounding-compensation",
-  RollingReserveHold: "rolling-reserve-hold",
-  RollingReserveRelease: "rolling-reserve-release",
-  BalanceCorrection: "balance-correction",
-  Repayment: "repayment",
-  Loan: "loan",
-  BalanceTopup: "balance-topup",
-  CashCollateralIssuance: "cash-collateral-issuance';",
-  CashCollateralRelease: "cash-collateral-release",
-  PendingRollingReserve: "pending-rolling-reserve",
-  ToBeReleasedRollingReserve: "to-be-released-rolling-reserve",
-  HeldRollingReserve: "held-rolling-reserve",
-  ReleasedRollingReserve: "released-rolling-reserve",
-} as const;
-/**
- * Represents the transaction type
- */
-export type ComponentsSubTotalsTransactionType = ClosedEnum<
-  typeof ComponentsSubTotalsTransactionType
->;
-
 export type ComponentsSubTotals = {
   subTotals?: Array<SubTotals> | null | undefined;
   /**
@@ -187,87 +59,14 @@ export type ComponentsSubTotals = {
    * The payment method, if applicable
    */
   method?: PaymentMethod | null | undefined;
-  /**
-   * In case of payments transactions with card, the card issuer will be available
-   */
-  cardIssuer?: ComponentsSubTotalsCardIssuer | null | undefined;
-  /**
-   * In case of payments trnsactions with card, the card audience will be available.
-   */
-  cardAudience?: ComponentsSubTotalsCardAudience | null | undefined;
-  /**
-   * In case of payments transactions with card, the card region will be available.
-   */
-  cardRegion?: ComponentsSubTotalsCardRegion | null | undefined;
-  /**
-   * Present when the transaction represents a fee.
-   */
-  feeType?: ComponentsSubTotalsFeeType | null | undefined;
-  /**
-   * Prepayment part: fee itself, reimbursement, discount, VAT or rounding compensation.
-   */
-  prepaymentPartType?: ComponentsSubTotalsPrepaymentPartType | null | undefined;
-  /**
-   * Represents the transaction type
-   */
-  transactionType?: ComponentsSubTotalsTransactionType | null | undefined;
+  cardIssuer?: BalanceCardIssuer | undefined;
+  cardAudience?: BalanceCardAudience | undefined;
+  cardRegion?: BalanceCardRegion | undefined;
+  feeType?: BalanceFeeType | undefined;
+  prepaymentPartType?: BalancePrepaymentPartType | undefined;
+  transactionType?: BalanceTransactionType | undefined;
 };
 
-/** @internal */
-export const ComponentsSubTotalsCardIssuer$inboundSchema: z.ZodNativeEnum<
-  typeof ComponentsSubTotalsCardIssuer
-> = z.nativeEnum(ComponentsSubTotalsCardIssuer);
-/** @internal */
-export const ComponentsSubTotalsCardIssuer$outboundSchema: z.ZodNativeEnum<
-  typeof ComponentsSubTotalsCardIssuer
-> = ComponentsSubTotalsCardIssuer$inboundSchema;
-
-/** @internal */
-export const ComponentsSubTotalsCardAudience$inboundSchema: z.ZodNativeEnum<
-  typeof ComponentsSubTotalsCardAudience
-> = z.nativeEnum(ComponentsSubTotalsCardAudience);
-/** @internal */
-export const ComponentsSubTotalsCardAudience$outboundSchema: z.ZodNativeEnum<
-  typeof ComponentsSubTotalsCardAudience
-> = ComponentsSubTotalsCardAudience$inboundSchema;
-
-/** @internal */
-export const ComponentsSubTotalsCardRegion$inboundSchema: z.ZodNativeEnum<
-  typeof ComponentsSubTotalsCardRegion
-> = z.nativeEnum(ComponentsSubTotalsCardRegion);
-/** @internal */
-export const ComponentsSubTotalsCardRegion$outboundSchema: z.ZodNativeEnum<
-  typeof ComponentsSubTotalsCardRegion
-> = ComponentsSubTotalsCardRegion$inboundSchema;
-
-/** @internal */
-export const ComponentsSubTotalsFeeType$inboundSchema: z.ZodNativeEnum<
-  typeof ComponentsSubTotalsFeeType
-> = z.nativeEnum(ComponentsSubTotalsFeeType);
-/** @internal */
-export const ComponentsSubTotalsFeeType$outboundSchema: z.ZodNativeEnum<
-  typeof ComponentsSubTotalsFeeType
-> = ComponentsSubTotalsFeeType$inboundSchema;
-
-/** @internal */
-export const ComponentsSubTotalsPrepaymentPartType$inboundSchema:
-  z.ZodNativeEnum<typeof ComponentsSubTotalsPrepaymentPartType> = z.nativeEnum(
-    ComponentsSubTotalsPrepaymentPartType,
-  );
-/** @internal */
-export const ComponentsSubTotalsPrepaymentPartType$outboundSchema:
-  z.ZodNativeEnum<typeof ComponentsSubTotalsPrepaymentPartType> =
-    ComponentsSubTotalsPrepaymentPartType$inboundSchema;
-
-/** @internal */
-export const ComponentsSubTotalsTransactionType$inboundSchema: z.ZodNativeEnum<
-  typeof ComponentsSubTotalsTransactionType
-> = z.nativeEnum(ComponentsSubTotalsTransactionType);
-/** @internal */
-export const ComponentsSubTotalsTransactionType$outboundSchema: z.ZodNativeEnum<
-  typeof ComponentsSubTotalsTransactionType
-> = ComponentsSubTotalsTransactionType$inboundSchema;
-
 /** @internal */
 export const ComponentsSubTotals$inboundSchema: z.ZodType<
   ComponentsSubTotals,
@@ -277,18 +76,12 @@ export const ComponentsSubTotals$inboundSchema: z.ZodType<
   "sub-totals": z.nullable(z.array(SubTotals$inboundSchema)).optional(),
   count: z.number().int().optional(),
   method: z.nullable(PaymentMethod$inboundSchema).optional(),
-  cardIssuer: z.nullable(ComponentsSubTotalsCardIssuer$inboundSchema)
-    .optional(),
-  cardAudience: z.nullable(ComponentsSubTotalsCardAudience$inboundSchema)
-    .optional(),
-  cardRegion: z.nullable(ComponentsSubTotalsCardRegion$inboundSchema)
-    .optional(),
-  feeType: z.nullable(ComponentsSubTotalsFeeType$inboundSchema).optional(),
-  prepaymentPartType: z.nullable(
-    ComponentsSubTotalsPrepaymentPartType$inboundSchema,
-  ).optional(),
-  transactionType: z.nullable(ComponentsSubTotalsTransactionType$inboundSchema)
-    .optional(),
+  cardIssuer: BalanceCardIssuer$inboundSchema.optional(),
+  cardAudience: BalanceCardAudience$inboundSchema.optional(),
+  cardRegion: BalanceCardRegion$inboundSchema.optional(),
+  feeType: BalanceFeeType$inboundSchema.optional(),
+  prepaymentPartType: BalancePrepaymentPartType$inboundSchema.optional(),
+  transactionType: BalanceTransactionType$inboundSchema.optional(),
 }).transform((v) => {
   return remap$(v, {
     "sub-totals": "subTotals",
@@ -299,12 +92,12 @@ export type ComponentsSubTotals$Outbound = {
   "sub-totals"?: Array<SubTotals$Outbound> | null | undefined;
   count?: number | undefined;
   method?: string | null | undefined;
-  cardIssuer?: string | null | undefined;
-  cardAudience?: string | null | undefined;
-  cardRegion?: string | null | undefined;
-  feeType?: string | null | undefined;
-  prepaymentPartType?: string | null | undefined;
-  transactionType?: string | null | undefined;
+  cardIssuer?: string | undefined;
+  cardAudience?: string | undefined;
+  cardRegion?: string | undefined;
+  feeType?: string | undefined;
+  prepaymentPartType?: string | undefined;
+  transactionType?: string | undefined;
 };
 
 /** @internal */
@@ -316,18 +109,12 @@ export const ComponentsSubTotals$outboundSchema: z.ZodType<
   subTotals: z.nullable(z.array(SubTotals$outboundSchema)).optional(),
   count: z.number().int().optional(),
   method: z.nullable(PaymentMethod$outboundSchema).optional(),
-  cardIssuer: z.nullable(ComponentsSubTotalsCardIssuer$outboundSchema)
-    .optional(),
-  cardAudience: z.nullable(ComponentsSubTotalsCardAudience$outboundSchema)
-    .optional(),
-  cardRegion: z.nullable(ComponentsSubTotalsCardRegion$outboundSchema)
-    .optional(),
-  feeType: z.nullable(ComponentsSubTotalsFeeType$outboundSchema).optional(),
-  prepaymentPartType: z.nullable(
-    ComponentsSubTotalsPrepaymentPartType$outboundSchema,
-  ).optional(),
-  transactionType: z.nullable(ComponentsSubTotalsTransactionType$outboundSchema)
-    .optional(),
+  cardIssuer: BalanceCardIssuer$outboundSchema.optional(),
+  cardAudience: BalanceCardAudience$outboundSchema.optional(),
+  cardRegion: BalanceCardRegion$outboundSchema.optional(),
+  feeType: BalanceFeeType$outboundSchema.optional(),
+  prepaymentPartType: BalancePrepaymentPartType$outboundSchema.optional(),
+  transactionType: BalanceTransactionType$outboundSchema.optional(),
 }).transform((v) => {
   return remap$(v, {
     subTotals: "sub-totals",

package/src/models/customerresponse.ts

@@ -67,6 +67,9 @@ export type CustomerResponse = {
    * Indicates the response contains a customer object. Will always contain the string `customer` for this endpoint.
    */
   resource: string;
+  /**
+   * The identifier uniquely referring to this customer. Example: `cst_vsKJpSsabw`.
+   */
   id: string;
   /**
    * Whether this entity was created in live mode or in test mode.