stripe 22.3.0 → 22.4.0-alpha.1

package/cjs/resources/PaymentAttemptRecords.d.ts

@@ -1,7 +1,7 @@
 import { StripeResource } from '../StripeResource.js';
 import { PaymentMethod } from './PaymentMethods.js';
 import { Mandate } from './Mandates.js';
-import { Metadata, Address } from '../shared.js';
+import { Emptyable, MetadataParam, AddressParam, Metadata, Address } from '../shared.js';
 import { RequestOptions, ApiListPromise, Response } from '../lib.js';
 export declare class PaymentAttemptRecordResource extends StripeResource {
     /**
@@ -12,6 +12,38 @@ export declare class PaymentAttemptRecordResource extends StripeResource {
      * Retrieves a Payment Attempt Record with the given ID
      */
     retrieve(id: string, params?: PaymentAttemptRecordRetrieveParams, options?: RequestOptions): Promise<Response<PaymentAttemptRecord>>;
+    /**
+     * Report that the specified Payment Attempt Record was authenticated.
+     */
+    reportAuthenticated(id: string, params?: PaymentAttemptRecordReportAuthenticatedParams, options?: RequestOptions): Promise<Response<PaymentAttemptRecord>>;
+    /**
+     * Report that the specified Payment Attempt Record was authorized.
+     */
+    reportAuthorized(id: string, params?: PaymentAttemptRecordReportAuthorizedParams, options?: RequestOptions): Promise<Response<PaymentAttemptRecord>>;
+    /**
+     * Report that the specified Payment Attempt Record was canceled.
+     */
+    reportCanceled(id: string, params?: PaymentAttemptRecordReportCanceledParams, options?: RequestOptions): Promise<Response<PaymentAttemptRecord>>;
+    /**
+     * Report that the specified Payment Attempt Record received an early fraud warning.
+     */
+    reportEarlyFraudWarning(id: string, params: PaymentAttemptRecordReportEarlyFraudWarningParams, options?: RequestOptions): Promise<Response<PaymentAttemptRecord>>;
+    /**
+     * Report that the specified Payment Attempt Record failed.
+     */
+    reportFailed(id: string, params?: PaymentAttemptRecordReportFailedParams, options?: RequestOptions): Promise<Response<PaymentAttemptRecord>>;
+    /**
+     * Report that the specified Payment Attempt Record was guaranteed.
+     */
+    reportGuaranteed(id: string, params?: PaymentAttemptRecordReportGuaranteedParams, options?: RequestOptions): Promise<Response<PaymentAttemptRecord>>;
+    /**
+     * Report informational updates on the specified Payment Attempt Record.
+     */
+    reportInformational(id: string, params?: PaymentAttemptRecordReportInformationalParams, options?: RequestOptions): Promise<Response<PaymentAttemptRecord>>;
+    /**
+     * Report that the specified Payment Attempt Record was refunded.
+     */
+    reportRefund(id: string, params: PaymentAttemptRecordReportRefundParams, options?: RequestOptions): Promise<Response<PaymentAttemptRecord>>;
 }
 export interface PaymentAttemptRecord {
     /**
@@ -225,8 +257,11 @@ export declare namespace PaymentAttemptRecord {
         customer_balance?: PaymentMethodDetails.CustomerBalance;
         eps?: PaymentMethodDetails.Eps;
         fpx?: PaymentMethodDetails.Fpx;
+        gift_card?: PaymentMethodDetails.GiftCard;
         giropay?: PaymentMethodDetails.Giropay;
+        gopay?: PaymentMethodDetails.Gopay;
         grabpay?: PaymentMethodDetails.Grabpay;
+        id_bank_transfer?: PaymentMethodDetails.IdBankTransfer;
         ideal?: PaymentMethodDetails.Ideal;
         interac_present?: PaymentMethodDetails.InteracPresent;
         kakao_pay?: PaymentMethodDetails.KakaoPay;
@@ -249,19 +284,25 @@ export declare namespace PaymentAttemptRecord {
         payment_method: string | null;
         paynow?: PaymentMethodDetails.Paynow;
         paypal?: PaymentMethodDetails.Paypal;
+        paypay?: PaymentMethodDetails.Paypay;
         payto?: PaymentMethodDetails.Payto;
         pix?: PaymentMethodDetails.Pix;
         promptpay?: PaymentMethodDetails.Promptpay;
+        qris?: PaymentMethodDetails.Qris;
+        rechnung?: PaymentMethodDetails.Rechnung;
         revolut_pay?: PaymentMethodDetails.RevolutPay;
         samsung_pay?: PaymentMethodDetails.SamsungPay;
         satispay?: PaymentMethodDetails.Satispay;
         scalapay?: PaymentMethodDetails.Scalapay;
         sepa_credit_transfer?: PaymentMethodDetails.SepaCreditTransfer;
         sepa_debit?: PaymentMethodDetails.SepaDebit;
+        shopeepay?: PaymentMethodDetails.Shopeepay;
         sofort?: PaymentMethodDetails.Sofort;
         stripe_account?: PaymentMethodDetails.StripeAccount;
+        stripe_balance?: PaymentMethodDetails.StripeBalance;
         sunbit?: PaymentMethodDetails.Sunbit;
         swish?: PaymentMethodDetails.Swish;
+        tamara?: PaymentMethodDetails.Tamara;
         twint?: PaymentMethodDetails.Twint;
         /**
          * The type of transaction-specific details of the payment method used in the payment. See [PaymentMethod.type](https://docs.stripe.com/api/payment_methods/object#payment_method_object-type) for the full list of possible types.
@@ -282,10 +323,22 @@ export declare namespace PaymentAttemptRecord {
          * used for this payment attempt.
          */
         custom?: ProcessorDetails.Custom;
+        /**
+         * Represents the Fiserv ValueLink gift card processor.
+         */
+        fiserv_valuelink?: ProcessorDetails.FiservValuelink;
+        /**
+         * Represents the Givex gift card processor.
+         */
+        givex?: ProcessorDetails.Givex;
+        /**
+         * Represents the SVS gift card processor.
+         */
+        svs?: ProcessorDetails.Svs;
         /**
          * The processor used for this payment attempt.
          */
-        type: 'custom';
+        type: ProcessorDetails.Type;
     }
     type ReportedBy = 'self' | 'stripe';
     interface ShippingDetails {
@@ -532,10 +585,6 @@ export declare namespace PaymentAttemptRecord {
             phone: string | null;
         }
         interface Bizum {
-            /**
-             * A unique identifier for the buyer as determined by the local payment processor.
-             */
-            buyer_id: string | null;
             /**
              * The Bizum transaction ID associated with this payment.
              */
@@ -577,7 +626,7 @@ export declare namespace PaymentAttemptRecord {
             /**
              * A high-level description of the type of cards issued in this range.
              */
-            description?: string | null;
+            description: string | null;
             /**
              * Two-digit number representing the card's expiration month.
              */
@@ -599,7 +648,7 @@ export declare namespace PaymentAttemptRecord {
             /**
              * Issuer identification number of the card.
              */
-            iin?: string | null;
+            iin: string | null;
             /**
              * Installment details for this payment.
              */
@@ -607,7 +656,7 @@ export declare namespace PaymentAttemptRecord {
             /**
              * The name of the card's issuing bank.
              */
-            issuer?: string | null;
+            issuer: string | null;
             /**
              * The last four digits of the card.
              */
@@ -636,6 +685,10 @@ export declare namespace PaymentAttemptRecord {
              * This is used by the financial networks to identify a transaction. Visa calls this the Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the Acquirer Reference Data. This value will be present if it is returned by the financial network in the authorization response, and null otherwise.
              */
             network_transaction_id: string | null;
+            /**
+             * The transaction type that was passed for an off-session, Merchant-Initiated transaction, one of `recurring` or `unscheduled`.
+             */
+            stored_credential_usage: Card.StoredCredentialUsage | null;
             /**
              * Populated if this transaction used 3D Secure authentication.
              */
@@ -720,6 +773,7 @@ export declare namespace PaymentAttemptRecord {
              * ID of the [location](https://docs.stripe.com/api/terminal/locations) that this transaction's reader is assigned to.
              */
             location?: string;
+            multicapture?: CardPresent.Multicapture;
             /**
              * Identifies which network this charge was processed on. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `interac`, `jcb`, `link`, `mastercard`, `unionpay`, `visa`, or `unknown`.
              */
@@ -748,6 +802,14 @@ export declare namespace PaymentAttemptRecord {
              * ID of the [reader](https://docs.stripe.com/api/terminal/readers) this transaction was made on.
              */
             reader?: string;
+            /**
+             * Whether the PaymentIntent can be reauthorized or not.
+             */
+            reauthorization?: CardPresent.Reauthorization | null;
+            /**
+             * The time at which the associated PaymentIntent will transition to a terminal state if it is not reauthorized.
+             */
+            reauthorize_before?: number | null;
             /**
              * A collection of fields required to be displayed on receipts. Only required for EMV transactions.
              */
@@ -822,6 +884,44 @@ export declare namespace PaymentAttemptRecord {
              */
             transaction_id: string | null;
         }
+        interface GiftCard {
+            /**
+             * The balance of the gift card after the transaction.
+             */
+            balance: GiftCard.Balance | null;
+            /**
+             * The brand of the gift card.
+             */
+            brand: GiftCard.Brand | null;
+            /**
+             * The expiration month of the gift card.
+             */
+            exp_month: number | null;
+            /**
+             * The expiration year of the gift card.
+             */
+            exp_year: number | null;
+            /**
+             * The first six digits of the gift card number.
+             */
+            first6: string | null;
+            /**
+             * The last four digits of the gift card number.
+             */
+            last4: string | null;
+            /**
+             * ID of the [location](https://docs.stripe.com/api/terminal/locations) that this transaction's reader is assigned to.
+             */
+            location?: string;
+            /**
+             * ID of the [reader](https://docs.stripe.com/api/terminal/readers) this transaction was made on.
+             */
+            reader?: string;
+            /**
+             * The transaction ID from the gift card processor.
+             */
+            transaction_id: string | null;
+        }
         interface Giropay {
             /**
              * Bank code of bank associated with the bank account.
@@ -840,12 +940,36 @@ export declare namespace PaymentAttemptRecord {
              */
             verified_name: string | null;
         }
+        interface Gopay {
+        }
         interface Grabpay {
             /**
              * Unique transaction id generated by GrabPay
              */
             transaction_id: string | null;
         }
+        interface IdBankTransfer {
+            /**
+             * Account number of the bank account to transfer funds to.
+             */
+            account_number: string;
+            /**
+             * Bank where the account is located.
+             */
+            bank: IdBankTransfer.Bank;
+            /**
+             * Local bank code of the bank.
+             */
+            bank_code?: string;
+            /**
+             * Name of the bank associated with the bank account.
+             */
+            bank_name?: string;
+            /**
+             * Merchant name and billing details name, for the customer to check for the correct merchant when performing the bank transfer.
+             */
+            display_name?: string;
+        }
         interface Ideal {
             /**
              * The customer's bank. Can be one of `abn_amro`, `adyen`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `mollie`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
@@ -1149,10 +1273,34 @@ export declare namespace PaymentAttemptRecord {
              * The level of protection offered as defined by PayPal Seller Protection for Merchants, for this transaction.
              */
             seller_protection: Paypal.SellerProtection | null;
+            /**
+             * The shipping address for the customer, as supplied by the merchant at the point of payment
+             * execution. This shipping address will not be updated if the merchant updates the shipping
+             * address on the PaymentIntent after the PaymentIntent was successfully confirmed.
+             */
+            shipping?: Address | null;
             /**
              * A unique ID generated by PayPal for this transaction.
              */
             transaction_id: string | null;
+            /**
+             * The shipping address for the customer, as supplied by the merchant at the point of payment
+             * execution. This shipping address will not be updated if the merchant updates the shipping
+             * address on the PaymentIntent after the PaymentIntent was successfully confirmed.
+             */
+            verified_address?: Address | null;
+            /**
+             * Owner's verified email. Values are verified or provided by PayPal directly
+             * (if supported) at the time of authorization or settlement. They cannot be set or mutated.
+             */
+            verified_email?: string | null;
+            /**
+             * Owner's verified full name. Values are verified or provided by PayPal directly
+             * (if supported) at the time of authorization or settlement. They cannot be set or mutated.
+             */
+            verified_name?: string | null;
+        }
+        interface Paypay {
         }
         interface Payto {
             /**
@@ -1188,6 +1336,14 @@ export declare namespace PaymentAttemptRecord {
              */
             reference: string | null;
         }
+        interface Qris {
+        }
+        interface Rechnung {
+            /**
+             * Payment portal URL.
+             */
+            payment_portal_url: string | null;
+        }
         interface RevolutPay {
             funding?: RevolutPay.Funding;
             /**
@@ -1261,6 +1417,8 @@ export declare namespace PaymentAttemptRecord {
              */
             mandate: string | null;
         }
+        interface Shopeepay {
+        }
         interface Sofort {
             /**
              * Bank code of bank associated with the bank account.
@@ -1301,6 +1459,12 @@ export declare namespace PaymentAttemptRecord {
         }
         interface StripeAccount {
         }
+        interface StripeBalance {
+            /**
+             * The connected account ID whose Stripe balance to use as the source of payment
+             */
+            account?: string | null;
+        }
         interface Sunbit {
             /**
              * The Sunbit transaction ID associated with this payment.
@@ -1321,6 +1485,12 @@ export declare namespace PaymentAttemptRecord {
              */
             verified_phone_last4: string | null;
         }
+        interface Tamara {
+            /**
+             * The Tamara transaction ID associated with this payment.
+             */
+            transaction_id: string | null;
+        }
         interface Twint {
             /**
              * ID of the multi use Mandate generated by the PaymentIntent
@@ -1418,6 +1588,10 @@ export declare namespace PaymentAttemptRecord {
                      * Card brand. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa` or `unknown`.
                      */
                     brand: string | null;
+                    /**
+                     * The [product code](https://stripe.com/docs/card-product-codes) that identifies the specific program or product associated with a card. (For internal use only and not typically available in standard API requests.)
+                     */
+                    brand_product?: string | null;
                     /**
                      * Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you've collected.
                      */
@@ -1474,6 +1648,7 @@ export declare namespace PaymentAttemptRecord {
                  */
                 used: boolean;
             }
+            type StoredCredentialUsage = 'recurring' | 'unscheduled';
             interface ThreeDSecure {
                 /**
                  * For authenticated transactions: Indicates how the issuing bank authenticated the customer.
@@ -1564,6 +1739,12 @@ export declare namespace PaymentAttemptRecord {
             }
         }
         namespace CardPresent {
+            interface Multicapture {
+                /**
+                 * Indicates whether or not multiple captures are supported.
+                 */
+                status: Multicapture.Status;
+            }
             interface Offline {
                 /**
                  * Time at which the payment was collected while offline
@@ -1575,6 +1756,12 @@ export declare namespace PaymentAttemptRecord {
                 type: 'deferred' | null;
             }
             type ReadMethod = 'contact_emv' | 'contactless_emv' | 'contactless_magstripe_mode' | 'magnetic_stripe_fallback' | 'magnetic_stripe_track2';
+            interface Reauthorization {
+                /**
+                 * Indicates whether or not the reauthorization feature is supported.
+                 */
+                status: Reauthorization.Status;
+            }
             interface Receipt {
                 /**
                  * The type of account being debited or credited
@@ -1619,6 +1806,12 @@ export declare namespace PaymentAttemptRecord {
                  */
                 type: Wallet.Type;
             }
+            namespace Multicapture {
+                type Status = 'available' | 'unavailable';
+            }
+            namespace Reauthorization {
+                type Status = 'available' | 'unavailable';
+            }
             namespace Receipt {
                 type AccountType = 'checking' | 'credit' | 'prepaid' | 'unknown';
             }
@@ -1627,8 +1820,8 @@ export declare namespace PaymentAttemptRecord {
             }
         }
         namespace Crypto {
-            type Network = 'base' | 'ethereum' | 'polygon' | 'solana' | 'sui' | 'tempo';
-            type TokenCurrency = 'phantom_cash' | 'usdc' | 'usdg' | 'usdp' | 'usdsui' | 'usdt';
+            type Network = 'base' | 'ethereum' | 'polygon' | 'solana' | 'tempo';
+            type TokenCurrency = 'phantom_cash' | 'usdc' | 'usdg' | 'usdp' | 'usdt';
         }
         namespace Eps {
             type Bank = 'arzte_und_apotheker_bank' | 'austrian_anadi_bank_ag' | 'bank_austria' | 'bankhaus_carl_spangler' | 'bankhaus_schelhammer_und_schattera_ag' | 'bawag_psk_ag' | 'bks_bank_ag' | 'brull_kallmus_bank_ag' | 'btv_vier_lander_bank' | 'capital_bank_grawe_gruppe_ag' | 'deutsche_bank_ag' | 'dolomitenbank' | 'easybank_ag' | 'erste_bank_und_sparkassen' | 'hypo_alpeadriabank_international_ag' | 'hypo_bank_burgenland_aktiengesellschaft' | 'hypo_noe_lb_fur_niederosterreich_u_wien' | 'hypo_oberosterreich_salzburg_steiermark' | 'hypo_tirol_bank_ag' | 'hypo_vorarlberg_bank_ag' | 'marchfelder_bank' | 'oberbank_ag' | 'raiffeisen_bankengruppe_osterreich' | 'schoellerbank_ag' | 'sparda_bank_wien' | 'volksbank_gruppe' | 'volkskreditbank_ag' | 'vr_bank_braunau';
@@ -1637,6 +1830,22 @@ export declare namespace PaymentAttemptRecord {
             type AccountHolderType = 'company' | 'individual';
             type Bank = 'affin_bank' | 'agrobank' | 'alliance_bank' | 'ambank' | 'bank_islam' | 'bank_muamalat' | 'bank_of_china' | 'bank_rakyat' | 'bsn' | 'cimb' | 'deutsche_bank' | 'hong_leong_bank' | 'hsbc' | 'kfh' | 'maybank2e' | 'maybank2u' | 'ocbc' | 'pb_enterprise' | 'public_bank' | 'rhb' | 'standard_chartered' | 'uob';
         }
+        namespace GiftCard {
+            interface Balance {
+                /**
+                 * The balance amount in the smallest currency unit.
+                 */
+                amount: number | null;
+                /**
+                 * The currency of the balance.
+                 */
+                currency: string | null;
+            }
+            type Brand = 'fiserv_valuelink' | 'givex' | 'svs';
+        }
+        namespace IdBankTransfer {
+            type Bank = 'bca' | 'bni' | 'bri' | 'cimb' | 'permata';
+        }
         namespace Ideal {
             type Bank = 'abn_amro' | 'adyen' | 'asn_bank' | 'bunq' | 'buut' | 'finom' | 'handelsbanken' | 'ing' | 'knab' | 'mollie' | 'moneyou' | 'n26' | 'nn' | 'rabobank' | 'regiobank' | 'revolut' | 'sns_bank' | 'triodos_bank' | 'van_lanschot' | 'yoursafe';
             type Bic = 'ABNANL2A' | 'ADYBNL2A' | 'ASNBNL21' | 'BITSNL2A' | 'BUNQNL2A' | 'BUUTNL2A' | 'FNOMNL22' | 'FVLBNL22' | 'HANDNL2A' | 'INGBNL2A' | 'KNABNL2H' | 'MLLENL2A' | 'MOYONL21' | 'NNBANL2G' | 'NTSBDEB1' | 'RABONL2U' | 'RBRBNL21' | 'REVOIE23' | 'REVOLT21' | 'SNSBNL2A' | 'TRIONL2U';
@@ -1772,6 +1981,10 @@ export declare namespace PaymentAttemptRecord {
                      * Card brand. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa` or `unknown`.
                      */
                     brand: string | null;
+                    /**
+                     * The [product code](https://stripe.com/docs/card-product-codes) that identifies the specific program or product associated with a card. (For internal use only and not typically available in standard API requests.)
+                     */
+                    brand_product?: string | null;
                     /**
                      * Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you've collected.
                      */
@@ -1810,6 +2023,25 @@ export declare namespace PaymentAttemptRecord {
              */
             payment_reference: string | null;
         }
+        interface FiservValuelink {
+            /**
+             * An opaque string for manual reconciliation of this payment, for example a check number or a payment processor ID.
+             */
+            payment_reference: string;
+        }
+        interface Givex {
+            /**
+             * An opaque string for manual reconciliation of this payment, for example a check number or a payment processor ID.
+             */
+            payment_reference: string;
+        }
+        interface Svs {
+            /**
+             * An opaque string for manual reconciliation of this payment, for example a check number or a payment processor ID.
+             */
+            payment_reference: string;
+        }
+        type Type = 'custom' | 'fiserv_valuelink' | 'givex' | 'svs';
     }
 }
 export interface PaymentAttemptRecordRetrieveParams {
@@ -1836,3 +2068,374 @@ export interface PaymentAttemptRecordListParams {
      */
     starting_after?: string;
 }
+export interface PaymentAttemptRecordReportAuthenticatedParams {
+    /**
+     * When the reported payment was authenticated. Measured in seconds since the Unix epoch.
+     */
+    authenticated_at?: number;
+    /**
+     * Specifies which fields in the response should be expanded.
+     */
+    expand?: Array<string>;
+    /**
+     * 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+     */
+    metadata?: Emptyable<MetadataParam>;
+}
+export interface PaymentAttemptRecordReportAuthorizedParams {
+    /**
+     * When the reported payment was authorized. Measured in seconds since the Unix epoch.
+     */
+    authorized_at?: number;
+    /**
+     * Specifies which fields in the response should be expanded.
+     */
+    expand?: Array<string>;
+    /**
+     * 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+     */
+    metadata?: Emptyable<MetadataParam>;
+    /**
+     * Processor information for this payment.
+     */
+    processor_details?: PaymentAttemptRecordReportAuthorizedParams.ProcessorDetails;
+}
+export declare namespace PaymentAttemptRecordReportAuthorizedParams {
+    interface ProcessorDetails {
+        /**
+         * Information about the custom processor used to make this payment.
+         */
+        custom?: ProcessorDetails.Custom;
+        /**
+         * The type of the processor details. An additional hash is included on processor_details with a name matching this value. It contains additional information specific to the processor.
+         */
+        type: 'custom';
+    }
+    namespace ProcessorDetails {
+        interface Custom {
+            /**
+             * An opaque string for manual reconciliation of this payment, for example a check number or a payment processor ID.
+             */
+            payment_reference: string;
+        }
+    }
+}
+export interface PaymentAttemptRecordReportCanceledParams {
+    /**
+     * When the reported payment was canceled. Measured in seconds since the Unix epoch.
+     */
+    canceled_at?: number;
+    /**
+     * Specifies which fields in the response should be expanded.
+     */
+    expand?: Array<string>;
+    /**
+     * 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+     */
+    metadata?: Emptyable<MetadataParam>;
+    /**
+     * Payment evaluations associated with this reported payment.
+     */
+    payment_evaluations?: Array<string>;
+    /**
+     * The reason the payment attempt was canceled.
+     */
+    reason?: 'blocked_for_fraud';
+}
+export interface PaymentAttemptRecordReportEarlyFraudWarningParams {
+    /**
+     * The type of fraud reported in the early fraud warning.
+     */
+    fraud_type: PaymentAttemptRecordReportEarlyFraudWarningParams.FraudType;
+    /**
+     * The time at which the early fraud warning was received.
+     */
+    occurred_at: number;
+    /**
+     * Specifies which fields in the response should be expanded.
+     */
+    expand?: Array<string>;
+    /**
+     * 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+     */
+    metadata?: Emptyable<MetadataParam>;
+}
+export declare namespace PaymentAttemptRecordReportEarlyFraudWarningParams {
+    type FraudType = 'made_with_lost_card' | 'made_with_stolen_card' | 'other' | 'unauthorized_use_of_card';
+}
+export interface PaymentAttemptRecordReportFailedParams {
+    /**
+     * Specifies which fields in the response should be expanded.
+     */
+    expand?: Array<string>;
+    /**
+     * When the reported payment failed. Measured in seconds since the Unix epoch.
+     */
+    failed_at?: number;
+    /**
+     * The failure code for this payment attempt. Must be one of `payment_method_customer_decline` or `payment_method_provider_unknown_outcome`.
+     */
+    failure_code?: PaymentAttemptRecordReportFailedParams.FailureCode;
+    /**
+     * 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+     */
+    metadata?: Emptyable<MetadataParam>;
+    /**
+     * Payment evaluations associated with this reported payment.
+     */
+    payment_evaluations?: Array<string>;
+    /**
+     * Processor information for this payment.
+     */
+    processor_details?: PaymentAttemptRecordReportFailedParams.ProcessorDetails;
+}
+export declare namespace PaymentAttemptRecordReportFailedParams {
+    type FailureCode = 'payment_method_customer_decline' | 'payment_method_provider_unknown_outcome';
+    interface ProcessorDetails {
+        /**
+         * Information about the custom processor used to make this payment.
+         */
+        custom?: ProcessorDetails.Custom;
+        /**
+         * The type of the processor details. An additional hash is included on processor_details with a name matching this value. It contains additional information specific to the processor.
+         */
+        type: 'custom';
+    }
+    namespace ProcessorDetails {
+        interface Custom {
+            /**
+             * An opaque string for manual reconciliation of this payment, for example a check number or a payment processor ID.
+             */
+            payment_reference: string;
+        }
+    }
+}
+export interface PaymentAttemptRecordReportGuaranteedParams {
+    /**
+     * Specifies which fields in the response should be expanded.
+     */
+    expand?: Array<string>;
+    /**
+     * When the reported payment was guaranteed. Measured in seconds since the Unix epoch.
+     */
+    guaranteed_at?: number;
+    /**
+     * 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+     */
+    metadata?: Emptyable<MetadataParam>;
+    /**
+     * Payment evaluations associated with this reported payment.
+     */
+    payment_evaluations?: Array<string>;
+    /**
+     * Information about the Payment Method debited for this payment.
+     */
+    payment_method_details?: PaymentAttemptRecordReportGuaranteedParams.PaymentMethodDetails;
+    /**
+     * Processor information for this payment.
+     */
+    processor_details?: PaymentAttemptRecordReportGuaranteedParams.ProcessorDetails;
+}
+export declare namespace PaymentAttemptRecordReportGuaranteedParams {
+    interface PaymentMethodDetails {
+        /**
+         * Information about the card payment method used to make this payment.
+         */
+        card?: PaymentMethodDetails.Card;
+        /**
+         * The type of the payment method details. An additional hash is included on the payment_method_details with a name matching this value. It contains additional information specific to the type.
+         */
+        type: 'card';
+    }
+    interface ProcessorDetails {
+        /**
+         * Information about the custom processor used to make this payment.
+         */
+        custom?: ProcessorDetails.Custom;
+        /**
+         * The type of the processor details. An additional hash is included on processor_details with a name matching this value. It contains additional information specific to the processor.
+         */
+        type: 'custom';
+    }
+    namespace PaymentMethodDetails {
+        interface Card {
+            /**
+             * Verification checks performed on the card.
+             */
+            checks?: Card.Checks;
+        }
+        namespace Card {
+            interface Checks {
+                /**
+                 * The result of the check on the cardholder's address line 1.
+                 */
+                address_line1_check?: Checks.AddressLine1Check;
+                /**
+                 * The result of the check on the cardholder's postal code.
+                 */
+                address_postal_code_check?: Checks.AddressPostalCodeCheck;
+                /**
+                 * The result of the check on the card's CVC.
+                 */
+                cvc_check?: Checks.CvcCheck;
+            }
+            namespace Checks {
+                type AddressLine1Check = 'fail' | 'pass' | 'unavailable' | 'unchecked';
+                type AddressPostalCodeCheck = 'fail' | 'pass' | 'unavailable' | 'unchecked';
+                type CvcCheck = 'fail' | 'pass' | 'unavailable' | 'unchecked';
+            }
+        }
+    }
+    namespace ProcessorDetails {
+        interface Custom {
+            /**
+             * An opaque string for manual reconciliation of this payment, for example a check number or a payment processor ID.
+             */
+            payment_reference: string;
+        }
+    }
+}
+export interface PaymentAttemptRecordReportInformationalParams {
+    /**
+     * Customer information for this payment.
+     */
+    customer_details?: PaymentAttemptRecordReportInformationalParams.CustomerDetails;
+    /**
+     * An arbitrary string attached to the object. Often useful for displaying to users.
+     */
+    description?: Emptyable<string>;
+    /**
+     * Specifies which fields in the response should be expanded.
+     */
+    expand?: Array<string>;
+    /**
+     * 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+     */
+    metadata?: Emptyable<MetadataParam>;
+    /**
+     * Shipping information for this payment.
+     */
+    shipping_details?: Emptyable<PaymentAttemptRecordReportInformationalParams.ShippingDetails>;
+}
+export declare namespace PaymentAttemptRecordReportInformationalParams {
+    interface CustomerDetails {
+        /**
+         * The customer who made the payment.
+         */
+        customer?: string;
+        /**
+         * The customer's phone number.
+         */
+        email?: string;
+        /**
+         * The customer's name.
+         */
+        name?: string;
+        /**
+         * The customer's phone number.
+         */
+        phone?: string;
+    }
+    interface ShippingDetails {
+        /**
+         * The physical shipping address.
+         */
+        address?: AddressParam;
+        /**
+         * The shipping recipient's name.
+         */
+        name?: string;
+        /**
+         * The shipping recipient's phone number.
+         */
+        phone?: string;
+    }
+}
+export interface PaymentAttemptRecordReportRefundParams {
+    /**
+     * Processor information for this refund.
+     */
+    processor_details: PaymentAttemptRecordReportRefundParams.ProcessorDetails;
+    /**
+     * A positive integer in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) representing how much of this payment to refund. Can refund only up to the remaining, unrefunded amount of the payment.
+     */
+    amount?: PaymentAttemptRecordReportRefundParams.Amount;
+    /**
+     * Specifies which fields in the response should be expanded.
+     */
+    expand?: Array<string>;
+    /**
+     * Information about the refund failure.
+     */
+    failed?: PaymentAttemptRecordReportRefundParams.Failed;
+    /**
+     * When the reported refund was initiated. Measured in seconds since the Unix epoch.
+     */
+    initiated_at?: number;
+    /**
+     * 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+     */
+    metadata?: Emptyable<MetadataParam>;
+    /**
+     * The outcome of the reported refund.
+     */
+    outcome?: PaymentAttemptRecordReportRefundParams.Outcome;
+    /**
+     * A key to group refunds together.
+     */
+    refund_group?: string;
+    /**
+     * Information about the payment attempt refund.
+     */
+    refunded?: PaymentAttemptRecordReportRefundParams.Refunded;
+}
+export declare namespace PaymentAttemptRecordReportRefundParams {
+    interface ProcessorDetails {
+        /**
+         * Information about the custom processor used to make this refund.
+         */
+        custom?: ProcessorDetails.Custom;
+        /**
+         * The type of the processor details. An additional hash is included on processor_details with a name matching this value. It contains additional information specific to the processor.
+         */
+        type: 'custom';
+    }
+    interface Amount {
+        /**
+         * 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;
+        /**
+         * A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY.
+         */
+        value: number;
+    }
+    interface Failed {
+        /**
+         * When the reported refund failed. Measured in seconds since the Unix epoch.
+         */
+        failed_at?: number;
+        /**
+         * Provides the reason for the refund failure. Possible values are: `lost_or_stolen_card`, `expired_or_canceled_card`, `charge_for_pending_refund_disputed`, `insufficient_funds`, `declined`, `merchant_request`, or `unknown`.
+         */
+        failure_reason?: Failed.FailureReason;
+    }
+    type Outcome = 'failed' | 'refunded';
+    interface Refunded {
+        /**
+         * When the reported refund completed. Measured in seconds since the Unix epoch.
+         */
+        refunded_at: number;
+    }
+    namespace Failed {
+        type FailureReason = 'charge_for_pending_refund_disputed' | 'declined' | 'expired_or_canceled_card' | 'insufficient_funds' | 'lost_or_stolen_card' | 'merchant_request' | 'unknown';
+    }
+    namespace ProcessorDetails {
+        interface Custom {
+            /**
+             * A reference to the external refund. This field must be unique across all refunds.
+             */
+            refund_reference: string;
+        }
+    }
+}