stripe 16.7.0 → 16.8.0-beta.1

package/types/Disputes.d.ts

@@ -45,6 +45,11 @@ declare module 'stripe' {
        */
       currency: string;
 
+      /**
+       * List of eligibility types that are included in `enhanced_evidence`.
+       */
+      enhanced_eligibility_types?: Array<'visa_compelling_evidence_3'>;
+
       evidence: Dispute.Evidence;
 
       evidence_details: Dispute.EvidenceDetails;
@@ -154,6 +159,8 @@ declare module 'stripe' {
          */
         duplicate_charge_id: string | null;
 
+        enhanced_evidence?: Evidence.EnhancedEvidence;
+
         /**
          * A description of the product or service that was sold.
          */
@@ -225,12 +232,126 @@ declare module 'stripe' {
         uncategorized_text: string | null;
       }
 
+      namespace Evidence {
+        interface EnhancedEvidence {
+          visa_compelling_evidence_3?: EnhancedEvidence.VisaCompellingEvidence3;
+        }
+
+        namespace EnhancedEvidence {
+          interface VisaCompellingEvidence3 {
+            /**
+             * Disputed transaction details for Visa Compelling Evidence 3.0 evidence submission.
+             */
+            disputed_transaction: VisaCompellingEvidence3.DisputedTransaction | null;
+
+            /**
+             * List of exactly two prior undisputed transaction objects for Visa Compelling Evidence 3.0 evidence submission.
+             */
+            prior_undisputed_transactions: Array<
+              VisaCompellingEvidence3.PriorUndisputedTransaction
+            >;
+          }
+
+          namespace VisaCompellingEvidence3 {
+            interface DisputedTransaction {
+              /**
+               * User Account ID used to log into business platform. Must be recognizable by the user.
+               */
+              customer_account_id: string | null;
+
+              /**
+               * Unique identifier of the cardholder's device derived from a combination of at least two hardware and software attributes. Must be at least 20 characters.
+               */
+              customer_device_fingerprint: string | null;
+
+              /**
+               * Unique identifier of the cardholder's device such as a device serial number (e.g., International Mobile Equipment Identity [IMEI]). Must be at least 15 characters.
+               */
+              customer_device_id: string | null;
+
+              /**
+               * The email address of the customer.
+               */
+              customer_email_address: string | null;
+
+              /**
+               * The IP address that the customer used when making the purchase.
+               */
+              customer_purchase_ip: string | null;
+
+              /**
+               * Categorization of disputed payment.
+               */
+              merchandise_or_services: DisputedTransaction.MerchandiseOrServices | null;
+
+              /**
+               * A description of the product or service that was sold.
+               */
+              product_description: string | null;
+
+              /**
+               * The address to which a physical product was shipped. All fields are required for Visa Compelling Evidence 3.0 evidence submission.
+               */
+              shipping_address: Stripe.Address | null;
+            }
+
+            namespace DisputedTransaction {
+              type MerchandiseOrServices = 'merchandise' | 'services';
+            }
+
+            interface PriorUndisputedTransaction {
+              /**
+               * Stripe charge ID for the Visa Compelling Evidence 3.0 eligible prior charge.
+               */
+              charge: string;
+
+              /**
+               * User Account ID used to log into business platform. Must be recognizable by the user.
+               */
+              customer_account_id: string | null;
+
+              /**
+               * Unique identifier of the cardholder's device derived from a combination of at least two hardware and software attributes. Must be at least 20 characters.
+               */
+              customer_device_fingerprint: string | null;
+
+              /**
+               * Unique identifier of the cardholder's device such as a device serial number (e.g., International Mobile Equipment Identity [IMEI]). Must be at least 15 characters.
+               */
+              customer_device_id: string | null;
+
+              /**
+               * The email address of the customer.
+               */
+              customer_email_address: string | null;
+
+              /**
+               * The IP address that the customer used when making the purchase.
+               */
+              customer_purchase_ip: string | null;
+
+              /**
+               * A description of the product or service that was sold.
+               */
+              product_description: string | null;
+
+              /**
+               * The address to which a physical product was shipped. All fields are required for Visa Compelling Evidence 3.0 evidence submission.
+               */
+              shipping_address: Stripe.Address | null;
+            }
+          }
+        }
+      }
+
       interface EvidenceDetails {
         /**
          * Date by which evidence must be submitted in order to successfully challenge dispute. Will be 0 if the customer's bank or credit card company doesn't allow a response for this particular dispute.
          */
         due_by: number | null;
 
+        enhanced_eligibility?: EvidenceDetails.EnhancedEligibility;
+
         /**
          * Whether evidence has been staged for this dispute.
          */
@@ -247,6 +368,43 @@ declare module 'stripe' {
         submission_count: number;
       }
 
+      namespace EvidenceDetails {
+        interface EnhancedEligibility {
+          visa_compelling_evidence_3?: EnhancedEligibility.VisaCompellingEvidence3;
+        }
+
+        namespace EnhancedEligibility {
+          interface VisaCompellingEvidence3 {
+            /**
+             * List of actions required to qualify dispute for Visa Compelling Evidence 3.0 evidence submission.
+             */
+            required_actions: Array<VisaCompellingEvidence3.RequiredAction>;
+
+            /**
+             * Visa Compelling Evidence 3.0 eligibility status.
+             */
+            status: VisaCompellingEvidence3.Status;
+          }
+
+          namespace VisaCompellingEvidence3 {
+            type RequiredAction =
+              | 'missing_customer_identifiers'
+              | 'missing_disputed_transaction_description'
+              | 'missing_merchandise_or_services'
+              | 'missing_prior_undisputed_transaction_description'
+              | 'missing_prior_undisputed_transactions';
+
+            type Status =
+              | 'accepted'
+              | 'not_qualified'
+              | 'partner_rejected'
+              | 'qualified'
+              | 'requires_action'
+              | 'submitted';
+          }
+        }
+      }
+
       interface PaymentMethodDetails {
         card?: PaymentMethodDetails.Card;
 

package/types/DisputesResource.d.ts

@@ -98,6 +98,11 @@ declare module 'stripe' {
          */
         duplicate_charge_id?: string;
 
+        /**
+         * Additional evidence for qualifying evidence programs.
+         */
+        enhanced_evidence?: Stripe.Emptyable<Evidence.EnhancedEvidence>;
+
         /**
          * A description of the product or service that was sold. Has a maximum character count of 20,000.
          */
@@ -168,6 +173,121 @@ declare module 'stripe' {
          */
         uncategorized_text?: string;
       }
+
+      namespace Evidence {
+        interface EnhancedEvidence {
+          /**
+           * Evidence provided for Visa Compelling Evidence 3.0 evidence submission.
+           */
+          visa_compelling_evidence_3?: EnhancedEvidence.VisaCompellingEvidence3;
+        }
+
+        namespace EnhancedEvidence {
+          interface VisaCompellingEvidence3 {
+            /**
+             * Disputed transaction details for Visa Compelling Evidence 3.0 evidence submission.
+             */
+            disputed_transaction?: VisaCompellingEvidence3.DisputedTransaction;
+
+            /**
+             * List of exactly two prior undisputed transaction objects for Visa Compelling Evidence 3.0 evidence submission.
+             */
+            prior_undisputed_transactions?: Array<
+              VisaCompellingEvidence3.PriorUndisputedTransaction
+            >;
+          }
+
+          namespace VisaCompellingEvidence3 {
+            interface DisputedTransaction {
+              /**
+               * User Account ID used to log into business platform. Must be recognizable by the user.
+               */
+              customer_account_id?: Stripe.Emptyable<string>;
+
+              /**
+               * Unique identifier of the cardholder's device derived from a combination of at least two hardware and software attributes. Must be at least 20 characters.
+               */
+              customer_device_fingerprint?: Stripe.Emptyable<string>;
+
+              /**
+               * Unique identifier of the cardholder's device such as a device serial number (e.g., International Mobile Equipment Identity [IMEI]). Must be at least 15 characters.
+               */
+              customer_device_id?: Stripe.Emptyable<string>;
+
+              /**
+               * The email address of the customer.
+               */
+              customer_email_address?: Stripe.Emptyable<string>;
+
+              /**
+               * The IP address that the customer used when making the purchase.
+               */
+              customer_purchase_ip?: Stripe.Emptyable<string>;
+
+              /**
+               * Categorization of disputed payment.
+               */
+              merchandise_or_services?: DisputedTransaction.MerchandiseOrServices;
+
+              /**
+               * A description of the product or service that was sold.
+               */
+              product_description?: Stripe.Emptyable<string>;
+
+              /**
+               * The address to which a physical product was shipped. All fields are required for Visa Compelling Evidence 3.0 evidence submission.
+               */
+              shipping_address?: Stripe.AddressParam;
+            }
+
+            namespace DisputedTransaction {
+              type MerchandiseOrServices = 'merchandise' | 'services';
+            }
+
+            interface PriorUndisputedTransaction {
+              /**
+               * Stripe charge ID for the Visa Compelling Evidence 3.0 eligible prior charge.
+               */
+              charge: string;
+
+              /**
+               * User Account ID used to log into business platform. Must be recognizable by the user.
+               */
+              customer_account_id?: Stripe.Emptyable<string>;
+
+              /**
+               * Unique identifier of the cardholder's device derived from a combination of at least two hardware and software attributes. Must be at least 20 characters.
+               */
+              customer_device_fingerprint?: Stripe.Emptyable<string>;
+
+              /**
+               * Unique identifier of the cardholder's device such as a device serial number (e.g., International Mobile Equipment Identity [IMEI]). Must be at least 15 characters.
+               */
+              customer_device_id?: Stripe.Emptyable<string>;
+
+              /**
+               * The email address of the customer.
+               */
+              customer_email_address?: Stripe.Emptyable<string>;
+
+              /**
+               * The IP address that the customer used when making the purchase.
+               */
+              customer_purchase_ip?: Stripe.Emptyable<string>;
+
+              /**
+               * A description of the product or service that was sold.
+               */
+              product_description?: Stripe.Emptyable<string>;
+
+              /**
+               * The address to which a physical product was shipped. All fields are required for Visa Compelling Evidence 3.0 evidence submission.
+               */
+              shipping_address?: Stripe.AddressParam;
+            }
+          }
+        }
+      }
     }
 
     interface DisputeListParams extends PaginationParams {