increase 0.377.0 → 0.379.0

package/src/resources/card-payments.ts

@@ -1,9 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../resource';
-import { isRequestOptions } from '../core';
-import * as Core from '../core';
-import { Page, type PageParams } from '../pagination';
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { Page, type PageParams, PagePromise } from '../core/pagination';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
 
 export class CardPayments extends APIResource {
   /**
@@ -16,8 +17,8 @@ export class CardPayments extends APIResource {
    * );
    * ```
    */
-  retrieve(cardPaymentId: string, options?: Core.RequestOptions): Core.APIPromise<CardPayment> {
-    return this._client.get(`/card_payments/${cardPaymentId}`, options);
+  retrieve(cardPaymentID: string, options?: RequestOptions): APIPromise<CardPayment> {
+    return this._client.get(path`/card_payments/${cardPaymentID}`, options);
   }
 
   /**
@@ -32,22 +33,14 @@ export class CardPayments extends APIResource {
    * ```
    */
   list(
-    query?: CardPaymentListParams,
-    options?: Core.RequestOptions,
-  ): Core.PagePromise<CardPaymentsPage, CardPayment>;
-  list(options?: Core.RequestOptions): Core.PagePromise<CardPaymentsPage, CardPayment>;
-  list(
-    query: CardPaymentListParams | Core.RequestOptions = {},
-    options?: Core.RequestOptions,
-  ): Core.PagePromise<CardPaymentsPage, CardPayment> {
-    if (isRequestOptions(query)) {
-      return this.list({}, query);
-    }
-    return this._client.getAPIList('/card_payments', CardPaymentsPage, { query, ...options });
+    query: CardPaymentListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<CardPaymentsPage, CardPayment> {
+    return this._client.getAPIList('/card_payments', Page<CardPayment>, { query, ...options });
   }
 }
 
-export class CardPaymentsPage extends Page<CardPayment> {}
+export type CardPaymentsPage = Page<CardPayment>;
 
 /**
  * Card Payments group together interactions related to a single card payment, such
@@ -127,6 +120,15 @@ export namespace CardPayment {
      */
     card_authorization_expiration: Element.CardAuthorizationExpiration | null;
 
+    /**
+     * A Card Balance Inquiry object. This field will be present in the JSON response
+     * if and only if `category` is equal to `card_balance_inquiry`. Card Balance
+     * Inquiries are transactions that allow merchants to check the available balance
+     * on a card without placing a hold on funds, commonly used when a customer
+     * requests their balance at an ATM.
+     */
+    card_balance_inquiry: Element.CardBalanceInquiry | null;
+
     /**
      * A Card Decline object. This field will be present in the JSON response if and
      * only if `category` is equal to `card_decline`.
@@ -196,6 +198,8 @@ export namespace CardPayment {
      *   `card_authorization` object.
      * - `card_authentication` - Card Authentication: details will be under the
      *   `card_authentication` object.
+     * - `card_balance_inquiry` - Card Balance Inquiry: details will be under the
+     *   `card_balance_inquiry` object.
      * - `card_validation` - Inbound Card Validation: details will be under the
      *   `card_validation` object.
      * - `card_decline` - Card Decline: details will be under the `card_decline`
@@ -218,6 +222,7 @@ export namespace CardPayment {
     category:
       | 'card_authorization'
       | 'card_authentication'
+      | 'card_balance_inquiry'
       | 'card_validation'
       | 'card_decline'
       | 'card_reversal'
@@ -331,155 +336,903 @@ export namespace CardPayment {
       merchant_country: string;
 
       /**
-       * The name of the merchant.
+       * The name of the merchant.
+       */
+      merchant_name: string;
+
+      /**
+       * The purchase amount in minor units.
+       */
+      purchase_amount: number | null;
+
+      /**
+       * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
+       * authentication attempt's purchase currency.
+       */
+      purchase_currency: string | null;
+
+      /**
+       * The identifier of the Real-Time Decision sent to approve or decline this
+       * authentication attempt.
+       */
+      real_time_decision_id: string | null;
+
+      /**
+       * The status of the card authentication.
+       *
+       * - `denied` - The authentication attempt was denied.
+       * - `authenticated_with_challenge` - The authentication attempt was authenticated
+       *   with a challenge.
+       * - `authenticated_without_challenge` - The authentication attempt was
+       *   authenticated without a challenge.
+       * - `awaiting_challenge` - The authentication attempt is awaiting a challenge.
+       * - `validating_challenge` - The authentication attempt is validating a challenge.
+       * - `canceled` - The authentication attempt was canceled.
+       * - `timed_out_awaiting_challenge` - The authentication attempt timed out while
+       *   awaiting a challenge.
+       * - `errored` - The authentication attempt errored.
+       * - `exceeded_attempt_threshold` - The authentication attempt exceeded the attempt
+       *   threshold.
+       */
+      status:
+        | 'denied'
+        | 'authenticated_with_challenge'
+        | 'authenticated_without_challenge'
+        | 'awaiting_challenge'
+        | 'validating_challenge'
+        | 'canceled'
+        | 'timed_out_awaiting_challenge'
+        | 'errored'
+        | 'exceeded_attempt_threshold';
+
+      /**
+       * A constant representing the object's type. For this resource it will always be
+       * `card_authentication`.
+       */
+      type: 'card_authentication';
+
+      [k: string]: unknown;
+    }
+
+    export namespace CardAuthentication {
+      /**
+       * Details about the challenge, if one was requested.
+       */
+      export interface Challenge {
+        /**
+         * Details about the challenge verification attempts, if any happened.
+         */
+        attempts: Array<Challenge.Attempt>;
+
+        /**
+         * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Card
+         * Authentication Challenge was started.
+         */
+        created_at: string;
+
+        /**
+         * The one-time code used for the Card Authentication Challenge.
+         */
+        one_time_code: string;
+
+        /**
+         * The method used to verify the Card Authentication Challenge.
+         *
+         * - `text_message` - The one-time code was sent via text message.
+         * - `email` - The one-time code was sent via email.
+         * - `none_available` - The one-time code was not successfully delivered.
+         */
+        verification_method: 'text_message' | 'email' | 'none_available';
+
+        /**
+         * E.g., the email address or phone number used for the Card Authentication
+         * Challenge.
+         */
+        verification_value: string | null;
+      }
+
+      export namespace Challenge {
+        export interface Attempt {
+          /**
+           * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time of the Card
+           * Authentication Challenge Attempt.
+           */
+          created_at: string;
+
+          /**
+           * The outcome of the Card Authentication Challenge Attempt.
+           *
+           * - `successful` - The attempt was successful.
+           * - `failed` - The attempt was unsuccessful.
+           */
+          outcome: 'successful' | 'failed';
+        }
+      }
+    }
+
+    /**
+     * A Card Authorization object. This field will be present in the JSON response if
+     * and only if `category` is equal to `card_authorization`. Card Authorizations are
+     * temporary holds placed on a customers funds with the intent to later clear a
+     * transaction.
+     */
+    export interface CardAuthorization {
+      /**
+       * The Card Authorization identifier.
+       */
+      id: string;
+
+      /**
+       * Whether this authorization was approved by Increase, the card network through
+       * stand-in processing, or the user through a real-time decision.
+       *
+       * - `user` - This object was actioned by the user through a real-time decision.
+       * - `increase` - This object was actioned by Increase without user intervention.
+       * - `network` - This object was actioned by the network, through stand-in
+       *   processing.
+       */
+      actioner: 'user' | 'increase' | 'network';
+
+      /**
+       * Additional amounts associated with the card authorization, such as ATM
+       * surcharges fees. These are usually a subset of the `amount` field and are used
+       * to provide more detailed information about the transaction.
+       */
+      additional_amounts: CardAuthorization.AdditionalAmounts;
+
+      /**
+       * The pending amount in the minor unit of the transaction's currency. For dollars,
+       * for example, this is cents.
+       */
+      amount: number;
+
+      /**
+       * The ID of the Card Payment this transaction belongs to.
+       */
+      card_payment_id: string;
+
+      /**
+       * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
+       * transaction's currency.
+       *
+       * - `USD` - US Dollar (USD)
+       */
+      currency: 'USD';
+
+      /**
+       * If the authorization was made via a Digital Wallet Token (such as an Apple Pay
+       * purchase), the identifier of the token that was used.
+       */
+      digital_wallet_token_id: string | null;
+
+      /**
+       * The direction describes the direction the funds will move, either from the
+       * cardholder to the merchant or from the merchant to the cardholder.
+       *
+       * - `settlement` - A regular card authorization where funds are debited from the
+       *   cardholder.
+       * - `refund` - A refund card authorization, sometimes referred to as a credit
+       *   voucher authorization, where funds are credited to the cardholder.
+       */
+      direction: 'settlement' | 'refund';
+
+      /**
+       * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) when this authorization
+       * will expire and the pending transaction will be released.
+       */
+      expires_at: string;
+
+      /**
+       * The merchant identifier (commonly abbreviated as MID) of the merchant the card
+       * is transacting with.
+       */
+      merchant_acceptor_id: string;
+
+      /**
+       * The Merchant Category Code (commonly abbreviated as MCC) of the merchant the
+       * card is transacting with.
+       */
+      merchant_category_code: string;
+
+      /**
+       * The city the merchant resides in.
+       */
+      merchant_city: string | null;
+
+      /**
+       * The country the merchant resides in.
+       */
+      merchant_country: string;
+
+      /**
+       * The merchant descriptor of the merchant the card is transacting with.
+       */
+      merchant_descriptor: string;
+
+      /**
+       * The merchant's postal code. For US merchants this is either a 5-digit or 9-digit
+       * ZIP code, where the first 5 and last 4 are separated by a dash.
+       */
+      merchant_postal_code: string | null;
+
+      /**
+       * The state the merchant resides in.
+       */
+      merchant_state: string | null;
+
+      /**
+       * Fields specific to the `network`.
+       */
+      network_details: CardAuthorization.NetworkDetails;
+
+      /**
+       * Network-specific identifiers for a specific request or transaction.
+       */
+      network_identifiers: CardAuthorization.NetworkIdentifiers;
+
+      /**
+       * The risk score generated by the card network. For Visa this is the Visa Advanced
+       * Authorization risk score, from 0 to 99, where 99 is the riskiest. For Pulse the
+       * score is from 0 to 999, where 999 is the riskiest.
+       */
+      network_risk_score: number | null;
+
+      /**
+       * The identifier of the Pending Transaction associated with this Transaction.
+       */
+      pending_transaction_id: string | null;
+
+      /**
+       * If the authorization was made in-person with a physical card, the Physical Card
+       * that was used.
+       */
+      physical_card_id: string | null;
+
+      /**
+       * The pending amount in the minor unit of the transaction's presentment currency.
+       */
+      presentment_amount: number;
+
+      /**
+       * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
+       * transaction's presentment currency.
+       */
+      presentment_currency: string;
+
+      /**
+       * The processing category describes the intent behind the authorization, such as
+       * whether it was used for bill payments or an automatic fuel dispenser.
+       *
+       * - `account_funding` - Account funding transactions are transactions used to
+       *   e.g., fund an account or transfer funds between accounts.
+       * - `automatic_fuel_dispenser` - Automatic fuel dispenser authorizations occur
+       *   when a card is used at a gas pump, prior to the actual transaction amount
+       *   being known. They are followed by an advice message that updates the amount of
+       *   the pending transaction.
+       * - `bill_payment` - A transaction used to pay a bill.
+       * - `original_credit` - Original credit transactions are used to send money to a
+       *   cardholder.
+       * - `purchase` - A regular purchase.
+       * - `quasi_cash` - Quasi-cash transactions represent purchases of items which may
+       *   be convertible to cash.
+       * - `refund` - A refund card authorization, sometimes referred to as a credit
+       *   voucher authorization, where funds are credited to the cardholder.
+       * - `cash_disbursement` - Cash disbursement transactions are used to withdraw cash
+       *   from an ATM or a point of sale.
+       * - `balance_inquiry` - A balance inquiry transaction is used to check the balance
+       *   of an account associated with a card.
+       * - `unknown` - The processing category is unknown.
+       */
+      processing_category:
+        | 'account_funding'
+        | 'automatic_fuel_dispenser'
+        | 'bill_payment'
+        | 'original_credit'
+        | 'purchase'
+        | 'quasi_cash'
+        | 'refund'
+        | 'cash_disbursement'
+        | 'balance_inquiry'
+        | 'unknown';
+
+      /**
+       * The identifier of the Real-Time Decision sent to approve or decline this
+       * transaction.
+       */
+      real_time_decision_id: string | null;
+
+      /**
+       * The terminal identifier (commonly abbreviated as TID) of the terminal the card
+       * is transacting with.
+       */
+      terminal_id: string | null;
+
+      /**
+       * A constant representing the object's type. For this resource it will always be
+       * `card_authorization`.
+       */
+      type: 'card_authorization';
+
+      /**
+       * Fields related to verification of cardholder-provided values.
+       */
+      verification: CardAuthorization.Verification;
+
+      [k: string]: unknown;
+    }
+
+    export namespace CardAuthorization {
+      /**
+       * Additional amounts associated with the card authorization, such as ATM
+       * surcharges fees. These are usually a subset of the `amount` field and are used
+       * to provide more detailed information about the transaction.
+       */
+      export interface AdditionalAmounts {
+        /**
+         * The part of this transaction amount that was for clinic-related services.
+         */
+        clinic: AdditionalAmounts.Clinic | null;
+
+        /**
+         * The part of this transaction amount that was for dental-related services.
+         */
+        dental: AdditionalAmounts.Dental | null;
+
+        /**
+         * The original pre-authorized amount.
+         */
+        original: AdditionalAmounts.Original | null;
+
+        /**
+         * The part of this transaction amount that was for healthcare prescriptions.
+         */
+        prescription: AdditionalAmounts.Prescription | null;
+
+        /**
+         * The surcharge amount charged for this transaction by the merchant.
+         */
+        surcharge: AdditionalAmounts.Surcharge | null;
+
+        /**
+         * The total amount of a series of incremental authorizations, optionally provided.
+         */
+        total_cumulative: AdditionalAmounts.TotalCumulative | null;
+
+        /**
+         * The total amount of healthcare-related additional amounts.
+         */
+        total_healthcare: AdditionalAmounts.TotalHealthcare | null;
+
+        /**
+         * The part of this transaction amount that was for transit-related services.
+         */
+        transit: AdditionalAmounts.Transit | null;
+
+        /**
+         * An unknown additional amount.
+         */
+        unknown: AdditionalAmounts.Unknown | null;
+
+        /**
+         * The part of this transaction amount that was for vision-related services.
+         */
+        vision: AdditionalAmounts.Vision | null;
+      }
+
+      export namespace AdditionalAmounts {
+        /**
+         * The part of this transaction amount that was for clinic-related services.
+         */
+        export interface Clinic {
+          /**
+           * The amount in minor units of the `currency` field. The amount is positive if it
+           * is added to the amount (such as an ATM surcharge fee) and negative if it is
+           * subtracted from the amount (such as a discount).
+           */
+          amount: number;
+
+          /**
+           * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+           * amount's currency.
+           */
+          currency: string;
+        }
+
+        /**
+         * The part of this transaction amount that was for dental-related services.
+         */
+        export interface Dental {
+          /**
+           * The amount in minor units of the `currency` field. The amount is positive if it
+           * is added to the amount (such as an ATM surcharge fee) and negative if it is
+           * subtracted from the amount (such as a discount).
+           */
+          amount: number;
+
+          /**
+           * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+           * amount's currency.
+           */
+          currency: string;
+        }
+
+        /**
+         * The original pre-authorized amount.
+         */
+        export interface Original {
+          /**
+           * The amount in minor units of the `currency` field. The amount is positive if it
+           * is added to the amount (such as an ATM surcharge fee) and negative if it is
+           * subtracted from the amount (such as a discount).
+           */
+          amount: number;
+
+          /**
+           * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+           * amount's currency.
+           */
+          currency: string;
+        }
+
+        /**
+         * The part of this transaction amount that was for healthcare prescriptions.
+         */
+        export interface Prescription {
+          /**
+           * The amount in minor units of the `currency` field. The amount is positive if it
+           * is added to the amount (such as an ATM surcharge fee) and negative if it is
+           * subtracted from the amount (such as a discount).
+           */
+          amount: number;
+
+          /**
+           * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+           * amount's currency.
+           */
+          currency: string;
+        }
+
+        /**
+         * The surcharge amount charged for this transaction by the merchant.
+         */
+        export interface Surcharge {
+          /**
+           * The amount in minor units of the `currency` field. The amount is positive if it
+           * is added to the amount (such as an ATM surcharge fee) and negative if it is
+           * subtracted from the amount (such as a discount).
+           */
+          amount: number;
+
+          /**
+           * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+           * amount's currency.
+           */
+          currency: string;
+        }
+
+        /**
+         * The total amount of a series of incremental authorizations, optionally provided.
+         */
+        export interface TotalCumulative {
+          /**
+           * The amount in minor units of the `currency` field. The amount is positive if it
+           * is added to the amount (such as an ATM surcharge fee) and negative if it is
+           * subtracted from the amount (such as a discount).
+           */
+          amount: number;
+
+          /**
+           * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+           * amount's currency.
+           */
+          currency: string;
+        }
+
+        /**
+         * The total amount of healthcare-related additional amounts.
+         */
+        export interface TotalHealthcare {
+          /**
+           * The amount in minor units of the `currency` field. The amount is positive if it
+           * is added to the amount (such as an ATM surcharge fee) and negative if it is
+           * subtracted from the amount (such as a discount).
+           */
+          amount: number;
+
+          /**
+           * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+           * amount's currency.
+           */
+          currency: string;
+        }
+
+        /**
+         * The part of this transaction amount that was for transit-related services.
+         */
+        export interface Transit {
+          /**
+           * The amount in minor units of the `currency` field. The amount is positive if it
+           * is added to the amount (such as an ATM surcharge fee) and negative if it is
+           * subtracted from the amount (such as a discount).
+           */
+          amount: number;
+
+          /**
+           * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+           * amount's currency.
+           */
+          currency: string;
+        }
+
+        /**
+         * An unknown additional amount.
+         */
+        export interface Unknown {
+          /**
+           * The amount in minor units of the `currency` field. The amount is positive if it
+           * is added to the amount (such as an ATM surcharge fee) and negative if it is
+           * subtracted from the amount (such as a discount).
+           */
+          amount: number;
+
+          /**
+           * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+           * amount's currency.
+           */
+          currency: string;
+        }
+
+        /**
+         * The part of this transaction amount that was for vision-related services.
+         */
+        export interface Vision {
+          /**
+           * The amount in minor units of the `currency` field. The amount is positive if it
+           * is added to the amount (such as an ATM surcharge fee) and negative if it is
+           * subtracted from the amount (such as a discount).
+           */
+          amount: number;
+
+          /**
+           * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional
+           * amount's currency.
+           */
+          currency: string;
+        }
+      }
+
+      /**
+       * Fields specific to the `network`.
+       */
+      export interface NetworkDetails {
+        /**
+         * The payment network used to process this card authorization.
+         *
+         * - `visa` - Visa
+         * - `pulse` - Pulse
+         */
+        category: 'visa' | 'pulse';
+
+        /**
+         * Fields specific to the `pulse` network.
+         */
+        pulse: NetworkDetails.Pulse | null;
+
+        /**
+         * Fields specific to the `visa` network.
+         */
+        visa: NetworkDetails.Visa | null;
+      }
+
+      export namespace NetworkDetails {
+        /**
+         * Fields specific to the `pulse` network.
+         */
+        export interface Pulse {}
+
+        /**
+         * Fields specific to the `visa` network.
+         */
+        export interface Visa {
+          /**
+           * For electronic commerce transactions, this identifies the level of security used
+           * in obtaining the customer's payment credential. For mail or telephone order
+           * transactions, identifies the type of mail or telephone order.
+           *
+           * - `mail_phone_order` - Single transaction of a mail/phone order: Use to indicate
+           *   that the transaction is a mail/phone order purchase, not a recurring
+           *   transaction or installment payment. For domestic transactions in the US
+           *   region, this value may also indicate one bill payment transaction in the
+           *   card-present or card-absent environments.
+           * - `recurring` - Recurring transaction: Payment indicator used to indicate a
+           *   recurring transaction that originates from an acquirer in the US region.
+           * - `installment` - Installment payment: Payment indicator used to indicate one
+           *   purchase of goods or services that is billed to the account in multiple
+           *   charges over a period of time agreed upon by the cardholder and merchant from
+           *   transactions that originate from an acquirer in the US region.
+           * - `unknown_mail_phone_order` - Unknown classification: other mail order: Use to
+           *   indicate that the type of mail/telephone order is unknown.
+           * - `secure_electronic_commerce` - Secure electronic commerce transaction: Use to
+           *   indicate that the electronic commerce transaction has been authenticated using
+           *   e.g., 3-D Secure
+           * - `non_authenticated_security_transaction_at_3ds_capable_merchant` -
+           *   Non-authenticated security transaction at a 3-D Secure-capable merchant, and
+           *   merchant attempted to authenticate the cardholder using 3-D Secure: Use to
+           *   identify an electronic commerce transaction where the merchant attempted to
+           *   authenticate the cardholder using 3-D Secure, but was unable to complete the
+           *   authentication because the issuer or cardholder does not participate in the
+           *   3-D Secure program.
+           * - `non_authenticated_security_transaction` - Non-authenticated security
+           *   transaction: Use to identify an electronic commerce transaction that uses data
+           *   encryption for security however, cardholder authentication is not performed
+           *   using 3-D Secure.
+           * - `non_secure_transaction` - Non-secure transaction: Use to identify an
+           *   electronic commerce transaction that has no data protection.
+           */
+          electronic_commerce_indicator:
+            | 'mail_phone_order'
+            | 'recurring'
+            | 'installment'
+            | 'unknown_mail_phone_order'
+            | 'secure_electronic_commerce'
+            | 'non_authenticated_security_transaction_at_3ds_capable_merchant'
+            | 'non_authenticated_security_transaction'
+            | 'non_secure_transaction'
+            | null;
+
+          /**
+           * The method used to enter the cardholder's primary account number and card
+           * expiration date.
+           *
+           * - `unknown` - Unknown
+           * - `manual` - Manual key entry
+           * - `magnetic_stripe_no_cvv` - Magnetic stripe read, without card verification
+           *   value
+           * - `optical_code` - Optical code
+           * - `integrated_circuit_card` - Contact chip card
+           * - `contactless` - Contactless read of chip card
+           * - `credential_on_file` - Transaction initiated using a credential that has
+           *   previously been stored on file
+           * - `magnetic_stripe` - Magnetic stripe read
+           * - `contactless_magnetic_stripe` - Contactless read of magnetic stripe data
+           * - `integrated_circuit_card_no_cvv` - Contact chip card, without card
+           *   verification value
+           */
+          point_of_service_entry_mode:
+            | 'unknown'
+            | 'manual'
+            | 'magnetic_stripe_no_cvv'
+            | 'optical_code'
+            | 'integrated_circuit_card'
+            | 'contactless'
+            | 'credential_on_file'
+            | 'magnetic_stripe'
+            | 'contactless_magnetic_stripe'
+            | 'integrated_circuit_card_no_cvv'
+            | null;
+
+          /**
+           * Only present when `actioner: network`. Describes why a card authorization was
+           * approved or declined by Visa through stand-in processing.
+           *
+           * - `issuer_error` - Increase failed to process the authorization in a timely
+           *   manner.
+           * - `invalid_physical_card` - The physical card read had an invalid CVV, dCVV, or
+           *   authorization request cryptogram.
+           * - `invalid_cardholder_authentication_verification_value` - The 3DS cardholder
+           *   authentication verification value was invalid.
+           * - `internal_visa_error` - An internal Visa error occurred. Visa uses this reason
+           *   code for certain expected occurrences as well, such as Application Transaction
+           *   Counter (ATC) replays.
+           * - `merchant_transaction_advisory_service_authentication_required` - The merchant
+           *   has enabled Visa's Transaction Advisory Service and requires further
+           *   authentication to perform the transaction. In practice this is often utilized
+           *   at fuel pumps to tell the cardholder to see the cashier.
+           * - `payment_fraud_disruption_acquirer_block` - The transaction was blocked by
+           *   Visa's Payment Fraud Disruption service due to fraudulent Acquirer behavior,
+           *   such as card testing.
+           * - `other` - An unspecific reason for stand-in processing.
+           */
+          stand_in_processing_reason:
+            | 'issuer_error'
+            | 'invalid_physical_card'
+            | 'invalid_cardholder_authentication_verification_value'
+            | 'internal_visa_error'
+            | 'merchant_transaction_advisory_service_authentication_required'
+            | 'payment_fraud_disruption_acquirer_block'
+            | 'other'
+            | null;
+        }
+      }
+
+      /**
+       * Network-specific identifiers for a specific request or transaction.
+       */
+      export interface NetworkIdentifiers {
+        /**
+         * The randomly generated 6-character Authorization Identification Response code
+         * sent back to the acquirer in an approved response.
+         */
+        authorization_identification_response: string | null;
+
+        /**
+         * A life-cycle identifier used across e.g., an authorization and a reversal.
+         * Expected to be unique per acquirer within a window of time. For some card
+         * networks the retrieval reference number includes the trace counter.
+         */
+        retrieval_reference_number: string | null;
+
+        /**
+         * A counter used to verify an individual authorization. Expected to be unique per
+         * acquirer within a window of time.
+         */
+        trace_number: string | null;
+
+        /**
+         * A globally unique transaction identifier provided by the card network, used
+         * across multiple life-cycle requests.
+         */
+        transaction_id: string | null;
+      }
+
+      /**
+       * Fields related to verification of cardholder-provided values.
+       */
+      export interface Verification {
+        /**
+         * Fields related to verification of the Card Verification Code, a 3-digit code on
+         * the back of the card.
+         */
+        card_verification_code: Verification.CardVerificationCode;
+
+        /**
+         * Cardholder address provided in the authorization request and the address on file
+         * we verified it against.
+         */
+        cardholder_address: Verification.CardholderAddress;
+      }
+
+      export namespace Verification {
+        /**
+         * Fields related to verification of the Card Verification Code, a 3-digit code on
+         * the back of the card.
+         */
+        export interface CardVerificationCode {
+          /**
+           * The result of verifying the Card Verification Code.
+           *
+           * - `not_checked` - No card verification code was provided in the authorization
+           *   request.
+           * - `match` - The card verification code matched the one on file.
+           * - `no_match` - The card verification code did not match the one on file.
+           */
+          result: 'not_checked' | 'match' | 'no_match';
+        }
+
+        /**
+         * Cardholder address provided in the authorization request and the address on file
+         * we verified it against.
+         */
+        export interface CardholderAddress {
+          /**
+           * Line 1 of the address on file for the cardholder.
+           */
+          actual_line1: string | null;
+
+          /**
+           * The postal code of the address on file for the cardholder.
+           */
+          actual_postal_code: string | null;
+
+          /**
+           * The cardholder address line 1 provided for verification in the authorization
+           * request.
+           */
+          provided_line1: string | null;
+
+          /**
+           * The postal code provided for verification in the authorization request.
+           */
+          provided_postal_code: string | null;
+
+          /**
+           * The address verification result returned to the card network.
+           *
+           * - `not_checked` - No address information was provided in the authorization
+           *   request.
+           * - `postal_code_match_address_no_match` - Postal code matches, but the street
+           *   address does not match or was not provided.
+           * - `postal_code_no_match_address_match` - Postal code does not match, but the
+           *   street address matches or was not provided.
+           * - `match` - Postal code and street address match.
+           * - `no_match` - Postal code and street address do not match.
+           * - `postal_code_match_address_not_checked` - Postal code matches, but the street
+           *   address was not verified. (deprecated)
+           */
+          result:
+            | 'not_checked'
+            | 'postal_code_match_address_no_match'
+            | 'postal_code_no_match_address_match'
+            | 'match'
+            | 'no_match'
+            | 'postal_code_match_address_not_checked';
+        }
+      }
+    }
+
+    /**
+     * A Card Authorization Expiration object. This field will be present in the JSON
+     * response if and only if `category` is equal to `card_authorization_expiration`.
+     * Card Authorization Expirations are cancellations of authorizations that were
+     * never settled by the acquirer.
+     */
+    export interface CardAuthorizationExpiration {
+      /**
+       * The Card Authorization Expiration identifier.
        */
-      merchant_name: string;
+      id: string;
 
       /**
-       * The purchase amount in minor units.
+       * The identifier for the Card Authorization this reverses.
        */
-      purchase_amount: number | null;
+      card_authorization_id: string;
 
       /**
-       * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
-       * authentication attempt's purchase currency.
+       * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the reversal's
+       * currency.
+       *
+       * - `USD` - US Dollar (USD)
        */
-      purchase_currency: string | null;
+      currency: 'USD';
 
       /**
-       * The identifier of the Real-Time Decision sent to approve or decline this
-       * authentication attempt.
+       * The amount of this authorization expiration in the minor unit of the
+       * transaction's currency. For dollars, for example, this is cents.
        */
-      real_time_decision_id: string | null;
+      expired_amount: number;
 
       /**
-       * The status of the card authentication.
+       * The card network used to process this card authorization.
        *
-       * - `denied` - The authentication attempt was denied.
-       * - `authenticated_with_challenge` - The authentication attempt was authenticated
-       *   with a challenge.
-       * - `authenticated_without_challenge` - The authentication attempt was
-       *   authenticated without a challenge.
-       * - `awaiting_challenge` - The authentication attempt is awaiting a challenge.
-       * - `validating_challenge` - The authentication attempt is validating a challenge.
-       * - `canceled` - The authentication attempt was canceled.
-       * - `timed_out_awaiting_challenge` - The authentication attempt timed out while
-       *   awaiting a challenge.
-       * - `errored` - The authentication attempt errored.
-       * - `exceeded_attempt_threshold` - The authentication attempt exceeded the attempt
-       *   threshold.
+       * - `visa` - Visa
+       * - `pulse` - Pulse
        */
-      status:
-        | 'denied'
-        | 'authenticated_with_challenge'
-        | 'authenticated_without_challenge'
-        | 'awaiting_challenge'
-        | 'validating_challenge'
-        | 'canceled'
-        | 'timed_out_awaiting_challenge'
-        | 'errored'
-        | 'exceeded_attempt_threshold';
+      network: 'visa' | 'pulse';
 
       /**
        * A constant representing the object's type. For this resource it will always be
-       * `card_authentication`.
+       * `card_authorization_expiration`.
        */
-      type: 'card_authentication';
+      type: 'card_authorization_expiration';
 
       [k: string]: unknown;
     }
 
-    export namespace CardAuthentication {
-      /**
-       * Details about the challenge, if one was requested.
-       */
-      export interface Challenge {
-        /**
-         * Details about the challenge verification attempts, if any happened.
-         */
-        attempts: Array<Challenge.Attempt>;
-
-        /**
-         * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Card
-         * Authentication Challenge was started.
-         */
-        created_at: string;
-
-        /**
-         * The one-time code used for the Card Authentication Challenge.
-         */
-        one_time_code: string;
-
-        /**
-         * The method used to verify the Card Authentication Challenge.
-         *
-         * - `text_message` - The one-time code was sent via text message.
-         * - `email` - The one-time code was sent via email.
-         * - `none_available` - The one-time code was not successfully delivered.
-         */
-        verification_method: 'text_message' | 'email' | 'none_available';
-
-        /**
-         * E.g., the email address or phone number used for the Card Authentication
-         * Challenge.
-         */
-        verification_value: string | null;
-      }
-
-      export namespace Challenge {
-        export interface Attempt {
-          /**
-           * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time of the Card
-           * Authentication Challenge Attempt.
-           */
-          created_at: string;
-
-          /**
-           * The outcome of the Card Authentication Challenge Attempt.
-           *
-           * - `successful` - The attempt was successful.
-           * - `failed` - The attempt was unsuccessful.
-           */
-          outcome: 'successful' | 'failed';
-        }
-      }
-    }
-
     /**
-     * A Card Authorization object. This field will be present in the JSON response if
-     * and only if `category` is equal to `card_authorization`. Card Authorizations are
-     * temporary holds placed on a customers funds with the intent to later clear a
-     * transaction.
+     * A Card Balance Inquiry object. This field will be present in the JSON response
+     * if and only if `category` is equal to `card_balance_inquiry`. Card Balance
+     * Inquiries are transactions that allow merchants to check the available balance
+     * on a card without placing a hold on funds, commonly used when a customer
+     * requests their balance at an ATM.
      */
-    export interface CardAuthorization {
+    export interface CardBalanceInquiry {
       /**
-       * The Card Authorization identifier.
+       * The Card Balance Inquiry identifier.
        */
       id: string;
 
-      /**
-       * Whether this authorization was approved by Increase, the card network through
-       * stand-in processing, or the user through a real-time decision.
-       *
-       * - `user` - This object was actioned by the user through a real-time decision.
-       * - `increase` - This object was actioned by Increase without user intervention.
-       * - `network` - This object was actioned by the network, through stand-in
-       *   processing.
-       */
-      actioner: 'user' | 'increase' | 'network';
-
       /**
        * Additional amounts associated with the card authorization, such as ATM
        * surcharges fees. These are usually a subset of the `amount` field and are used
        * to provide more detailed information about the transaction.
        */
-      additional_amounts: CardAuthorization.AdditionalAmounts;
+      additional_amounts: CardBalanceInquiry.AdditionalAmounts;
 
       /**
-       * The pending amount in the minor unit of the transaction's currency. For dollars,
-       * for example, this is cents.
+       * The balance amount in the minor unit of the account's currency. For dollars, for
+       * example, this is cents.
        */
-      amount: number;
+      balance: number;
 
       /**
        * The ID of the Card Payment this transaction belongs to.
@@ -487,8 +1240,8 @@ export namespace CardPayment {
       card_payment_id: string;
 
       /**
-       * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
-       * transaction's currency.
+       * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the account's
+       * currency.
        *
        * - `USD` - US Dollar (USD)
        */
@@ -500,23 +1253,6 @@ export namespace CardPayment {
        */
       digital_wallet_token_id: string | null;
 
-      /**
-       * The direction describes the direction the funds will move, either from the
-       * cardholder to the merchant or from the merchant to the cardholder.
-       *
-       * - `settlement` - A regular card authorization where funds are debited from the
-       *   cardholder.
-       * - `refund` - A refund card authorization, sometimes referred to as a credit
-       *   voucher authorization, where funds are credited to the cardholder.
-       */
-      direction: 'settlement' | 'refund';
-
-      /**
-       * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) when this authorization
-       * will expire and the pending transaction will be released.
-       */
-      expires_at: string;
-
       /**
        * The merchant identifier (commonly abbreviated as MID) of the merchant the card
        * is transacting with.
@@ -558,12 +1294,12 @@ export namespace CardPayment {
       /**
        * Fields specific to the `network`.
        */
-      network_details: CardAuthorization.NetworkDetails;
+      network_details: CardBalanceInquiry.NetworkDetails;
 
       /**
        * Network-specific identifiers for a specific request or transaction.
        */
-      network_identifiers: CardAuthorization.NetworkIdentifiers;
+      network_identifiers: CardBalanceInquiry.NetworkIdentifiers;
 
       /**
        * The risk score generated by the card network. For Visa this is the Visa Advanced
@@ -572,61 +1308,12 @@ export namespace CardPayment {
        */
       network_risk_score: number | null;
 
-      /**
-       * The identifier of the Pending Transaction associated with this Transaction.
-       */
-      pending_transaction_id: string | null;
-
       /**
        * If the authorization was made in-person with a physical card, the Physical Card
        * that was used.
        */
       physical_card_id: string | null;
 
-      /**
-       * The pending amount in the minor unit of the transaction's presentment currency.
-       */
-      presentment_amount: number;
-
-      /**
-       * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
-       * transaction's presentment currency.
-       */
-      presentment_currency: string;
-
-      /**
-       * The processing category describes the intent behind the authorization, such as
-       * whether it was used for bill payments or an automatic fuel dispenser.
-       *
-       * - `account_funding` - Account funding transactions are transactions used to
-       *   e.g., fund an account or transfer funds between accounts.
-       * - `automatic_fuel_dispenser` - Automatic fuel dispenser authorizations occur
-       *   when a card is used at a gas pump, prior to the actual transaction amount
-       *   being known. They are followed by an advice message that updates the amount of
-       *   the pending transaction.
-       * - `bill_payment` - A transaction used to pay a bill.
-       * - `original_credit` - Original credit transactions are used to send money to a
-       *   cardholder.
-       * - `purchase` - A regular purchase.
-       * - `quasi_cash` - Quasi-cash transactions represent purchases of items which may
-       *   be convertible to cash.
-       * - `refund` - A refund card authorization, sometimes referred to as a credit
-       *   voucher authorization, where funds are credited to the cardholder.
-       * - `cash_disbursement` - Cash disbursement transactions are used to withdraw cash
-       *   from an ATM or a point of sale.
-       * - `unknown` - The processing category is unknown.
-       */
-      processing_category:
-        | 'account_funding'
-        | 'automatic_fuel_dispenser'
-        | 'bill_payment'
-        | 'original_credit'
-        | 'purchase'
-        | 'quasi_cash'
-        | 'refund'
-        | 'cash_disbursement'
-        | 'unknown';
-
       /**
        * The identifier of the Real-Time Decision sent to approve or decline this
        * transaction.
@@ -641,19 +1328,19 @@ export namespace CardPayment {
 
       /**
        * A constant representing the object's type. For this resource it will always be
-       * `card_authorization`.
+       * `card_balance_inquiry`.
        */
-      type: 'card_authorization';
+      type: 'card_balance_inquiry';
 
       /**
        * Fields related to verification of cardholder-provided values.
        */
-      verification: CardAuthorization.Verification;
+      verification: CardBalanceInquiry.Verification;
 
       [k: string]: unknown;
     }
 
-    export namespace CardAuthorization {
+    export namespace CardBalanceInquiry {
       /**
        * Additional amounts associated with the card authorization, such as ATM
        * surcharges fees. These are usually a subset of the `amount` field and are used
@@ -1152,54 +1839,6 @@ export namespace CardPayment {
       }
     }
 
-    /**
-     * A Card Authorization Expiration object. This field will be present in the JSON
-     * response if and only if `category` is equal to `card_authorization_expiration`.
-     * Card Authorization Expirations are cancellations of authorizations that were
-     * never settled by the acquirer.
-     */
-    export interface CardAuthorizationExpiration {
-      /**
-       * The Card Authorization Expiration identifier.
-       */
-      id: string;
-
-      /**
-       * The identifier for the Card Authorization this reverses.
-       */
-      card_authorization_id: string;
-
-      /**
-       * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the reversal's
-       * currency.
-       *
-       * - `USD` - US Dollar (USD)
-       */
-      currency: 'USD';
-
-      /**
-       * The amount of this authorization expiration in the minor unit of the
-       * transaction's currency. For dollars, for example, this is cents.
-       */
-      expired_amount: number;
-
-      /**
-       * The card network used to process this card authorization.
-       *
-       * - `visa` - Visa
-       * - `pulse` - Pulse
-       */
-      network: 'visa' | 'pulse';
-
-      /**
-       * A constant representing the object's type. For this resource it will always be
-       * `card_authorization_expiration`.
-       */
-      type: 'card_authorization_expiration';
-
-      [k: string]: unknown;
-    }
-
     /**
      * A Card Decline object. This field will be present in the JSON response if and
      * only if `category` is equal to `card_decline`.
@@ -1367,6 +2006,8 @@ export namespace CardPayment {
        *   voucher authorization, where funds are credited to the cardholder.
        * - `cash_disbursement` - Cash disbursement transactions are used to withdraw cash
        *   from an ATM or a point of sale.
+       * - `balance_inquiry` - A balance inquiry transaction is used to check the balance
+       *   of an account associated with a card.
        * - `unknown` - The processing category is unknown.
        */
       processing_category:
@@ -1378,6 +2019,7 @@ export namespace CardPayment {
         | 'quasi_cash'
         | 'refund'
         | 'cash_disbursement'
+        | 'balance_inquiry'
         | 'unknown';
 
       /**
@@ -2137,6 +2779,8 @@ export namespace CardPayment {
        *   voucher authorization, where funds are credited to the cardholder.
        * - `cash_disbursement` - Cash disbursement transactions are used to withdraw cash
        *   from an ATM or a point of sale.
+       * - `balance_inquiry` - A balance inquiry transaction is used to check the balance
+       *   of an account associated with a card.
        * - `unknown` - The processing category is unknown.
        */
       processing_category:
@@ -2148,6 +2792,7 @@ export namespace CardPayment {
         | 'quasi_cash'
         | 'refund'
         | 'cash_disbursement'
+        | 'balance_inquiry'
         | 'unknown';
 
       /**
@@ -5534,12 +6179,10 @@ export namespace CardPaymentListParams {
   }
 }
 
-CardPayments.CardPaymentsPage = CardPaymentsPage;
-
 export declare namespace CardPayments {
   export {
     type CardPayment as CardPayment,
-    CardPaymentsPage as CardPaymentsPage,
+    type CardPaymentsPage as CardPaymentsPage,
     type CardPaymentListParams as CardPaymentListParams,
   };
 }