@peable.to/contracts 0.4.0 → 1.1.0

package/dist/types/resources/payments/disputes.d.ts

@@ -0,0 +1,822 @@
+import { z } from 'zod';
+import { type Expand } from '../../common/objects';
+/**
+ * A merchant's evidence as the dispute holds it. Present ONLY on a live read
+ * (`GET /v1/disputes/{id}` and the answers of its update and close): the text
+ * is read from the provider, where a draft lives (Peable keeps none of its
+ * words); the file half is the `file_…` ids attached. Lists and events never
+ * carry it.
+ */
+export declare const disputeEvidenceSchema: z.ZodObject<{
+    customer_name: z.ZodNullable<z.ZodString>;
+    billing_address: z.ZodNullable<z.ZodString>;
+    access_activity_log: z.ZodNullable<z.ZodString>;
+    cancellation_policy_disclosure: z.ZodNullable<z.ZodString>;
+    cancellation_rebuttal: z.ZodNullable<z.ZodString>;
+    customer_email_address: z.ZodNullable<z.ZodString>;
+    customer_purchase_ip: z.ZodNullable<z.ZodString>;
+    duplicate_charge_explanation: z.ZodNullable<z.ZodString>;
+    product_description: z.ZodNullable<z.ZodString>;
+    refund_policy_disclosure: z.ZodNullable<z.ZodString>;
+    refund_refusal_explanation: z.ZodNullable<z.ZodString>;
+    service_date: z.ZodNullable<z.ZodString>;
+    shipping_address: z.ZodNullable<z.ZodString>;
+    shipping_carrier: z.ZodNullable<z.ZodString>;
+    shipping_date: z.ZodNullable<z.ZodString>;
+    shipping_tracking_number: z.ZodNullable<z.ZodString>;
+    uncategorized_text: z.ZodNullable<z.ZodString>;
+    cancellation_policy: z.ZodNullable<z.ZodString>;
+    customer_communication: z.ZodNullable<z.ZodString>;
+    customer_signature: z.ZodNullable<z.ZodString>;
+    duplicate_charge_documentation: z.ZodNullable<z.ZodString>;
+    receipt: z.ZodNullable<z.ZodString>;
+    refund_policy: z.ZodNullable<z.ZodString>;
+    service_documentation: z.ZodNullable<z.ZodString>;
+    shipping_documentation: z.ZodNullable<z.ZodString>;
+    uncategorized_file: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type DisputeEvidence = z.output<typeof disputeEvidenceSchema>;
+export declare const disputeEvidenceDetailsSchema: z.ZodObject<{
+    due_by: z.ZodNullable<z.ZodNumber>;
+    has_evidence: z.ZodBoolean;
+    past_due: z.ZodBoolean;
+    submission_count: z.ZodNumber;
+    submitted_at: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strict>;
+export type DisputeEvidenceDetails = z.output<typeof disputeEvidenceDetailsSchema>;
+export declare const disputeSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodLiteral<"dispute">;
+    livemode: z.ZodBoolean;
+    amount: z.ZodString;
+    currency: z.ZodEnum<{
+        FAIR: "FAIR";
+        EUR: "EUR";
+        USD: "USD";
+        GBP: "GBP";
+        CHF: "CHF";
+        SEK: "SEK";
+        NOK: "NOK";
+        DKK: "DKK";
+        PLN: "PLN";
+        CZK: "CZK";
+        CAD: "CAD";
+        AUD: "AUD";
+        JPY: "JPY";
+    }>;
+    charge: z.ZodNullable<z.ZodType<string | import("../..").Ref<"charge">, string | import("../..").Ref<"charge">, z.core.$ZodTypeInternals<string | import("../..").Ref<"charge">, string | import("../..").Ref<"charge">>>>;
+    payment_intent: z.ZodType<string | import("../..").Ref<"payment_intent">, string | import("../..").Ref<"payment_intent">, z.core.$ZodTypeInternals<string | import("../..").Ref<"payment_intent">, string | import("../..").Ref<"payment_intent">>>;
+    status: z.ZodEnum<{
+        needs_response: "needs_response";
+        under_review: "under_review";
+        won: "won";
+        lost: "lost";
+    }>;
+    reason: z.ZodEnum<{
+        duplicate: "duplicate";
+        fraudulent: "fraudulent";
+        bank_cannot_process: "bank_cannot_process";
+        check_returned: "check_returned";
+        credit_not_processed: "credit_not_processed";
+        customer_initiated: "customer_initiated";
+        debit_not_authorized: "debit_not_authorized";
+        general: "general";
+        incorrect_account_details: "incorrect_account_details";
+        insufficient_funds: "insufficient_funds";
+        noncompliant: "noncompliant";
+        product_not_received: "product_not_received";
+        product_unacceptable: "product_unacceptable";
+        subscription_canceled: "subscription_canceled";
+        unrecognized: "unrecognized";
+    }>;
+    is_charge_refundable: z.ZodBoolean;
+    evidence_details: z.ZodObject<{
+        due_by: z.ZodNullable<z.ZodNumber>;
+        has_evidence: z.ZodBoolean;
+        past_due: z.ZodBoolean;
+        submission_count: z.ZodNumber;
+        submitted_at: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>;
+    evidence: z.ZodOptional<z.ZodObject<{
+        customer_name: z.ZodNullable<z.ZodString>;
+        billing_address: z.ZodNullable<z.ZodString>;
+        access_activity_log: z.ZodNullable<z.ZodString>;
+        cancellation_policy_disclosure: z.ZodNullable<z.ZodString>;
+        cancellation_rebuttal: z.ZodNullable<z.ZodString>;
+        customer_email_address: z.ZodNullable<z.ZodString>;
+        customer_purchase_ip: z.ZodNullable<z.ZodString>;
+        duplicate_charge_explanation: z.ZodNullable<z.ZodString>;
+        product_description: z.ZodNullable<z.ZodString>;
+        refund_policy_disclosure: z.ZodNullable<z.ZodString>;
+        refund_refusal_explanation: z.ZodNullable<z.ZodString>;
+        service_date: z.ZodNullable<z.ZodString>;
+        shipping_address: z.ZodNullable<z.ZodString>;
+        shipping_carrier: z.ZodNullable<z.ZodString>;
+        shipping_date: z.ZodNullable<z.ZodString>;
+        shipping_tracking_number: z.ZodNullable<z.ZodString>;
+        uncategorized_text: z.ZodNullable<z.ZodString>;
+        cancellation_policy: z.ZodNullable<z.ZodString>;
+        customer_communication: z.ZodNullable<z.ZodString>;
+        customer_signature: z.ZodNullable<z.ZodString>;
+        duplicate_charge_documentation: z.ZodNullable<z.ZodString>;
+        receipt: z.ZodNullable<z.ZodString>;
+        refund_policy: z.ZodNullable<z.ZodString>;
+        service_documentation: z.ZodNullable<z.ZodString>;
+        shipping_documentation: z.ZodNullable<z.ZodString>;
+        uncategorized_file: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+    created: z.ZodNumber;
+    updated_at: z.ZodNumber;
+}, z.core.$strict>;
+export type Dispute = Expand<z.output<typeof disputeSchema>>;
+declare module '../../common/objects' {
+    interface ObjectMap {
+        dispute: Dispute;
+    }
+}
+/**
+ * The evidence fields, in the network's names — a CLOSED set. Unknown keys are
+ * REFUSED rather than dropped: a merchant who sent `tracking_number` instead of
+ * `shipping_tracking_number` would otherwise submit, finally, a response
+ * missing the field they relied on.
+ */
+export declare const disputeEvidenceParams: z.ZodObject<{
+    cancellation_policy: z.ZodOptional<z.ZodString>;
+    customer_communication: z.ZodOptional<z.ZodString>;
+    customer_signature: z.ZodOptional<z.ZodString>;
+    duplicate_charge_documentation: z.ZodOptional<z.ZodString>;
+    receipt: z.ZodOptional<z.ZodString>;
+    refund_policy: z.ZodOptional<z.ZodString>;
+    service_documentation: z.ZodOptional<z.ZodString>;
+    shipping_documentation: z.ZodOptional<z.ZodString>;
+    uncategorized_file: z.ZodOptional<z.ZodString>;
+    customer_name: z.ZodOptional<z.ZodString>;
+    billing_address: z.ZodOptional<z.ZodString>;
+    access_activity_log: z.ZodOptional<z.ZodString>;
+    cancellation_policy_disclosure: z.ZodOptional<z.ZodString>;
+    cancellation_rebuttal: z.ZodOptional<z.ZodString>;
+    customer_email_address: z.ZodOptional<z.ZodString>;
+    customer_purchase_ip: z.ZodOptional<z.ZodString>;
+    duplicate_charge_explanation: z.ZodOptional<z.ZodString>;
+    product_description: z.ZodOptional<z.ZodString>;
+    refund_policy_disclosure: z.ZodOptional<z.ZodString>;
+    refund_refusal_explanation: z.ZodOptional<z.ZodString>;
+    service_date: z.ZodOptional<z.ZodString>;
+    shipping_address: z.ZodOptional<z.ZodString>;
+    shipping_carrier: z.ZodOptional<z.ZodString>;
+    shipping_date: z.ZodOptional<z.ZodString>;
+    shipping_tracking_number: z.ZodOptional<z.ZodString>;
+    uncategorized_text: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type DisputeEvidenceParams = z.input<typeof disputeEvidenceParams>;
+/**
+ * `submit: false` (the default) STAGES the evidence: text goes to the provider
+ * as a draft, files are attached by id. `submit: true` uploads the attached
+ * files and submits everything — ONCE; a second submission is refused.
+ */
+export declare const updateDisputeParams: z.ZodObject<{
+    evidence: z.ZodOptional<z.ZodObject<{
+        cancellation_policy: z.ZodOptional<z.ZodString>;
+        customer_communication: z.ZodOptional<z.ZodString>;
+        customer_signature: z.ZodOptional<z.ZodString>;
+        duplicate_charge_documentation: z.ZodOptional<z.ZodString>;
+        receipt: z.ZodOptional<z.ZodString>;
+        refund_policy: z.ZodOptional<z.ZodString>;
+        service_documentation: z.ZodOptional<z.ZodString>;
+        shipping_documentation: z.ZodOptional<z.ZodString>;
+        uncategorized_file: z.ZodOptional<z.ZodString>;
+        customer_name: z.ZodOptional<z.ZodString>;
+        billing_address: z.ZodOptional<z.ZodString>;
+        access_activity_log: z.ZodOptional<z.ZodString>;
+        cancellation_policy_disclosure: z.ZodOptional<z.ZodString>;
+        cancellation_rebuttal: z.ZodOptional<z.ZodString>;
+        customer_email_address: z.ZodOptional<z.ZodString>;
+        customer_purchase_ip: z.ZodOptional<z.ZodString>;
+        duplicate_charge_explanation: z.ZodOptional<z.ZodString>;
+        product_description: z.ZodOptional<z.ZodString>;
+        refund_policy_disclosure: z.ZodOptional<z.ZodString>;
+        refund_refusal_explanation: z.ZodOptional<z.ZodString>;
+        service_date: z.ZodOptional<z.ZodString>;
+        shipping_address: z.ZodOptional<z.ZodString>;
+        shipping_carrier: z.ZodOptional<z.ZodString>;
+        shipping_date: z.ZodOptional<z.ZodString>;
+        shipping_tracking_number: z.ZodOptional<z.ZodString>;
+        uncategorized_text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    metadata: z.ZodOptional<z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodString>, z.ZodTransform<import("../..").MetadataPatch, Record<string, string>>>>;
+    submit: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type UpdateDisputeParams = z.input<typeof updateDisputeParams>;
+export declare const closeDisputeParams: z.ZodObject<{}, z.core.$strict>;
+export declare const listDisputesQuery: z.ZodObject<{
+    limit: z.ZodPipe<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>, z.ZodTransform<number, number | undefined>>;
+    starting_after: z.ZodOptional<z.ZodString>;
+    ending_before: z.ZodOptional<z.ZodString>;
+    created: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>, z.ZodTransform<import("../..").RangeFilter, number>>, z.ZodPipe<z.ZodObject<{
+        gt: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+        gte: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+        lt: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+        lte: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+    }, z.core.$strict>, z.ZodTransform<import("../..").RangeFilter, {
+        gt?: number | undefined;
+        gte?: number | undefined;
+        lt?: number | undefined;
+        lte?: number | undefined;
+    }>>]>>;
+    expand: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodString>>>;
+    payment_intent: z.ZodOptional<z.ZodString>;
+    charge: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ListDisputesParams = z.input<typeof listDisputesQuery>;
+/** The per-payment sub-list: the payment is in the path. */
+export declare const listPaymentIntentDisputesQuery: z.ZodObject<{
+    limit: z.ZodPipe<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>, z.ZodTransform<number, number | undefined>>;
+    starting_after: z.ZodOptional<z.ZodString>;
+    ending_before: z.ZodOptional<z.ZodString>;
+    created: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>, z.ZodTransform<import("../..").RangeFilter, number>>, z.ZodPipe<z.ZodObject<{
+        gt: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+        gte: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+        lt: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+        lte: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+    }, z.core.$strict>, z.ZodTransform<import("../..").RangeFilter, {
+        gt?: number | undefined;
+        gte?: number | undefined;
+        lt?: number | undefined;
+        lte?: number | undefined;
+    }>>]>>;
+    expand: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodString>>>;
+}, z.core.$strict>;
+export declare const disputeRoutes: readonly [{
+    readonly operationId: "listPaymentIntentDisputes";
+    readonly method: "get";
+    readonly path: "/v1/payment_intents/{intentId}/disputes";
+    readonly tag: "Disputes";
+    readonly summary: "List a payment's disputes";
+    readonly auth: "service";
+    readonly scope: "payments:read";
+    readonly params: {
+        readonly intentId: "The payment intent (`pi_…`).";
+    };
+    readonly query: z.ZodObject<{
+        limit: z.ZodPipe<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>, z.ZodTransform<number, number | undefined>>;
+        starting_after: z.ZodOptional<z.ZodString>;
+        ending_before: z.ZodOptional<z.ZodString>;
+        created: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>, z.ZodTransform<import("../..").RangeFilter, number>>, z.ZodPipe<z.ZodObject<{
+            gt: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+            gte: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+            lt: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+            lte: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+        }, z.core.$strict>, z.ZodTransform<import("../..").RangeFilter, {
+            gt?: number | undefined;
+            gte?: number | undefined;
+            lt?: number | undefined;
+            lte?: number | undefined;
+        }>>]>>;
+        expand: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodString>>>;
+    }, z.core.$strict>;
+    readonly response: z.ZodObject<{
+        object: z.ZodLiteral<"list">;
+        data: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            object: z.ZodLiteral<"dispute">;
+            livemode: z.ZodBoolean;
+            amount: z.ZodString;
+            currency: z.ZodEnum<{
+                FAIR: "FAIR";
+                EUR: "EUR";
+                USD: "USD";
+                GBP: "GBP";
+                CHF: "CHF";
+                SEK: "SEK";
+                NOK: "NOK";
+                DKK: "DKK";
+                PLN: "PLN";
+                CZK: "CZK";
+                CAD: "CAD";
+                AUD: "AUD";
+                JPY: "JPY";
+            }>;
+            charge: z.ZodNullable<z.ZodType<string | import("../..").Ref<"charge">, string | import("../..").Ref<"charge">, z.core.$ZodTypeInternals<string | import("../..").Ref<"charge">, string | import("../..").Ref<"charge">>>>;
+            payment_intent: z.ZodType<string | import("../..").Ref<"payment_intent">, string | import("../..").Ref<"payment_intent">, z.core.$ZodTypeInternals<string | import("../..").Ref<"payment_intent">, string | import("../..").Ref<"payment_intent">>>;
+            status: z.ZodEnum<{
+                needs_response: "needs_response";
+                under_review: "under_review";
+                won: "won";
+                lost: "lost";
+            }>;
+            reason: z.ZodEnum<{
+                duplicate: "duplicate";
+                fraudulent: "fraudulent";
+                bank_cannot_process: "bank_cannot_process";
+                check_returned: "check_returned";
+                credit_not_processed: "credit_not_processed";
+                customer_initiated: "customer_initiated";
+                debit_not_authorized: "debit_not_authorized";
+                general: "general";
+                incorrect_account_details: "incorrect_account_details";
+                insufficient_funds: "insufficient_funds";
+                noncompliant: "noncompliant";
+                product_not_received: "product_not_received";
+                product_unacceptable: "product_unacceptable";
+                subscription_canceled: "subscription_canceled";
+                unrecognized: "unrecognized";
+            }>;
+            is_charge_refundable: z.ZodBoolean;
+            evidence_details: z.ZodObject<{
+                due_by: z.ZodNullable<z.ZodNumber>;
+                has_evidence: z.ZodBoolean;
+                past_due: z.ZodBoolean;
+                submission_count: z.ZodNumber;
+                submitted_at: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strict>;
+            evidence: z.ZodOptional<z.ZodObject<{
+                customer_name: z.ZodNullable<z.ZodString>;
+                billing_address: z.ZodNullable<z.ZodString>;
+                access_activity_log: z.ZodNullable<z.ZodString>;
+                cancellation_policy_disclosure: z.ZodNullable<z.ZodString>;
+                cancellation_rebuttal: z.ZodNullable<z.ZodString>;
+                customer_email_address: z.ZodNullable<z.ZodString>;
+                customer_purchase_ip: z.ZodNullable<z.ZodString>;
+                duplicate_charge_explanation: z.ZodNullable<z.ZodString>;
+                product_description: z.ZodNullable<z.ZodString>;
+                refund_policy_disclosure: z.ZodNullable<z.ZodString>;
+                refund_refusal_explanation: z.ZodNullable<z.ZodString>;
+                service_date: z.ZodNullable<z.ZodString>;
+                shipping_address: z.ZodNullable<z.ZodString>;
+                shipping_carrier: z.ZodNullable<z.ZodString>;
+                shipping_date: z.ZodNullable<z.ZodString>;
+                shipping_tracking_number: z.ZodNullable<z.ZodString>;
+                uncategorized_text: z.ZodNullable<z.ZodString>;
+                cancellation_policy: z.ZodNullable<z.ZodString>;
+                customer_communication: z.ZodNullable<z.ZodString>;
+                customer_signature: z.ZodNullable<z.ZodString>;
+                duplicate_charge_documentation: z.ZodNullable<z.ZodString>;
+                receipt: z.ZodNullable<z.ZodString>;
+                refund_policy: z.ZodNullable<z.ZodString>;
+                service_documentation: z.ZodNullable<z.ZodString>;
+                shipping_documentation: z.ZodNullable<z.ZodString>;
+                uncategorized_file: z.ZodNullable<z.ZodString>;
+            }, z.core.$strict>>;
+            metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+            created: z.ZodNumber;
+            updated_at: z.ZodNumber;
+        }, z.core.$strict>>;
+        has_more: z.ZodBoolean;
+        url: z.ZodString;
+    }, z.core.$strict>;
+    readonly sdk: "disputes.listForPaymentIntent";
+    readonly expandable: "dispute";
+}, {
+    readonly operationId: "listDisputes";
+    readonly method: "get";
+    readonly path: "/v1/disputes";
+    readonly tag: "Disputes";
+    readonly summary: "List disputes";
+    readonly auth: "service";
+    readonly scope: "payments:read";
+    readonly query: z.ZodObject<{
+        limit: z.ZodPipe<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>, z.ZodTransform<number, number | undefined>>;
+        starting_after: z.ZodOptional<z.ZodString>;
+        ending_before: z.ZodOptional<z.ZodString>;
+        created: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>, z.ZodTransform<import("../..").RangeFilter, number>>, z.ZodPipe<z.ZodObject<{
+            gt: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+            gte: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+            lt: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+            lte: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+        }, z.core.$strict>, z.ZodTransform<import("../..").RangeFilter, {
+            gt?: number | undefined;
+            gte?: number | undefined;
+            lt?: number | undefined;
+            lte?: number | undefined;
+        }>>]>>;
+        expand: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodString>>>;
+        payment_intent: z.ZodOptional<z.ZodString>;
+        charge: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly response: z.ZodObject<{
+        object: z.ZodLiteral<"list">;
+        data: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            object: z.ZodLiteral<"dispute">;
+            livemode: z.ZodBoolean;
+            amount: z.ZodString;
+            currency: z.ZodEnum<{
+                FAIR: "FAIR";
+                EUR: "EUR";
+                USD: "USD";
+                GBP: "GBP";
+                CHF: "CHF";
+                SEK: "SEK";
+                NOK: "NOK";
+                DKK: "DKK";
+                PLN: "PLN";
+                CZK: "CZK";
+                CAD: "CAD";
+                AUD: "AUD";
+                JPY: "JPY";
+            }>;
+            charge: z.ZodNullable<z.ZodType<string | import("../..").Ref<"charge">, string | import("../..").Ref<"charge">, z.core.$ZodTypeInternals<string | import("../..").Ref<"charge">, string | import("../..").Ref<"charge">>>>;
+            payment_intent: z.ZodType<string | import("../..").Ref<"payment_intent">, string | import("../..").Ref<"payment_intent">, z.core.$ZodTypeInternals<string | import("../..").Ref<"payment_intent">, string | import("../..").Ref<"payment_intent">>>;
+            status: z.ZodEnum<{
+                needs_response: "needs_response";
+                under_review: "under_review";
+                won: "won";
+                lost: "lost";
+            }>;
+            reason: z.ZodEnum<{
+                duplicate: "duplicate";
+                fraudulent: "fraudulent";
+                bank_cannot_process: "bank_cannot_process";
+                check_returned: "check_returned";
+                credit_not_processed: "credit_not_processed";
+                customer_initiated: "customer_initiated";
+                debit_not_authorized: "debit_not_authorized";
+                general: "general";
+                incorrect_account_details: "incorrect_account_details";
+                insufficient_funds: "insufficient_funds";
+                noncompliant: "noncompliant";
+                product_not_received: "product_not_received";
+                product_unacceptable: "product_unacceptable";
+                subscription_canceled: "subscription_canceled";
+                unrecognized: "unrecognized";
+            }>;
+            is_charge_refundable: z.ZodBoolean;
+            evidence_details: z.ZodObject<{
+                due_by: z.ZodNullable<z.ZodNumber>;
+                has_evidence: z.ZodBoolean;
+                past_due: z.ZodBoolean;
+                submission_count: z.ZodNumber;
+                submitted_at: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strict>;
+            evidence: z.ZodOptional<z.ZodObject<{
+                customer_name: z.ZodNullable<z.ZodString>;
+                billing_address: z.ZodNullable<z.ZodString>;
+                access_activity_log: z.ZodNullable<z.ZodString>;
+                cancellation_policy_disclosure: z.ZodNullable<z.ZodString>;
+                cancellation_rebuttal: z.ZodNullable<z.ZodString>;
+                customer_email_address: z.ZodNullable<z.ZodString>;
+                customer_purchase_ip: z.ZodNullable<z.ZodString>;
+                duplicate_charge_explanation: z.ZodNullable<z.ZodString>;
+                product_description: z.ZodNullable<z.ZodString>;
+                refund_policy_disclosure: z.ZodNullable<z.ZodString>;
+                refund_refusal_explanation: z.ZodNullable<z.ZodString>;
+                service_date: z.ZodNullable<z.ZodString>;
+                shipping_address: z.ZodNullable<z.ZodString>;
+                shipping_carrier: z.ZodNullable<z.ZodString>;
+                shipping_date: z.ZodNullable<z.ZodString>;
+                shipping_tracking_number: z.ZodNullable<z.ZodString>;
+                uncategorized_text: z.ZodNullable<z.ZodString>;
+                cancellation_policy: z.ZodNullable<z.ZodString>;
+                customer_communication: z.ZodNullable<z.ZodString>;
+                customer_signature: z.ZodNullable<z.ZodString>;
+                duplicate_charge_documentation: z.ZodNullable<z.ZodString>;
+                receipt: z.ZodNullable<z.ZodString>;
+                refund_policy: z.ZodNullable<z.ZodString>;
+                service_documentation: z.ZodNullable<z.ZodString>;
+                shipping_documentation: z.ZodNullable<z.ZodString>;
+                uncategorized_file: z.ZodNullable<z.ZodString>;
+            }, z.core.$strict>>;
+            metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+            created: z.ZodNumber;
+            updated_at: z.ZodNumber;
+        }, z.core.$strict>>;
+        has_more: z.ZodBoolean;
+        url: z.ZodString;
+    }, z.core.$strict>;
+    readonly sdk: "disputes.list";
+    readonly expandable: "dispute";
+}, {
+    readonly operationId: "retrieveDispute";
+    readonly method: "get";
+    readonly path: "/v1/disputes/{disputeId}";
+    readonly tag: "Disputes";
+    readonly summary: "Retrieve a dispute";
+    readonly description: "The one read that carries `evidence`, read live from the provider.";
+    readonly auth: "service";
+    readonly scope: "payments:read";
+    readonly params: {
+        disputeId: string;
+    };
+    readonly query: z.ZodObject<{
+        expand: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodString>>>;
+    }, z.core.$strict>;
+    readonly response: z.ZodObject<{
+        id: z.ZodString;
+        object: z.ZodLiteral<"dispute">;
+        livemode: z.ZodBoolean;
+        amount: z.ZodString;
+        currency: z.ZodEnum<{
+            FAIR: "FAIR";
+            EUR: "EUR";
+            USD: "USD";
+            GBP: "GBP";
+            CHF: "CHF";
+            SEK: "SEK";
+            NOK: "NOK";
+            DKK: "DKK";
+            PLN: "PLN";
+            CZK: "CZK";
+            CAD: "CAD";
+            AUD: "AUD";
+            JPY: "JPY";
+        }>;
+        charge: z.ZodNullable<z.ZodType<string | import("../..").Ref<"charge">, string | import("../..").Ref<"charge">, z.core.$ZodTypeInternals<string | import("../..").Ref<"charge">, string | import("../..").Ref<"charge">>>>;
+        payment_intent: z.ZodType<string | import("../..").Ref<"payment_intent">, string | import("../..").Ref<"payment_intent">, z.core.$ZodTypeInternals<string | import("../..").Ref<"payment_intent">, string | import("../..").Ref<"payment_intent">>>;
+        status: z.ZodEnum<{
+            needs_response: "needs_response";
+            under_review: "under_review";
+            won: "won";
+            lost: "lost";
+        }>;
+        reason: z.ZodEnum<{
+            duplicate: "duplicate";
+            fraudulent: "fraudulent";
+            bank_cannot_process: "bank_cannot_process";
+            check_returned: "check_returned";
+            credit_not_processed: "credit_not_processed";
+            customer_initiated: "customer_initiated";
+            debit_not_authorized: "debit_not_authorized";
+            general: "general";
+            incorrect_account_details: "incorrect_account_details";
+            insufficient_funds: "insufficient_funds";
+            noncompliant: "noncompliant";
+            product_not_received: "product_not_received";
+            product_unacceptable: "product_unacceptable";
+            subscription_canceled: "subscription_canceled";
+            unrecognized: "unrecognized";
+        }>;
+        is_charge_refundable: z.ZodBoolean;
+        evidence_details: z.ZodObject<{
+            due_by: z.ZodNullable<z.ZodNumber>;
+            has_evidence: z.ZodBoolean;
+            past_due: z.ZodBoolean;
+            submission_count: z.ZodNumber;
+            submitted_at: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+        evidence: z.ZodOptional<z.ZodObject<{
+            customer_name: z.ZodNullable<z.ZodString>;
+            billing_address: z.ZodNullable<z.ZodString>;
+            access_activity_log: z.ZodNullable<z.ZodString>;
+            cancellation_policy_disclosure: z.ZodNullable<z.ZodString>;
+            cancellation_rebuttal: z.ZodNullable<z.ZodString>;
+            customer_email_address: z.ZodNullable<z.ZodString>;
+            customer_purchase_ip: z.ZodNullable<z.ZodString>;
+            duplicate_charge_explanation: z.ZodNullable<z.ZodString>;
+            product_description: z.ZodNullable<z.ZodString>;
+            refund_policy_disclosure: z.ZodNullable<z.ZodString>;
+            refund_refusal_explanation: z.ZodNullable<z.ZodString>;
+            service_date: z.ZodNullable<z.ZodString>;
+            shipping_address: z.ZodNullable<z.ZodString>;
+            shipping_carrier: z.ZodNullable<z.ZodString>;
+            shipping_date: z.ZodNullable<z.ZodString>;
+            shipping_tracking_number: z.ZodNullable<z.ZodString>;
+            uncategorized_text: z.ZodNullable<z.ZodString>;
+            cancellation_policy: z.ZodNullable<z.ZodString>;
+            customer_communication: z.ZodNullable<z.ZodString>;
+            customer_signature: z.ZodNullable<z.ZodString>;
+            duplicate_charge_documentation: z.ZodNullable<z.ZodString>;
+            receipt: z.ZodNullable<z.ZodString>;
+            refund_policy: z.ZodNullable<z.ZodString>;
+            service_documentation: z.ZodNullable<z.ZodString>;
+            shipping_documentation: z.ZodNullable<z.ZodString>;
+            uncategorized_file: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+        created: z.ZodNumber;
+        updated_at: z.ZodNumber;
+    }, z.core.$strict>;
+    readonly sdk: "disputes.retrieve";
+    readonly expandable: "dispute";
+}, {
+    readonly operationId: "updateDispute";
+    readonly method: "post";
+    readonly path: "/v1/disputes/{disputeId}";
+    readonly tag: "Disputes";
+    readonly summary: "Update a dispute";
+    readonly description: "Metadata, a staged draft of evidence, or — with `submit: true` — the one submission. A dispute that no longer takes evidence answers 409.";
+    readonly auth: "service";
+    readonly scope: "payments:write";
+    readonly idempotent: true;
+    readonly params: {
+        disputeId: string;
+    };
+    readonly body: z.ZodObject<{
+        evidence: z.ZodOptional<z.ZodObject<{
+            cancellation_policy: z.ZodOptional<z.ZodString>;
+            customer_communication: z.ZodOptional<z.ZodString>;
+            customer_signature: z.ZodOptional<z.ZodString>;
+            duplicate_charge_documentation: z.ZodOptional<z.ZodString>;
+            receipt: z.ZodOptional<z.ZodString>;
+            refund_policy: z.ZodOptional<z.ZodString>;
+            service_documentation: z.ZodOptional<z.ZodString>;
+            shipping_documentation: z.ZodOptional<z.ZodString>;
+            uncategorized_file: z.ZodOptional<z.ZodString>;
+            customer_name: z.ZodOptional<z.ZodString>;
+            billing_address: z.ZodOptional<z.ZodString>;
+            access_activity_log: z.ZodOptional<z.ZodString>;
+            cancellation_policy_disclosure: z.ZodOptional<z.ZodString>;
+            cancellation_rebuttal: z.ZodOptional<z.ZodString>;
+            customer_email_address: z.ZodOptional<z.ZodString>;
+            customer_purchase_ip: z.ZodOptional<z.ZodString>;
+            duplicate_charge_explanation: z.ZodOptional<z.ZodString>;
+            product_description: z.ZodOptional<z.ZodString>;
+            refund_policy_disclosure: z.ZodOptional<z.ZodString>;
+            refund_refusal_explanation: z.ZodOptional<z.ZodString>;
+            service_date: z.ZodOptional<z.ZodString>;
+            shipping_address: z.ZodOptional<z.ZodString>;
+            shipping_carrier: z.ZodOptional<z.ZodString>;
+            shipping_date: z.ZodOptional<z.ZodString>;
+            shipping_tracking_number: z.ZodOptional<z.ZodString>;
+            uncategorized_text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        metadata: z.ZodOptional<z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodString>, z.ZodTransform<import("../..").MetadataPatch, Record<string, string>>>>;
+        submit: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>;
+    readonly response: z.ZodObject<{
+        id: z.ZodString;
+        object: z.ZodLiteral<"dispute">;
+        livemode: z.ZodBoolean;
+        amount: z.ZodString;
+        currency: z.ZodEnum<{
+            FAIR: "FAIR";
+            EUR: "EUR";
+            USD: "USD";
+            GBP: "GBP";
+            CHF: "CHF";
+            SEK: "SEK";
+            NOK: "NOK";
+            DKK: "DKK";
+            PLN: "PLN";
+            CZK: "CZK";
+            CAD: "CAD";
+            AUD: "AUD";
+            JPY: "JPY";
+        }>;
+        charge: z.ZodNullable<z.ZodType<string | import("../..").Ref<"charge">, string | import("../..").Ref<"charge">, z.core.$ZodTypeInternals<string | import("../..").Ref<"charge">, string | import("../..").Ref<"charge">>>>;
+        payment_intent: z.ZodType<string | import("../..").Ref<"payment_intent">, string | import("../..").Ref<"payment_intent">, z.core.$ZodTypeInternals<string | import("../..").Ref<"payment_intent">, string | import("../..").Ref<"payment_intent">>>;
+        status: z.ZodEnum<{
+            needs_response: "needs_response";
+            under_review: "under_review";
+            won: "won";
+            lost: "lost";
+        }>;
+        reason: z.ZodEnum<{
+            duplicate: "duplicate";
+            fraudulent: "fraudulent";
+            bank_cannot_process: "bank_cannot_process";
+            check_returned: "check_returned";
+            credit_not_processed: "credit_not_processed";
+            customer_initiated: "customer_initiated";
+            debit_not_authorized: "debit_not_authorized";
+            general: "general";
+            incorrect_account_details: "incorrect_account_details";
+            insufficient_funds: "insufficient_funds";
+            noncompliant: "noncompliant";
+            product_not_received: "product_not_received";
+            product_unacceptable: "product_unacceptable";
+            subscription_canceled: "subscription_canceled";
+            unrecognized: "unrecognized";
+        }>;
+        is_charge_refundable: z.ZodBoolean;
+        evidence_details: z.ZodObject<{
+            due_by: z.ZodNullable<z.ZodNumber>;
+            has_evidence: z.ZodBoolean;
+            past_due: z.ZodBoolean;
+            submission_count: z.ZodNumber;
+            submitted_at: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+        evidence: z.ZodOptional<z.ZodObject<{
+            customer_name: z.ZodNullable<z.ZodString>;
+            billing_address: z.ZodNullable<z.ZodString>;
+            access_activity_log: z.ZodNullable<z.ZodString>;
+            cancellation_policy_disclosure: z.ZodNullable<z.ZodString>;
+            cancellation_rebuttal: z.ZodNullable<z.ZodString>;
+            customer_email_address: z.ZodNullable<z.ZodString>;
+            customer_purchase_ip: z.ZodNullable<z.ZodString>;
+            duplicate_charge_explanation: z.ZodNullable<z.ZodString>;
+            product_description: z.ZodNullable<z.ZodString>;
+            refund_policy_disclosure: z.ZodNullable<z.ZodString>;
+            refund_refusal_explanation: z.ZodNullable<z.ZodString>;
+            service_date: z.ZodNullable<z.ZodString>;
+            shipping_address: z.ZodNullable<z.ZodString>;
+            shipping_carrier: z.ZodNullable<z.ZodString>;
+            shipping_date: z.ZodNullable<z.ZodString>;
+            shipping_tracking_number: z.ZodNullable<z.ZodString>;
+            uncategorized_text: z.ZodNullable<z.ZodString>;
+            cancellation_policy: z.ZodNullable<z.ZodString>;
+            customer_communication: z.ZodNullable<z.ZodString>;
+            customer_signature: z.ZodNullable<z.ZodString>;
+            duplicate_charge_documentation: z.ZodNullable<z.ZodString>;
+            receipt: z.ZodNullable<z.ZodString>;
+            refund_policy: z.ZodNullable<z.ZodString>;
+            service_documentation: z.ZodNullable<z.ZodString>;
+            shipping_documentation: z.ZodNullable<z.ZodString>;
+            uncategorized_file: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+        created: z.ZodNumber;
+        updated_at: z.ZodNumber;
+    }, z.core.$strict>;
+    readonly sdk: "disputes.update";
+}, {
+    readonly operationId: "closeDispute";
+    readonly method: "post";
+    readonly path: "/v1/disputes/{disputeId}/close";
+    readonly tag: "Disputes";
+    readonly summary: "Close a dispute";
+    readonly description: "Accept the dispute: it is lost.";
+    readonly auth: "service";
+    readonly scope: "payments:write";
+    readonly idempotent: true;
+    readonly params: {
+        disputeId: string;
+    };
+    readonly body: z.ZodObject<{}, z.core.$strict>;
+    readonly response: z.ZodObject<{
+        id: z.ZodString;
+        object: z.ZodLiteral<"dispute">;
+        livemode: z.ZodBoolean;
+        amount: z.ZodString;
+        currency: z.ZodEnum<{
+            FAIR: "FAIR";
+            EUR: "EUR";
+            USD: "USD";
+            GBP: "GBP";
+            CHF: "CHF";
+            SEK: "SEK";
+            NOK: "NOK";
+            DKK: "DKK";
+            PLN: "PLN";
+            CZK: "CZK";
+            CAD: "CAD";
+            AUD: "AUD";
+            JPY: "JPY";
+        }>;
+        charge: z.ZodNullable<z.ZodType<string | import("../..").Ref<"charge">, string | import("../..").Ref<"charge">, z.core.$ZodTypeInternals<string | import("../..").Ref<"charge">, string | import("../..").Ref<"charge">>>>;
+        payment_intent: z.ZodType<string | import("../..").Ref<"payment_intent">, string | import("../..").Ref<"payment_intent">, z.core.$ZodTypeInternals<string | import("../..").Ref<"payment_intent">, string | import("../..").Ref<"payment_intent">>>;
+        status: z.ZodEnum<{
+            needs_response: "needs_response";
+            under_review: "under_review";
+            won: "won";
+            lost: "lost";
+        }>;
+        reason: z.ZodEnum<{
+            duplicate: "duplicate";
+            fraudulent: "fraudulent";
+            bank_cannot_process: "bank_cannot_process";
+            check_returned: "check_returned";
+            credit_not_processed: "credit_not_processed";
+            customer_initiated: "customer_initiated";
+            debit_not_authorized: "debit_not_authorized";
+            general: "general";
+            incorrect_account_details: "incorrect_account_details";
+            insufficient_funds: "insufficient_funds";
+            noncompliant: "noncompliant";
+            product_not_received: "product_not_received";
+            product_unacceptable: "product_unacceptable";
+            subscription_canceled: "subscription_canceled";
+            unrecognized: "unrecognized";
+        }>;
+        is_charge_refundable: z.ZodBoolean;
+        evidence_details: z.ZodObject<{
+            due_by: z.ZodNullable<z.ZodNumber>;
+            has_evidence: z.ZodBoolean;
+            past_due: z.ZodBoolean;
+            submission_count: z.ZodNumber;
+            submitted_at: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+        evidence: z.ZodOptional<z.ZodObject<{
+            customer_name: z.ZodNullable<z.ZodString>;
+            billing_address: z.ZodNullable<z.ZodString>;
+            access_activity_log: z.ZodNullable<z.ZodString>;
+            cancellation_policy_disclosure: z.ZodNullable<z.ZodString>;
+            cancellation_rebuttal: z.ZodNullable<z.ZodString>;
+            customer_email_address: z.ZodNullable<z.ZodString>;
+            customer_purchase_ip: z.ZodNullable<z.ZodString>;
+            duplicate_charge_explanation: z.ZodNullable<z.ZodString>;
+            product_description: z.ZodNullable<z.ZodString>;
+            refund_policy_disclosure: z.ZodNullable<z.ZodString>;
+            refund_refusal_explanation: z.ZodNullable<z.ZodString>;
+            service_date: z.ZodNullable<z.ZodString>;
+            shipping_address: z.ZodNullable<z.ZodString>;
+            shipping_carrier: z.ZodNullable<z.ZodString>;
+            shipping_date: z.ZodNullable<z.ZodString>;
+            shipping_tracking_number: z.ZodNullable<z.ZodString>;
+            uncategorized_text: z.ZodNullable<z.ZodString>;
+            cancellation_policy: z.ZodNullable<z.ZodString>;
+            customer_communication: z.ZodNullable<z.ZodString>;
+            customer_signature: z.ZodNullable<z.ZodString>;
+            duplicate_charge_documentation: z.ZodNullable<z.ZodString>;
+            receipt: z.ZodNullable<z.ZodString>;
+            refund_policy: z.ZodNullable<z.ZodString>;
+            service_documentation: z.ZodNullable<z.ZodString>;
+            shipping_documentation: z.ZodNullable<z.ZodString>;
+            uncategorized_file: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+        created: z.ZodNumber;
+        updated_at: z.ZodNumber;
+    }, z.core.$strict>;
+    readonly sdk: "disputes.close";
+}];