stripe 22.3.0-alpha.4 → 22.3.0

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

@@ -4,7 +4,6 @@ import { BalanceTransaction } from './../BalanceTransactions.js';
 import { Card } from './Cards.js';
 import { Cardholder } from './Cardholders.js';
 import { Dispute } from './Disputes.js';
-import { Settlement } from './Settlements.js';
 import { Token } from './Tokens.js';
 import { Emptyable, MetadataParam, PaginationParams, RangeQueryParam, Metadata, Decimal } from '../../shared.js';
 import { RequestOptions, ApiListPromise, Response } from '../../lib.js';
@@ -38,7 +37,7 @@ export interface Transaction {
     /**
      * Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
      */
-    amount_details: Issuing.Transaction.AmountDetails | null;
+    amount_details: Transaction.AmountDetails | null;
     /**
      * The `Authorization` object that led to this transaction.
      */
@@ -59,10 +58,6 @@ export interface Transaction {
      * 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<Issuing.Transaction.CryptoTransaction> | 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).
      */
@@ -83,7 +78,7 @@ export interface Transaction {
      * The currency with which the merchant is taking payment.
      */
     merchant_currency: string;
-    merchant_data: Issuing.Transaction.MerchantData;
+    merchant_data: Transaction.MerchantData;
     /**
      * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
      */
@@ -91,15 +86,11 @@ export interface Transaction {
     /**
      * Details about the transaction, such as processing dates, set by the card network.
      */
-    network_data: Issuing.Transaction.NetworkData | null;
+    network_data: Transaction.NetworkData | null;
     /**
      * Additional purchase information that is optionally provided by the merchant.
      */
-    purchase_details?: Issuing.Transaction.PurchaseDetails | null;
-    /**
-     * The ID of the [settlement](https://docs.stripe.com/api/issuing/settlements) to which this transaction belongs.
-     */
-    settlement?: string | Settlement | null;
+    purchase_details?: Transaction.PurchaseDetails | null;
     /**
      * [Token](https://docs.stripe.com/api/issuing/tokens/object) object used for this transaction. If a network token was not used for this transaction, this field will be null.
      */
@@ -107,450 +98,304 @@ export interface Transaction {
     /**
      * [Treasury](https://docs.stripe.com/api/treasury) details related to this transaction if it was created on a [FinancialAccount](/docs/api/treasury/financial_accounts
      */
-    treasury?: Issuing.Transaction.Treasury | null;
+    treasury?: Transaction.Treasury | null;
     /**
      * The nature of the transaction.
      */
-    type: Issuing.Transaction.Type;
+    type: Transaction.Type;
     /**
      * The digital wallet used for this transaction. One of `apple_pay`, `google_pay`, or `samsung_pay`.
      */
-    wallet: Issuing.Transaction.Wallet | null;
+    wallet: Transaction.Wallet | null;
 }
-export declare namespace Issuing {
-    namespace Transaction {
-        interface AmountDetails {
-            /**
-             * The fee charged by the ATM for the cash withdrawal.
-             */
-            atm_fee: number | null;
+export declare namespace Transaction {
+    interface AmountDetails {
+        /**
+         * The fee charged by the ATM for the cash withdrawal.
+         */
+        atm_fee: number | null;
+        /**
+         * The amount of cash requested by the cardholder.
+         */
+        cashback_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.
+         */
+        category: string;
+        /**
+         * The merchant category code for the seller's business
+         */
+        category_code: string;
+        /**
+         * City where the seller is located
+         */
+        city: string | null;
+        /**
+         * Country where the seller is located
+         */
+        country: string | null;
+        /**
+         * Name of the seller
+         */
+        name: string | null;
+        /**
+         * 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;
+        /**
+         * Postal code where the seller is located
+         */
+        postal_code: string | null;
+        /**
+         * State where the seller is located
+         */
+        state: string | null;
+        /**
+         * The seller's tax identification number. Currently populated for French merchants only.
+         */
+        tax_id: string | null;
+        /**
+         * An ID assigned by the seller to the location of the sale.
+         */
+        terminal_id: string | null;
+        /**
+         * URL provided by the merchant on a 3DS request
+         */
+        url: string | null;
+    }
+    interface NetworkData {
+        /**
+         * A code created by Stripe which is shared with the merchant to validate the authorization. This field will be populated if the authorization message was approved. The code typically starts with the letter "S", followed by a six-digit number. For example, "S498162". Please note that the code is not guaranteed to be unique across authorizations.
+         */
+        authorization_code: string | null;
+        /**
+         * The date the transaction was processed by the card network. This can be different from the date the seller recorded the transaction depending on when the acquirer submits the transaction to the network.
+         */
+        processing_date: string | null;
+        /**
+         * Unique identifier for the authorization assigned by the card network used to match subsequent messages, disputes, and transactions.
+         */
+        transaction_id: string | null;
+    }
+    interface PurchaseDetails {
+        /**
+         * Fleet-specific information for transactions using Fleet cards.
+         */
+        fleet: PurchaseDetails.Fleet | null;
+        /**
+         * Information about the flight that was purchased with this transaction.
+         */
+        flight: PurchaseDetails.Flight | null;
+        /**
+         * Information about fuel that was purchased with this transaction.
+         */
+        fuel: PurchaseDetails.Fuel | null;
+        /**
+         * Information about lodging that was purchased with this transaction.
+         */
+        lodging: PurchaseDetails.Lodging | null;
+        /**
+         * The line items in the purchase.
+         */
+        receipt: Array<PurchaseDetails.Receipt> | null;
+        /**
+         * A merchant-specific order number.
+         */
+        reference: string | null;
+    }
+    interface Treasury {
+        /**
+         * The Treasury [ReceivedCredit](https://docs.stripe.com/api/treasury/received_credits) representing this Issuing transaction if it is a refund
+         */
+        received_credit: string | null;
+        /**
+         * The Treasury [ReceivedDebit](https://docs.stripe.com/api/treasury/received_debits) representing this Issuing transaction if it is a capture
+         */
+        received_debit: string | null;
+    }
+    type Type = 'capture' | 'refund';
+    type Wallet = 'apple_pay' | 'google_pay' | 'samsung_pay';
+    namespace PurchaseDetails {
+        interface Fleet {
             /**
-             * The amount of cash requested by the cardholder.
+             * Answers to prompts presented to cardholder at point of sale.
              */
-            cashback_amount: number | null;
-        }
-        interface CryptoTransaction {
+            cardholder_prompt_data: Fleet.CardholderPromptData | null;
             /**
-             * The confirmed crypto transaction details when `type` is `crypto_transaction_confirmed`; otherwise null.
+             * The type of purchase. One of `fuel_purchase`, `non_fuel_purchase`, or `fuel_and_non_fuel_purchase`.
              */
-            crypto_transaction_confirmed: CryptoTransaction.CryptoTransactionConfirmed | null;
+            purchase_type: string | null;
             /**
-             * The failed crypto transaction details when `type` is `crypto_transaction_failed`; otherwise null.
+             * More information about the total amount. This information is not guaranteed to be accurate as some merchants may provide unreliable data.
              */
-            crypto_transaction_failed: CryptoTransaction.CryptoTransactionFailed | null;
+            reported_breakdown: Fleet.ReportedBreakdown | null;
             /**
-             * The crypto transaction variant for this array entry.
+             * The type of fuel service. One of `non_fuel_transaction`, `full_service`, or `self_service`.
              */
-            type: string;
+            service_type: string | 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.
-             */
-            category: string;
+        interface Flight {
             /**
-             * The merchant category code for the seller's business
+             * The time that the flight departed.
              */
-            category_code: string;
+            departure_at: number | null;
             /**
-             * City where the seller is located
+             * The name of the passenger.
              */
-            city: string | null;
+            passenger_name: string | null;
             /**
-             * Country where the seller is located
+             * Whether the ticket is refundable.
              */
-            country: string | null;
+            refundable: boolean | null;
             /**
-             * Name of the seller
+             * The legs of the trip.
              */
-            name: string | null;
+            segments: Array<Flight.Segment> | null;
             /**
-             * Identifier assigned to the seller by the card network. Different card networks may assign different network_id fields to the same merchant.
+             * The travel agency that issued the ticket.
              */
-            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
-             */
-            postal_code: string | null;
+            travel_agency: string | null;
+        }
+        interface Fuel {
             /**
-             * State where the seller is located
+             * [Conexxus Payment System Product Code](https://www.conexxus.org/conexxus-payment-system-product-codes) identifying the primary fuel product purchased.
              */
-            state: string | null;
+            industry_product_code: 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.
+             * The quantity of `unit`s of fuel that was dispensed, represented as a decimal string with at most 12 decimal places.
              */
-            sub_merchant_id?: string | null;
+            quantity_decimal: Decimal | null;
             /**
-             * The seller's tax identification number. Currently populated for French merchants only.
+             * The type of fuel that was purchased. One of `diesel`, `unleaded_plus`, `unleaded_regular`, `unleaded_super`, or `other`.
              */
-            tax_id: string | null;
+            type: string;
             /**
-             * An ID assigned by the seller to the location of the sale.
+             * The units for `quantity_decimal`. One of `charging_minute`, `imperial_gallon`, `kilogram`, `kilowatt_hour`, `liter`, `pound`, `us_gallon`, or `other`.
              */
-            terminal_id: string | null;
+            unit: string;
             /**
-             * URL provided by the merchant on a 3DS request
+             * The cost in cents per each unit of fuel, represented as a decimal string with at most 12 decimal places.
              */
-            url: string | null;
+            unit_cost_decimal: Decimal;
         }
-        interface NetworkData {
-            /**
-             * A code created by Stripe which is shared with the merchant to validate the authorization. This field will be populated if the authorization message was approved. The code typically starts with the letter "S", followed by a six-digit number. For example, "S498162". Please note that the code is not guaranteed to be unique across authorizations.
-             */
-            authorization_code: string | null;
+        interface Lodging {
             /**
-             * The date the transaction was processed by the card network. This can be different from the date the seller recorded the transaction depending on when the acquirer submits the transaction to the network.
+             * The time of checking into the lodging.
              */
-            processing_date: string | null;
+            check_in_at: number | null;
             /**
-             * Unique identifier for the authorization assigned by the card network used to match subsequent messages, disputes, and transactions.
+             * The number of nights stayed at the lodging.
              */
-            transaction_id: string | null;
+            nights: number | null;
         }
-        interface PurchaseDetails {
-            /**
-             * Fleet-specific information for transactions using Fleet cards.
-             */
-            fleet: PurchaseDetails.Fleet | null;
-            /**
-             * Information about the flight that was purchased with this transaction.
-             */
-            flight: PurchaseDetails.Flight | null;
-            /**
-             * Information about fuel that was purchased with this transaction.
-             */
-            fuel: PurchaseDetails.Fuel | null;
-            /**
-             * Information about lodging that was purchased with this transaction.
-             */
-            lodging: PurchaseDetails.Lodging | null;
+        interface Receipt {
             /**
-             * The line items in the purchase.
+             * The description of the item. The maximum length of this field is 26 characters.
              */
-            receipt: Array<PurchaseDetails.Receipt> | null;
+            description: string | null;
             /**
-             * A merchant-specific order number.
+             * The quantity of the item.
              */
-            reference: string | null;
-        }
-        interface Treasury {
+            quantity: number | null;
             /**
-             * The Treasury [ReceivedCredit](https://docs.stripe.com/api/treasury/received_credits) representing this Issuing transaction if it is a refund
+             * The total for this line item in cents.
              */
-            received_credit: string | null;
+            total: number | null;
             /**
-             * The Treasury [ReceivedDebit](https://docs.stripe.com/api/treasury/received_debits) representing this Issuing transaction if it is a capture
+             * The unit cost of the item in cents.
              */
-            received_debit: string | null;
+            unit_cost: number | null;
         }
-        type Type = 'capture' | 'refund';
-        type Wallet = 'apple_pay' | 'google_pay' | 'samsung_pay';
-        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;
+        namespace Fleet {
+            interface CardholderPromptData {
                 /**
-                 * Fees associated with the transaction.
+                 * Driver ID.
                  */
-                fees: Array<CryptoTransactionConfirmed.Fee>;
+                driver_id: string | null;
                 /**
-                 * The source wallet address for the transaction.
+                 * Odometer reading.
                  */
-                from_address: string;
+                odometer: number | null;
                 /**
-                 * Memo metadata attached to the transaction, if present.
+                 * An alphanumeric ID. This field is used when a vehicle ID, driver ID, or generic ID is entered by the cardholder, but the merchant or card network did not specify the prompt type.
                  */
-                memo: string | null;
+                unspecified_id: string | null;
                 /**
-                 * The destination wallet address for the transaction.
+                 * User ID.
                  */
-                to_address: string;
+                user_id: string | null;
                 /**
-                 * The blockchain transaction hash.
+                 * Vehicle number.
                  */
-                transaction_hash: string;
+                vehicle_number: string | null;
             }
-            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;
+            interface ReportedBreakdown {
                 /**
-                 * When the transaction failed.
+                 * Breakdown of fuel portion of the purchase.
                  */
-                failed_at: number;
+                fuel: ReportedBreakdown.Fuel | null;
                 /**
-                 * The reason the transaction failed.
+                 * Breakdown of non-fuel portion of the purchase.
                  */
-                failure_reason: string;
+                non_fuel: ReportedBreakdown.NonFuel | null;
                 /**
-                 * Fees associated with the transaction.
+                 * Information about tax included in this 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;
+                tax: ReportedBreakdown.Tax | null;
             }
-            namespace CryptoTransactionConfirmed {
-                interface Fee {
+            namespace ReportedBreakdown {
+                interface Fuel {
                     /**
-                     * The fee amount.
+                     * Gross fuel amount that should equal Fuel Volume multipled by Fuel Unit Cost, inclusive of taxes.
                      */
-                    amount: string;
-                    /**
-                     * The fee currency.
-                     */
-                    currency: string;
-                    /**
-                     * The fee type.
-                     */
-                    type: string;
+                    gross_amount_decimal: Decimal | null;
                 }
-            }
-            namespace CryptoTransactionFailed {
-                interface Fee {
+                interface NonFuel {
                     /**
-                     * The fee amount.
+                     * Gross non-fuel amount that should equal the sum of the line items, inclusive of taxes.
                      */
-                    amount: string;
+                    gross_amount_decimal: Decimal | null;
+                }
+                interface Tax {
                     /**
-                     * The fee currency.
+                     * Amount of state or provincial Sales Tax included in the transaction amount. Null if not reported by merchant or not subject to tax.
                      */
-                    currency: string;
+                    local_amount_decimal: Decimal | null;
                     /**
-                     * The fee type.
+                     * Amount of national Sales Tax or VAT included in the transaction amount. Null if not reported by merchant or not subject to tax.
                      */
-                    type: string;
+                    national_amount_decimal: Decimal | null;
                 }
             }
         }
-        namespace PurchaseDetails {
-            interface Fleet {
+        namespace Flight {
+            interface Segment {
                 /**
-                 * Answers to prompts presented to cardholder at point of sale.
+                 * The three-letter IATA airport code of the flight's destination.
                  */
-                cardholder_prompt_data: Fleet.CardholderPromptData | null;
+                arrival_airport_code: string | null;
                 /**
-                 * The type of purchase. One of `fuel_purchase`, `non_fuel_purchase`, or `fuel_and_non_fuel_purchase`.
+                 * The airline carrier code.
                  */
-                purchase_type: string | null;
+                carrier: string | null;
                 /**
-                 * More information about the total amount. This information is not guaranteed to be accurate as some merchants may provide unreliable data.
+                 * The three-letter IATA airport code that the flight departed from.
                  */
-                reported_breakdown: Fleet.ReportedBreakdown | null;
+                departure_airport_code: string | null;
                 /**
-                 * The type of fuel service. One of `non_fuel_transaction`, `full_service`, or `self_service`.
+                 * The flight number.
                  */
-                service_type: string | null;
-            }
-            interface Flight {
-                /**
-                 * The time that the flight departed.
-                 */
-                departure_at: number | null;
-                /**
-                 * The name of the passenger.
-                 */
-                passenger_name: string | null;
-                /**
-                 * Whether the ticket is refundable.
-                 */
-                refundable: boolean | null;
-                /**
-                 * The legs of the trip.
-                 */
-                segments: Array<Flight.Segment> | null;
-                /**
-                 * The travel agency that issued the ticket.
-                 */
-                travel_agency: string | null;
-            }
-            interface Fuel {
-                /**
-                 * [Conexxus Payment System Product Code](https://www.conexxus.org/conexxus-payment-system-product-codes) identifying the primary fuel product purchased.
-                 */
-                industry_product_code: string | null;
-                /**
-                 * The quantity of `unit`s of fuel that was dispensed, represented as a decimal string with at most 12 decimal places.
-                 */
-                quantity_decimal: Decimal | null;
-                /**
-                 * The type of fuel that was purchased. One of `diesel`, `unleaded_plus`, `unleaded_regular`, `unleaded_super`, or `other`.
-                 */
-                type: string;
-                /**
-                 * The units for `quantity_decimal`. One of `charging_minute`, `imperial_gallon`, `kilogram`, `kilowatt_hour`, `liter`, `pound`, `us_gallon`, or `other`.
-                 */
-                unit: string;
-                /**
-                 * The cost in cents per each unit of fuel, represented as a decimal string with at most 12 decimal places.
-                 */
-                unit_cost_decimal: Decimal;
-            }
-            interface Lodging {
+                flight_number: string | null;
                 /**
-                 * The time of checking into the lodging.
+                 * The flight's service class.
                  */
-                check_in_at: number | null;
+                service_class: string | null;
                 /**
-                 * The number of nights stayed at the lodging.
+                 * Whether a stopover is allowed on this flight.
                  */
-                nights: number | null;
-            }
-            interface Receipt {
-                /**
-                 * The description of the item. The maximum length of this field is 26 characters.
-                 */
-                description: string | null;
-                /**
-                 * The quantity of the item.
-                 */
-                quantity: number | null;
-                /**
-                 * The total for this line item in cents.
-                 */
-                total: number | null;
-                /**
-                 * The unit cost of the item in cents.
-                 */
-                unit_cost: number | null;
-            }
-            namespace Fleet {
-                interface CardholderPromptData {
-                    /**
-                     * Driver ID.
-                     */
-                    driver_id: string | null;
-                    /**
-                     * Odometer reading.
-                     */
-                    odometer: number | null;
-                    /**
-                     * An alphanumeric ID. This field is used when a vehicle ID, driver ID, or generic ID is entered by the cardholder, but the merchant or card network did not specify the prompt type.
-                     */
-                    unspecified_id: string | null;
-                    /**
-                     * User ID.
-                     */
-                    user_id: string | null;
-                    /**
-                     * Vehicle number.
-                     */
-                    vehicle_number: string | null;
-                }
-                interface ReportedBreakdown {
-                    /**
-                     * Breakdown of fuel portion of the purchase.
-                     */
-                    fuel: ReportedBreakdown.Fuel | null;
-                    /**
-                     * Breakdown of non-fuel portion of the purchase.
-                     */
-                    non_fuel: ReportedBreakdown.NonFuel | null;
-                    /**
-                     * Information about tax included in this transaction.
-                     */
-                    tax: ReportedBreakdown.Tax | null;
-                }
-                namespace ReportedBreakdown {
-                    interface Fuel {
-                        /**
-                         * Gross fuel amount that should equal Fuel Volume multipled by Fuel Unit Cost, inclusive of taxes.
-                         */
-                        gross_amount_decimal: Decimal | null;
-                    }
-                    interface NonFuel {
-                        /**
-                         * Gross non-fuel amount that should equal the sum of the line items, inclusive of taxes.
-                         */
-                        gross_amount_decimal: Decimal | null;
-                    }
-                    interface Tax {
-                        /**
-                         * Amount of state or provincial Sales Tax included in the transaction amount. Null if not reported by merchant or not subject to tax.
-                         */
-                        local_amount_decimal: Decimal | null;
-                        /**
-                         * Amount of national Sales Tax or VAT included in the transaction amount. Null if not reported by merchant or not subject to tax.
-                         */
-                        national_amount_decimal: Decimal | null;
-                    }
-                }
-            }
-            namespace Flight {
-                interface Segment {
-                    /**
-                     * The three-letter IATA airport code of the flight's destination.
-                     */
-                    arrival_airport_code: string | null;
-                    /**
-                     * The airline carrier code.
-                     */
-                    carrier: string | null;
-                    /**
-                     * The three-letter IATA airport code that the flight departed from.
-                     */
-                    departure_airport_code: string | null;
-                    /**
-                     * The flight number.
-                     */
-                    flight_number: string | null;
-                    /**
-                     * The flight's service class.
-                     */
-                    service_class: string | null;
-                    /**
-                     * Whether a stopover is allowed on this flight.
-                     */
-                    stopover_allowed: boolean | null;
-                }
+                stopover_allowed: boolean | null;
             }
         }
     }
@@ -593,10 +438,6 @@ export declare namespace Issuing {
          * Specifies which fields in the response should be expanded.
          */
         expand?: Array<string>;
-        /**
-         * Only return transactions that are associated with the given settlement.
-         */
-        settlement?: string;
         /**
          * Only return transactions that have the given type. One of `capture` or `refund`.
          */