stripe 22.3.0 → 22.4.0-alpha.2

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 {
@@ -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.
              */
@@ -769,6 +831,14 @@ export declare namespace PaymentAttemptRecord {
             transaction_id: string | null;
         }
         interface Crypto {
+            /**
+             * The amount received for the crypto payment.
+             */
+            amount_received?: number;
+            /**
+             * The amount requested for the crypto payment.
+             */
+            amount_requested?: number;
             /**
              * The wallet address of the customer.
              */
@@ -822,6 +892,48 @@ 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;
+            /**
+             * Uniquely identifies this particular gift card number. You can use this attribute to check whether two transactions were made using the same gift card.
+             */
+            fingerprint: string | 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 +952,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 +1285,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 +1348,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 +1429,8 @@ export declare namespace PaymentAttemptRecord {
              */
             mandate: string | null;
         }
+        interface Shopeepay {
+        }
         interface Sofort {
             /**
              * Bank code of bank associated with the bank account.
@@ -1301,6 +1471,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 +1497,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 +1600,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.
                      */
@@ -1564,6 +1750,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 +1767,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 +1817,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';
             }
@@ -1637,6 +1841,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 +1992,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 +2034,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 +2079,422 @@ 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>;
+    /**
+     * Information about the Payment Method debited for this payment.
+     */
+    payment_method_details?: PaymentAttemptRecordReportFailedParams.PaymentMethodDetails;
+    /**
+     * 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 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 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;
+    /**
+     * The reason for the refund. One of `duplicate`, `fraudulent`, or `requested_by_customer`.
+     */
+    reason?: PaymentAttemptRecordReportRefundParams.Reason;
+    /**
+     * 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';
+    type Reason = 'duplicate' | 'fraudulent' | 'requested_by_customer';
+    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;
+        }
+    }
+}