stripe 22.6.1 → 22.7.0-alpha.2

package/cjs/resources/Issuing/Authorizations.d.ts

@@ -4,7 +4,7 @@ import { Card } from './Cards.js';
 import { Cardholder } from './Cardholders.js';
 import { Token } from './Tokens.js';
 import { Transaction } from './Transactions.js';
-import { Emptyable, MetadataParam, PaginationParams, RangeQueryParam, OtherString, Metadata, Decimal } from '../../shared.js';
+import { Emptyable, MetadataParam, PaginationParams, RangeQueryParam, OtherString, Metadata, Address, Decimal } from '../../shared.js';
 import { RequestOptions, ApiListPromise, Response } from '../../lib.js';
 export declare class AuthorizationResource extends StripeResource {
     /**
@@ -57,6 +57,7 @@ export interface Authorization {
      * How the card details were provided.
      */
     authorization_method: Authorization.AuthorizationMethod;
+    balance_response?: Authorization.BalanceResponse;
     /**
      * List of balance transactions associated with this authorization.
      */
@@ -77,10 +78,18 @@ export interface Authorization {
      * Time at which the object was created. Measured in seconds since the Unix epoch.
      */
     created: number;
+    /**
+     * Array of onchain crypto transactions linked to this resource.
+     */
+    crypto_transactions?: Array<Authorization.CryptoTransaction> | null;
     /**
      * The currency of the cardholder. This currency can be different from the currency presented at authorization and the `merchant_currency` field on this authorization. Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
      */
     currency: string;
+    /**
+     * Enriched merchant data for this authorization.
+     */
+    enriched_merchant_data?: Authorization.EnrichedMerchantData | null;
     /**
      * Fleet-specific information for authorizations using Fleet cards.
      */
@@ -93,6 +102,10 @@ export interface Authorization {
      * Information about fuel that was purchased with this transaction. Typically this information is received from the merchant after the authorization has been approved and the fuel dispensed.
      */
     fuel: Authorization.Fuel | null;
+    /**
+     * Details about the IIAS FSA/HSA healthcare amounts on this authorization.
+     */
+    healthcare?: Authorization.Healthcare | null;
     /**
      * If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
      */
@@ -101,6 +114,10 @@ export interface Authorization {
      * The total amount that was authorized or rejected. This amount is in the `merchant_currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). `merchant_amount` should be the same as `amount`, unless `merchant_currency` and `currency` are different.
      */
     merchant_amount: number;
+    /**
+     * The exchange rate used by the network to convert the `merchant_amount` to `amount`. The `merchant_amount` multiplied with this rate will equal to the `amount`.
+     */
+    merchant_amount_exchange_rate?: number | null;
     /**
      * The local currency that was presented to the cardholder for the authorization. This currency can be different from the cardholder currency and the `currency` field on this authorization. Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
      */
@@ -118,6 +135,14 @@ export interface Authorization {
      * The pending authorization request. This field will only be non-null during an `issuing_authorization.request` webhook.
      */
     pending_request: Authorization.PendingRequest | null;
+    /**
+     * The point-of-sale initiation condition. This is null when the card network did not provide one.
+     */
+    pos_condition?: Authorization.PosCondition | null;
+    /**
+     * Redaction status of this authorization. If the authorization is not redacted, this field will be null.
+     */
+    redaction?: Authorization.Redaction | null;
     /**
      * History of every time a `pending_request` authorization was approved/declined, either by you directly or by Stripe (e.g. based on your spending_controls). If the merchant changes the authorization by performing an incremental authorization, you can look at this field to see the previous requests for the authorization. This field can be helpful in determining why a given authorization was approved/declined.
      */
@@ -126,10 +151,15 @@ export interface Authorization {
      * The current status of the authorization in its lifecycle.
      */
     status: Authorization.Status;
+    /**
+     * Details about the cardholder verification outcome at the terminal.
+     */
+    terminal_data?: Authorization.TerminalData | null;
     /**
      * [Token](https://docs.stripe.com/api/issuing/tokens/object) object used for this authorization. If a network token was not used for this authorization, this field will be null.
      */
     token?: string | Token | null;
+    token_details?: Authorization.TokenDetails;
     /**
      * List of [transactions](https://docs.stripe.com/api/issuing/transactions) associated with this authorization.
      */
@@ -160,7 +190,49 @@ export declare namespace Authorization {
         cashback_amount: number | null;
     }
     type AuthorizationMethod = 'chip' | 'contactless' | 'keyed_in' | 'online' | 'swipe' | OtherString;
+    interface BalanceResponse {
+        /**
+         * The cardholder account type affected by this authorization.
+         */
+        account_type: BalanceResponse.AccountType;
+        /**
+         * The available balance or credit limit in the cardholder's account after the authorization, in the smallest currency unit.
+         */
+        available_balance: number;
+        /**
+         * The currency of the remaining balances in the cardholder's account after the authorization.
+         */
+        currency: string;
+        /**
+         * The current ledger balance or remaining credit amount in the cardholder's account after the authorization, in the smallest currency unit.
+         */
+        current_balance: number;
+    }
     type CardPresence = 'not_present' | 'present' | OtherString;
+    interface CryptoTransaction {
+        /**
+         * The confirmed crypto transaction details when `type` is `crypto_transaction_confirmed`; otherwise null.
+         */
+        crypto_transaction_confirmed: CryptoTransaction.CryptoTransactionConfirmed | null;
+        /**
+         * The failed crypto transaction details when `type` is `crypto_transaction_failed`; otherwise null.
+         */
+        crypto_transaction_failed: CryptoTransaction.CryptoTransactionFailed | null;
+        /**
+         * The crypto transaction variant for this array entry.
+         */
+        type: string;
+    }
+    interface EnrichedMerchantData {
+        /**
+         * Additional details about the seller (grocery store, e-commerce website, and so on) where the card authorization happened.
+         */
+        merchant: EnrichedMerchantData.Merchant | null;
+        /**
+         * An array of third parties involved in the card authorization, when applicable.
+         */
+        third_parties: Array<EnrichedMerchantData.ThirdParty> | null;
+    }
     interface Fleet {
         /**
          * Answers to prompts presented to the cardholder at the point of sale. Prompted fields vary depending on the configuration of your physical fleet cards. Typical points of sale support only numeric entry.
@@ -215,6 +287,40 @@ export declare namespace Authorization {
          */
         unit_cost_decimal: Decimal | null;
     }
+    interface Healthcare {
+        /**
+         * Clinic and urgent care sub-amount for Visa only. Null if the merchant did not include this amount.
+         */
+        clinic_amount?: number | null;
+        /**
+         * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+         */
+        currency?: string;
+        /**
+         * Dental care sub-amount for Visa only. Null if the merchant did not include this amount.
+         */
+        dental_amount?: number | null;
+        /**
+         * Prescription drug sub-amount. Null if the merchant did not include this amount.
+         */
+        prescription_amount?: number | null;
+        /**
+         * The type of healthcare transaction. `medical` for FSA/HSA-eligible healthcare purchases; `transit_for_healthcare` for FSA/HSA-eligible transit for healthcare purchases.
+         */
+        purchase_type?: Healthcare.PurchaseType | null;
+        /**
+         * Total FSA/HSA-eligible amount in the smallest currency unit.
+         */
+        total_qualified_amount?: number;
+        /**
+         * IIAS verification status from the merchant terminal. For Visa, this value will always be iias_verified. Defaults to not_verified when the network does not provide IIAS status.
+         */
+        verification_status?: Healthcare.VerificationStatus;
+        /**
+         * Vision/optical sub-amount. Null if the merchant did not include this amount.
+         */
+        vision_amount?: number | null;
+    }
     interface MerchantData {
         /**
          * A categorization of the seller's type of business. See our [merchant categories guide](https://docs.stripe.com/issuing/merchant-categories) for a list of possible values.
@@ -240,6 +346,10 @@ export declare namespace Authorization {
          * Identifier assigned to the seller by the card network. Different card networks may assign different network_id fields to the same merchant.
          */
         network_id: string;
+        /**
+         * The identifier of the payment facilitator (PayFac) that processed this authorization, as assigned by the card network. Null when the transaction was not processed through a PayFac.
+         */
+        payment_facilitator_id?: string | null;
         /**
          * Postal code where the seller is located
          */
@@ -248,6 +358,10 @@ export declare namespace Authorization {
          * State where the seller is located
          */
         state: string | null;
+        /**
+         * The identifier of the sub-merchant involved in this authorization, as assigned by the payment facilitator. Null when the transaction was not processed through a PayFac or when no sub-merchant ID was provided.
+         */
+        sub_merchant_id?: string | null;
         /**
          * The seller's tax identification number. Currently populated for French merchants only.
          */
@@ -262,10 +376,18 @@ export declare namespace Authorization {
         url: string | null;
     }
     interface NetworkData {
+        /**
+         * Country code of the acquirer assigned by the card network.
+         */
+        acquiring_institution_country?: string | null;
         /**
          * Identifier assigned to the acquirer by the card network. Sometimes this value is not provided by the network; in this case, the value will be `null`.
          */
         acquiring_institution_id: string | null;
+        /**
+         * Identifier assigned by the acquirer to track all messages related to this transaction.
+         */
+        retrieval_reference_number?: string | null;
         /**
          * The System Trace Audit Number (STAN) is a 6-digit identifier assigned by the acquirer. Prefer `network_data.transaction_id` if present, unless you have special requirements.
          */
@@ -288,6 +410,14 @@ export declare namespace Authorization {
          * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
          */
         currency: string;
+        /**
+         * The total amount to be held for this authorization request.
+         */
+        hold_amount?: PendingRequest.HoldAmount | null;
+        /**
+         * Breakdown of the amounts contributing to hold_amount.
+         */
+        hold_amount_details?: PendingRequest.HoldAmountDetails | null;
         /**
          * If set `true`, you may provide [amount](https://docs.stripe.com/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization.
          */
@@ -305,6 +435,13 @@ export declare namespace Authorization {
          */
         network_risk_score: number | null;
     }
+    type PosCondition = 'account_verification' | 'card_not_present' | 'card_present' | 'e_commerce' | 'key_entered_pos' | 'other' | 'pin_entered' | 'recurring_or_moto';
+    interface Redaction {
+        /**
+         * Indicates whether this object and its related objects have been redacted or not.
+         */
+        status: Redaction.Status;
+    }
     interface RequestHistory {
         /**
          * The `pending_request.amount` at the time of the request, presented in your card's currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Stripe held this amount from your account to fund the authorization if the request was approved.
@@ -330,6 +467,14 @@ export declare namespace Authorization {
          * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
          */
         currency: string;
+        /**
+         * The total amount that was held for this authorization request.
+         */
+        hold_amount?: RequestHistory.HoldAmount | null;
+        /**
+         * Breakdown of the amounts contributing to hold_amount.
+         */
+        hold_amount_details?: RequestHistory.HoldAmountDetails | null;
         /**
          * The `pending_request.merchant_amount` at the time of the request, presented in the `merchant_currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
          */
@@ -338,6 +483,10 @@ export declare namespace Authorization {
          * The currency that was collected by the merchant and presented to the cardholder for the authorization. Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
          */
         merchant_currency: string;
+        /**
+         * Details about the authorization request, such as identifiers, set by the card network.
+         */
+        network_data?: RequestHistory.NetworkData | null;
         /**
          * The card network's estimate of the likelihood that an authorization is fraudulent. Takes on values between 1 and 99.
          */
@@ -356,6 +505,35 @@ export declare namespace Authorization {
         requested_at: number | null;
     }
     type Status = 'closed' | 'expired' | 'pending' | 'reversed' | OtherString;
+    interface TerminalData {
+        /**
+         * The method used to confirm the cardholder's identity.
+         */
+        cardholder_verification_result: TerminalData.CardholderVerificationResult | null;
+    }
+    interface TokenDetails {
+        /**
+         * The card associated with this token.
+         */
+        card: string;
+        /**
+         * Time at which the object was created. Measured in seconds since the Unix epoch.
+         */
+        created: number;
+        /**
+         * The hashed ID derived from the device ID from the card network associated with the token.
+         */
+        device_fingerprint?: string;
+        network_data?: TokenDetails.NetworkData;
+        /**
+         * The decision made during token provisioning.
+         */
+        provisioning_decision?: TokenDetails.ProvisioningDecision | null;
+        /**
+         * The type of the token, indicating how it is used.
+         */
+        token_type?: TokenDetails.TokenType | null;
+    }
     interface Treasury {
         /**
          * The array of [ReceivedCredits](https://docs.stripe.com/api/treasury/received_credits) associated with this authorization
@@ -400,6 +578,236 @@ export declare namespace Authorization {
          */
         three_d_secure: VerificationData.ThreeDSecure | null;
     }
+    namespace BalanceResponse {
+        type AccountType = 'checking' | 'credit' | 'default' | 'other' | 'savings' | 'universal' | OtherString;
+    }
+    namespace CryptoTransaction {
+        interface CryptoTransactionConfirmed {
+            /**
+             * The crypto amount for the confirmed transaction.
+             */
+            amount: string;
+            /**
+             * The upcharged MCC amount, if one was applied.
+             */
+            amount_mcc_upcharged: string | null;
+            /**
+             * The blockchain network for the confirmed transaction.
+             */
+            chain: string;
+            /**
+             * When the transaction was confirmed onchain.
+             */
+            confirmed_at: number;
+            /**
+             * The currency of the crypto transaction amount.
+             */
+            currency: string;
+            /**
+             * Fees associated with the transaction.
+             */
+            fees: Array<CryptoTransactionConfirmed.Fee>;
+            /**
+             * The source wallet address for the transaction.
+             */
+            from_address: string;
+            /**
+             * Memo metadata attached to the transaction, if present.
+             */
+            memo: string | null;
+            /**
+             * The destination wallet address for the transaction.
+             */
+            to_address: string;
+            /**
+             * The blockchain transaction hash.
+             */
+            transaction_hash: string;
+        }
+        interface CryptoTransactionFailed {
+            /**
+             * The crypto amount for the failed transaction.
+             */
+            amount: string;
+            /**
+             * The upcharged MCC amount, if one was applied.
+             */
+            amount_mcc_upcharged: string | null;
+            /**
+             * The blockchain network for the failed transaction.
+             */
+            chain: string;
+            /**
+             * The currency of the crypto transaction amount.
+             */
+            currency: string;
+            /**
+             * When the transaction failed.
+             */
+            failed_at: number;
+            /**
+             * The reason the transaction failed.
+             */
+            failure_reason: string;
+            /**
+             * Fees associated with the transaction.
+             */
+            fees: Array<CryptoTransactionFailed.Fee>;
+            /**
+             * The source wallet address for the attempted transaction.
+             */
+            from_address: string;
+            /**
+             * Memo metadata attached to the transaction, if present.
+             */
+            memo: string | null;
+            /**
+             * The destination wallet address for the attempted transaction when one exists.
+             */
+            to_address: string | null;
+            /**
+             * The blockchain transaction hash when one exists.
+             */
+            transaction_hash: string | null;
+        }
+        namespace CryptoTransactionConfirmed {
+            interface Fee {
+                /**
+                 * The fee amount.
+                 */
+                amount: string;
+                /**
+                 * The fee currency.
+                 */
+                currency: string;
+                /**
+                 * The fee type.
+                 */
+                type: string;
+            }
+        }
+        namespace CryptoTransactionFailed {
+            interface Fee {
+                /**
+                 * The fee amount.
+                 */
+                amount: string;
+                /**
+                 * The fee currency.
+                 */
+                currency: string;
+                /**
+                 * The fee type.
+                 */
+                type: string;
+            }
+        }
+    }
+    namespace EnrichedMerchantData {
+        interface Merchant {
+            data_sources: Array<'spade'>;
+            industry: Merchant.Industry;
+            /**
+             * Location data of the seller.
+             */
+            location: Merchant.Location | null;
+            /**
+             * Image link to the seller's logo.
+             */
+            logo: string | null;
+            /**
+             * The name of the seller.
+             */
+            name: string | null;
+            /**
+             * Phone number of the seller.
+             */
+            phone: string | null;
+            /**
+             * If `spade` is a data source, this hash contains details provided by Spade.
+             */
+            spade: Merchant.Spade | null;
+            /**
+             * URL of the seller's website.
+             */
+            url: string | null;
+        }
+        interface ThirdParty {
+            data_sources: Array<'spade'>;
+            /**
+             * Image link to the third party's logo.
+             */
+            logo: string | null;
+            /**
+             * Name of the third party.
+             */
+            name: string | null;
+            /**
+             * If `spade` is a data source, this hash contains details provided by Spade.
+             */
+            spade: ThirdParty.Spade | null;
+            /**
+             * Category of the third party.
+             */
+            type: ThirdParty.Type;
+        }
+        namespace Merchant {
+            interface Industry {
+                /**
+                 * Most specific value of the seller's category.
+                 */
+                id: Industry.Id;
+                /**
+                 * Increasingly specific textual representations of the seller's category.
+                 */
+                names: Array<string>;
+            }
+            interface Location {
+                /**
+                 * Address details of the seller.
+                 */
+                address: Address | null;
+                /**
+                 * Coordinates of the seller.
+                 */
+                coordinates: Location.Coordinates | null;
+            }
+            interface Spade {
+                /**
+                 * Unified identifier for the seller.
+                 */
+                counterparty_id: string | null;
+                /**
+                 * Unified identifier for the seller's location.
+                 */
+                location_id: string | null;
+            }
+            namespace Industry {
+                type Id = 'accessories' | 'accounting_and_bookkeeping' | 'acupuncture' | 'administrative_services' | 'adult_entertainment' | 'adult_retail' | 'advertising_and_marketing' | 'advertising_technology' | 'agricultural_technology' | 'agriculture_and_forestry' | 'airlines_and_aviation' | 'alternative_medicine' | 'alternative_rentals' | 'anesthesiologists' | 'antiques' | 'aquatic_transportation' | 'arcades_and_amusement_parks' | 'art_dealers_and_galleries' | 'arts_and_hobbies' | 'atms' | 'auctions' | 'auto_parts_and_supplies' | 'auto_smog_checks' | 'auto_tires' | 'auto_transmission' | 'automotive_dealerships' | 'automotive_retail' | 'automotive_services' | 'bakeries' | 'banking_and_finance' | 'bars' | 'beauty_spas_and_salons' | 'beer_wine_and_spirits' | 'benefits' | 'bicycles' | 'billiards_and_pool' | 'biotechnology' | 'blood_banks_and_centers' | 'boat_dealers' | 'bookstores' | 'bowling' | 'breweries_distilleries_and_wineries' | 'business_brokers_and_franchises' | 'business_services' | 'butchers' | 'buy_now_pay_later' | 'cafes' | 'candy_shops' | 'cannabis_dispensary' | 'car_appraisers' | 'car_wash_and_detail' | 'cardiologists' | 'cards_and_stationery' | 'casinos_and_gambling' | 'catering' | 'charity' | 'childcare' | 'children_s_clothing' | 'children_s_retail' | 'chiropractors' | 'circuses_and_carnivals' | 'cleaning' | 'clothing_and_accessories' | 'clothing_services' | 'commercial_supplies' | 'communication_software' | 'computers_and_electronics' | 'construction_and_home_improvement' | 'construction_supplies' | 'contractors' | 'convenience_stores' | 'cosmetics' | 'costumes' | 'counseling_and_therapy' | 'couriers' | 'coworking_spaces' | 'creative' | 'creative_software' | 'credit_reporting' | 'crm' | 'crowdfunding' | 'cryptocurrency' | 'dance_halls_and_saloons' | 'delivery_services' | 'dentists' | 'department_stores' | 'dermatologists' | 'design_technology' | 'developer_tools' | 'digital_money_movement' | 'discount_stores' | 'education' | 'educational_technology' | 'electric_vehicle_charging' | 'emergency_services' | 'employment_services' | 'enterprise_software' | 'entertainment' | 'ents' | 'environmental_technology' | 'equipment_rentals' | 'events_and_event_planning' | 'eyewear' | 'fairgrounds_and_rodeos' | 'family_medicine' | 'fast_food' | 'fertility' | 'financial_management_software' | 'financial_planning_and_investments' | 'financial_technology' | 'fishmongers' | 'flea_markets' | 'fleet' | 'florists' | 'food_and_drink' | 'food_delivery_services' | 'food_trucks' | 'fuel_dealers' | 'funeral_services' | 'furniture' | 'gas_stations' | 'gastroenterologists' | 'general_goods' | 'general_surgery' | 'gift_and_novelty' | 'government' | 'grocery_delivery_services' | 'gyms_health_and_fitness_centers' | 'hair_removal' | 'hair_salons_and_barbers' | 'hardware' | 'hardware_and_home_improvement' | 'hospitals_clinics_and_medical_centers' | 'household_services' | 'hr_platform' | 'immigration' | 'import_and_export' | 'industrial_and_energy' | 'inflight_internet_and_entertainment' | 'insurance' | 'internal_medicine' | 'internet' | 'jewelry_and_watches' | 'landmarks' | 'laundry_and_garment_services' | 'lawn_and_garden' | 'legal_services' | 'legal_technology' | 'lending' | 'lingerie' | 'lodging' | 'luggage' | 'maintenance_and_repair' | 'manicures_and_pedicures' | 'manufacturing' | 'marina' | 'marine_supplies' | 'marketing_software' | 'massage_clinics_and_therapists' | 'media' | 'medical_and_healthcare_services' | 'medical_supplies_and_labs' | 'men_s_clothing' | 'mental_health_professionals' | 'mobile_applications' | 'motorcycle_moped_and_scooter_repair' | 'museums' | 'musical_instruments' | 'neurologists' | 'news_and_magazines' | 'newsstands' | 'nutritionists' | 'obstetricians_and_gynecologists' | 'office_supplies' | 'oil_and_gas' | 'oncologists' | 'online_marketplace' | 'ophthalmologists' | 'optometrists' | 'organizations' | 'orthopedic_surgeons' | 'other' | 'outlets' | 'packaging' | 'paper' | 'parking' | 'parks_and_outdoors' | 'party_centers' | 'pathologists' | 'pawn_shops' | 'pediatricians' | 'pet_grooming' | 'pet_services' | 'pets' | 'pharmacies' | 'photography' | 'physical_therapy' | 'piercings' | 'plastic_surgeons' | 'podiatrists' | 'pregnancy_and_sexual_health' | 'professional_services' | 'property_management' | 'psychiatrists' | 'psychics_and_astrologers' | 'psychologists' | 'public_services' | 'public_transportation' | 'publishing_software' | 'radiologists' | 'rails' | 'real_estate' | 'recreation' | 'religious' | 'renewable_energy' | 'respiratory' | 'restaurants' | 'retail' | 'ride_shares' | 'sales_enablement_software' | 'security_and_privacy' | 'security_and_safety' | 'services' | 'shipping_and_freight' | 'shoes' | 'skin_care' | 'social_clubs' | 'software' | 'software_engineering' | 'spas' | 'specialist_physicans' | 'specialty_clothing_and_accessories' | 'specialty_foods' | 'specialty_groceries' | 'specialty_retail' | 'sporting_goods' | 'storage' | 'streaming_services' | 'supermarkets_and_grocery_stores' | 'swimwear' | 'tailors' | 'tanning_salons' | 'tattoos' | 'taxes' | 'taxi_and_limousines' | 'technology' | 'telecommunications' | 'television' | 'textiles' | 'theater_and_cinema' | 'tickets_and_reservations' | 'tobacco_smoke_and_vape_shops' | 'tolls_and_fees' | 'tourist_information_and_services' | 'towing_and_roadside_assistance' | 'toy_stores' | 'transportation' | 'travel' | 'travel_services' | 'travel_software' | 'urologists' | 'utilities' | 'vehicle_rentals' | 'vending_machine' | 'venues' | 'veterinarians' | 'video_games' | 'vintage_and_thrift' | 'warehouses_and_wholesale_stores' | 'water_and_waste_management_services' | 'web_infrastructure' | 'wedding_and_bridal' | 'women_s_clothing' | 'zoos_and_aquariums' | OtherString;
+            }
+            namespace Location {
+                interface Coordinates {
+                    /**
+                     * Latitude of the seller's location.
+                     */
+                    latitude: number | null;
+                    /**
+                     * Longitude of the seller's location.
+                     */
+                    longitude: number | null;
+                }
+            }
+        }
+        namespace ThirdParty {
+            interface Spade {
+                /**
+                 * Unified identifier for the third party.
+                 */
+                third_party_id: string | null;
+            }
+            type Type = 'buy_now_pay_later' | 'delivery_service' | 'marketplace' | 'other' | 'payment_processor' | 'platform' | OtherString;
+        }
+    }
     namespace Fleet {
         interface CardholderPromptData {
             /**
@@ -477,6 +885,10 @@ export declare namespace Authorization {
         type Type = 'diesel' | 'other' | 'unleaded_plus' | 'unleaded_regular' | 'unleaded_super' | OtherString;
         type Unit = 'charging_minute' | 'imperial_gallon' | 'kilogram' | 'kilowatt_hour' | 'liter' | 'other' | 'pound' | 'us_gallon' | OtherString;
     }
+    namespace Healthcare {
+        type PurchaseType = 'medical' | 'transit_for_healthcare';
+        type VerificationStatus = 'iias_merchant_exempt' | 'iias_merchant_not_certified' | 'iias_verified' | 'not_verified';
+    }
     namespace PendingRequest {
         interface AmountDetails {
             /**
@@ -488,6 +900,104 @@ export declare namespace Authorization {
              */
             cashback_amount: number | null;
         }
+        interface HoldAmount {
+            /**
+             * Three-letter ISO currency code.
+             */
+            currency: string;
+            /**
+             * The amount in the smallest currency unit.
+             */
+            value: number;
+        }
+        interface HoldAmountDetails {
+            /**
+             * Advisory estimate of total fees for this authorization request.
+             */
+            estimated_fee: HoldAmountDetails.EstimatedFee | null;
+            /**
+             * Per-fee-type breakdown of the estimated fees for this authorization request.
+             */
+            estimated_fee_details: Array<HoldAmountDetails.EstimatedFeeDetail> | null;
+            network: HoldAmountDetails.Network;
+            /**
+             * The reserve amount held for this authorization. Present for certain MCCs that may have overcaptures.
+             */
+            reserve: HoldAmountDetails.Reserve | null;
+        }
+        namespace HoldAmountDetails {
+            interface EstimatedFee {
+                /**
+                 * Three-letter ISO currency code.
+                 */
+                currency: string;
+                /**
+                 * The amount in the smallest currency unit.
+                 */
+                value: number;
+            }
+            interface EstimatedFeeDetail {
+                amount: EstimatedFeeDetail.Amount;
+                charged_by: EstimatedFeeDetail.ChargedBy;
+                /**
+                 * The category of this fee.
+                 */
+                type: string;
+            }
+            interface Network {
+                /**
+                 * Three-letter ISO currency code.
+                 */
+                currency: string;
+                /**
+                 * The amount in the smallest currency unit.
+                 */
+                value: number;
+            }
+            interface Reserve {
+                /**
+                 * Three-letter ISO currency code.
+                 */
+                currency: string;
+                /**
+                 * The amount in the smallest currency unit.
+                 */
+                value: number;
+            }
+            namespace EstimatedFeeDetail {
+                interface Amount {
+                    /**
+                     * Three-letter ISO currency code.
+                     */
+                    currency: string;
+                    /**
+                     * The amount in the smallest currency unit.
+                     */
+                    value: number;
+                }
+                interface ChargedBy {
+                    /**
+                     * Details for a fee charged by a Connect application.
+                     */
+                    application: ChargedBy.Application | null;
+                    /**
+                     * The type of entity that charged this fee.
+                     */
+                    type: string;
+                }
+                namespace ChargedBy {
+                    interface Application {
+                        /**
+                         * Human-readable product name.
+                         */
+                        feature_name: string;
+                    }
+                }
+            }
+        }
+    }
+    namespace Redaction {
+        type Status = 'processing' | 'redacted' | 'validated' | OtherString;
     }
     namespace RequestHistory {
         interface AmountDetails {
@@ -500,7 +1010,231 @@ export declare namespace Authorization {
              */
             cashback_amount: number | null;
         }
+        interface HoldAmount {
+            /**
+             * Three-letter ISO currency code.
+             */
+            currency: string;
+            /**
+             * The amount in the smallest currency unit.
+             */
+            value: number;
+        }
+        interface HoldAmountDetails {
+            /**
+             * Advisory estimate of total fees for this authorization request.
+             */
+            estimated_fee: HoldAmountDetails.EstimatedFee | null;
+            /**
+             * Per-fee-type breakdown of the estimated fees for this authorization request.
+             */
+            estimated_fee_details: Array<HoldAmountDetails.EstimatedFeeDetail> | null;
+            network: HoldAmountDetails.Network;
+            /**
+             * The reserve amount held for this authorization. Present for certain MCCs that may have overcaptures.
+             */
+            reserve: HoldAmountDetails.Reserve | null;
+        }
+        interface NetworkData {
+            /**
+             * Mastercard identifier for each authorization request.
+             */
+            trace_id: NetworkData.TraceId | null;
+        }
         type Reason = 'account_disabled' | 'card_active' | 'card_canceled' | 'card_expired' | 'card_inactive' | 'cardholder_blocked' | 'cardholder_inactive' | 'cardholder_verification_required' | 'insecure_authorization_method' | 'insufficient_funds' | 'network_fallback' | 'not_allowed' | 'pin_blocked' | 'spending_controls' | 'stripe_internal_error' | 'suspected_fraud' | 'verification_failed' | 'webhook_approved' | 'webhook_declined' | 'webhook_error' | 'webhook_timeout' | OtherString;
+        namespace HoldAmountDetails {
+            interface EstimatedFee {
+                /**
+                 * Three-letter ISO currency code.
+                 */
+                currency: string;
+                /**
+                 * The amount in the smallest currency unit.
+                 */
+                value: number;
+            }
+            interface EstimatedFeeDetail {
+                amount: EstimatedFeeDetail.Amount;
+                charged_by: EstimatedFeeDetail.ChargedBy;
+                /**
+                 * The category of this fee.
+                 */
+                type: string;
+            }
+            interface Network {
+                /**
+                 * Three-letter ISO currency code.
+                 */
+                currency: string;
+                /**
+                 * The amount in the smallest currency unit.
+                 */
+                value: number;
+            }
+            interface Reserve {
+                /**
+                 * Three-letter ISO currency code.
+                 */
+                currency: string;
+                /**
+                 * The amount in the smallest currency unit.
+                 */
+                value: number;
+            }
+            namespace EstimatedFeeDetail {
+                interface Amount {
+                    /**
+                     * Three-letter ISO currency code.
+                     */
+                    currency: string;
+                    /**
+                     * The amount in the smallest currency unit.
+                     */
+                    value: number;
+                }
+                interface ChargedBy {
+                    /**
+                     * Details for a fee charged by a Connect application.
+                     */
+                    application: ChargedBy.Application | null;
+                    /**
+                     * The type of entity that charged this fee.
+                     */
+                    type: string;
+                }
+                namespace ChargedBy {
+                    interface Application {
+                        /**
+                         * Human-readable product name.
+                         */
+                        feature_name: string;
+                    }
+                }
+            }
+        }
+        namespace NetworkData {
+            interface TraceId {
+                /**
+                 * The unique reference number within the specified financial network on the specified network date.
+                 */
+                banknet_reference_number: string | null;
+                /**
+                 * The identifier of the program or service.
+                 */
+                financial_network_code: string | null;
+                /**
+                 * The card network's record date for this authorization.
+                 */
+                network_date: string | null;
+            }
+        }
+    }
+    namespace TerminalData {
+        type CardholderVerificationResult = 'failed' | 'none' | 'pin' | 'pin_and_signature' | 'signature' | 'unknown' | OtherString;
+    }
+    namespace TokenDetails {
+        interface NetworkData {
+            device?: NetworkData.Device;
+            mastercard?: NetworkData.Mastercard;
+            /**
+             * The card network for this token.
+             */
+            type: NetworkData.Type;
+            visa?: NetworkData.Visa;
+            wallet_provider?: NetworkData.WalletProvider;
+        }
+        type ProvisioningDecision = 'approve' | 'approve_pending_id_and_v' | 'decline' | OtherString;
+        type TokenType = 'card_on_file' | 'cloud_based' | 'commerce_platform' | 'commercial_virtual_account' | 'secure_element' | 'static_credential' | OtherString;
+        namespace NetworkData {
+            interface Device {
+                /**
+                 * An identifier for the device used during wallet provisioning.
+                 */
+                device_id?: string | null;
+                /**
+                 * The IP address of the device at provisioning time.
+                 */
+                ip_address?: string;
+                /**
+                 * The ISO 639-1 language code of the device associated with the tokenization request.
+                 */
+                language?: Device.Language;
+                /**
+                 * The phone number of the device used for tokenization.
+                 */
+                phone_number?: string;
+            }
+            interface Mastercard {
+                /**
+                 * A unique reference ID from the network to represent the card account number.
+                 */
+                card_reference_id?: string;
+                /**
+                 * The network-unique identifier for the token.
+                 */
+                token_reference_id: string;
+                /**
+                 * The ID of the entity requesting tokenization.
+                 */
+                token_requestor_id: string;
+            }
+            type Type = 'mastercard' | 'visa' | OtherString;
+            interface Visa {
+                /**
+                 * A unique reference ID from the network to represent the card account number.
+                 */
+                card_reference_id?: string;
+                /**
+                 * The network's recommendation to Stripe for this token activation request.
+                 */
+                token_decision_recommendation?: Visa.TokenDecisionRecommendation | null;
+                /**
+                 * The network-unique identifier for the token.
+                 */
+                token_reference_id: string;
+                /**
+                 * The ID of the entity requesting tokenization.
+                 */
+                token_requestor_id: string;
+                /**
+                 * Degree of risk associated with the token between `01` and `99`, with higher number indicating higher risk. A `00` value indicates the token was not scored by Visa.
+                 */
+                token_risk_score?: string;
+            }
+            interface WalletProvider {
+                /**
+                 * An evaluation on the trustworthiness of the wallet account between 1 and 5. A higher score indicates more trustworthy.
+                 */
+                account_trust_score?: number;
+                /**
+                 * The method used for tokenizing a card.
+                 */
+                card_number_source?: WalletProvider.CardNumberSource;
+                /**
+                 * An evaluation on the trustworthiness of the device. A higher score indicates more trustworthy.
+                 */
+                device_trust_score?: number;
+                /**
+                 * The reasons for suggested tokenization given by the card network.
+                 */
+                reason_codes?: Array<WalletProvider.ReasonCode>;
+                /**
+                 * The recommendation on responding to the tokenization request.
+                 */
+                suggested_decision?: WalletProvider.SuggestedDecision;
+            }
+            namespace Device {
+                type Language = 'aa' | 'ab' | 'ae' | 'af' | 'ak' | 'am' | 'an' | 'ar' | 'as' | 'av' | 'ay' | 'az' | 'ba' | 'be' | 'bg' | 'bi' | 'bm' | 'bn' | 'bo' | 'br' | 'bs' | 'ca' | 'ce' | 'ch' | 'co' | 'cr' | 'cs' | 'cu' | 'cv' | 'cy' | 'da' | 'de' | 'dv' | 'dz' | 'ee' | 'el' | 'en' | 'eo' | 'es' | 'et' | 'eu' | 'fa' | 'ff' | 'fi' | 'fj' | 'fo' | 'fr' | 'fy' | 'ga' | 'gd' | 'gl' | 'gn' | 'gu' | 'gv' | 'ha' | 'he' | 'hi' | 'ho' | 'hr' | 'ht' | 'hu' | 'hy' | 'hz' | 'ia' | 'id' | 'ie' | 'ig' | 'ii' | 'ik' | 'io' | 'is' | 'it' | 'iu' | 'ja' | 'jv' | 'ka' | 'kg' | 'ki' | 'kj' | 'kk' | 'kl' | 'km' | 'kn' | 'ko' | 'kr' | 'ks' | 'ku' | 'kv' | 'kw' | 'ky' | 'la' | 'lb' | 'lg' | 'li' | 'ln' | 'lo' | 'lt' | 'lu' | 'lv' | 'mg' | 'mh' | 'mi' | 'mk' | 'ml' | 'mn' | 'mr' | 'ms' | 'mt' | 'my' | 'na' | 'nb' | 'nd' | 'ne' | 'ng' | 'nl' | 'nn' | 'no' | 'nr' | 'nv' | 'ny' | 'oc' | 'oj' | 'om' | 'or' | 'os' | 'pa' | 'pi' | 'pl' | 'ps' | 'pt' | 'qu' | 'rm' | 'rn' | 'ro' | 'ru' | 'rw' | 'sa' | 'sc' | 'sd' | 'se' | 'sg' | 'si' | 'sk' | 'sl' | 'sm' | 'sn' | 'so' | 'sq' | 'sr' | 'ss' | 'st' | 'su' | 'sv' | 'sw' | 'ta' | 'te' | 'tg' | 'th' | 'ti' | 'tk' | 'tl' | 'tn' | 'to' | 'tr' | 'ts' | 'tt' | 'tw' | 'ty' | 'ug' | 'uk' | 'ur' | 'uz' | 've' | 'vi' | 'vo' | 'wa' | 'wo' | 'xh' | 'yi' | 'yo' | 'za' | 'zh' | 'zu' | OtherString;
+            }
+            namespace Visa {
+                type TokenDecisionRecommendation = 'approve' | 'decline' | 'recommend_id_and_v' | OtherString;
+            }
+            namespace WalletProvider {
+                type CardNumberSource = 'app' | 'manual' | 'on_file' | 'other' | OtherString;
+                type ReasonCode = 'account_card_too_new' | 'account_recently_changed' | 'account_too_new' | 'account_too_new_since_launch' | 'additional_device' | 'data_expired' | 'defer_id_v_decision' | 'device_recently_lost' | 'good_activity_history' | 'has_suspended_tokens' | 'high_risk' | 'inactive_account' | 'long_account_tenure' | 'low_account_score' | 'low_device_score' | 'low_phone_number_score' | 'network_service_error' | 'outside_home_territory' | 'provisioning_cardholder_mismatch' | 'provisioning_device_and_cardholder_mismatch' | 'provisioning_device_mismatch' | 'same_device_no_prior_authentication' | 'same_device_successful_prior_authentication' | 'software_update' | 'suspicious_activity' | 'too_many_different_cardholders' | 'too_many_recent_attempts' | 'too_many_recent_tokens' | OtherString;
+                type SuggestedDecision = 'approve' | 'decline' | 'require_auth' | OtherString;
+            }
+        }
     }
     namespace VerificationData {
         type AddressLine1Check = 'match' | 'mismatch' | 'not_provided' | OtherString;