@peable.to/contracts 3.0.0 → 4.0.0

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

@@ -42,6 +42,45 @@ export declare const paymentIntentNextActionSchema: z.ZodDiscriminatedUnion<[z.Z
     type: z.ZodLiteral<"use_peable_sdk">;
 }, z.core.$strict>], "type">;
 export type PaymentIntentNextAction = z.output<typeof paymentIntentNextActionSchema>;
+/**
+ * The FairCoin price of a FIAT order (ADR 0021 D4), carried by the FairCoin
+ * payment the payer chose for it. Pricing, never exchange: the payer pays
+ * `amount` FAIR (the intent's) to the payee's own address, and no fiat moves.
+ * `rate` is for display; the FAIR amount is exactly
+ * `ceil(amount ÷ rate)` computed from the sources' own figures.
+ */
+export declare const faircoinQuoteSchema: z.ZodObject<{
+    currency: z.ZodEnum<{
+        EUR: "EUR";
+        USD: "USD";
+        GBP: "GBP";
+        CHF: "CHF";
+        SEK: "SEK";
+        NOK: "NOK";
+        DKK: "DKK";
+        PLN: "PLN";
+        CZK: "CZK";
+        CAD: "CAD";
+        AUD: "AUD";
+        JPY: "JPY";
+    }>;
+    amount: z.ZodString;
+    rate: z.ZodString;
+    price: z.ZodObject<{
+        source: z.ZodLiteral<"wfair-base">;
+        usd_per_fair: z.ZodString;
+        observed_at: z.ZodNumber;
+    }, z.core.$strict>;
+    reference_rates: z.ZodNullable<z.ZodObject<{
+        source: z.ZodLiteral<"ecb">;
+        usd_per_eur: z.ZodString;
+        currency_per_eur: z.ZodString;
+        observed_at: z.ZodNumber;
+    }, z.core.$strict>>;
+    quoted_at: z.ZodNumber;
+    expires_at: z.ZodNumber;
+}, z.core.$strict>;
+export type FaircoinQuote = z.output<typeof faircoinQuoteSchema>;
 /**
  * The chain side of a FairCoin payment. `txid` and `confirmations` describe the
  * transaction the payer reported: `null`/`0` while `requires_action`, the
@@ -56,6 +95,37 @@ export declare const paymentIntentFaircoinSchema: z.ZodObject<{
     txid: z.ZodNullable<z.ZodString>;
     confirmations: z.ZodNumber;
     required_confirmations: z.ZodNumber;
+    quote: z.ZodNullable<z.ZodObject<{
+        currency: z.ZodEnum<{
+            EUR: "EUR";
+            USD: "USD";
+            GBP: "GBP";
+            CHF: "CHF";
+            SEK: "SEK";
+            NOK: "NOK";
+            DKK: "DKK";
+            PLN: "PLN";
+            CZK: "CZK";
+            CAD: "CAD";
+            AUD: "AUD";
+            JPY: "JPY";
+        }>;
+        amount: z.ZodString;
+        rate: z.ZodString;
+        price: z.ZodObject<{
+            source: z.ZodLiteral<"wfair-base">;
+            usd_per_fair: z.ZodString;
+            observed_at: z.ZodNumber;
+        }, z.core.$strict>;
+        reference_rates: z.ZodNullable<z.ZodObject<{
+            source: z.ZodLiteral<"ecb">;
+            usd_per_eur: z.ZodString;
+            currency_per_eur: z.ZodString;
+            observed_at: z.ZodNumber;
+        }, z.core.$strict>>;
+        quoted_at: z.ZodNumber;
+        expires_at: z.ZodNumber;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export type PaymentIntentFaircoin = z.output<typeof paymentIntentFaircoinSchema>;
 /** Where a destination charge's funds go (`transfer_data`, ADR 0015 §2). */
@@ -206,6 +276,37 @@ export declare const paymentIntentSchema: z.ZodObject<{
         txid: z.ZodNullable<z.ZodString>;
         confirmations: z.ZodNumber;
         required_confirmations: z.ZodNumber;
+        quote: z.ZodNullable<z.ZodObject<{
+            currency: z.ZodEnum<{
+                EUR: "EUR";
+                USD: "USD";
+                GBP: "GBP";
+                CHF: "CHF";
+                SEK: "SEK";
+                NOK: "NOK";
+                DKK: "DKK";
+                PLN: "PLN";
+                CZK: "CZK";
+                CAD: "CAD";
+                AUD: "AUD";
+                JPY: "JPY";
+            }>;
+            amount: z.ZodString;
+            rate: z.ZodString;
+            price: z.ZodObject<{
+                source: z.ZodLiteral<"wfair-base">;
+                usd_per_fair: z.ZodString;
+                observed_at: z.ZodNumber;
+            }, z.core.$strict>;
+            reference_rates: z.ZodNullable<z.ZodObject<{
+                source: z.ZodLiteral<"ecb">;
+                usd_per_eur: z.ZodString;
+                currency_per_eur: z.ZodString;
+                observed_at: z.ZodNumber;
+            }, z.core.$strict>>;
+            quoted_at: z.ZodNumber;
+            expires_at: z.ZodNumber;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     merchant_id: z.ZodString;
     connected_account: z.ZodNullable<z.ZodType<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">, z.core.$ZodTypeInternals<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">>>>;
@@ -672,6 +773,37 @@ export declare const paymentIntentRoutes: readonly [{
             txid: z.ZodNullable<z.ZodString>;
             confirmations: z.ZodNumber;
             required_confirmations: z.ZodNumber;
+            quote: z.ZodNullable<z.ZodObject<{
+                currency: z.ZodEnum<{
+                    EUR: "EUR";
+                    USD: "USD";
+                    GBP: "GBP";
+                    CHF: "CHF";
+                    SEK: "SEK";
+                    NOK: "NOK";
+                    DKK: "DKK";
+                    PLN: "PLN";
+                    CZK: "CZK";
+                    CAD: "CAD";
+                    AUD: "AUD";
+                    JPY: "JPY";
+                }>;
+                amount: z.ZodString;
+                rate: z.ZodString;
+                price: z.ZodObject<{
+                    source: z.ZodLiteral<"wfair-base">;
+                    usd_per_fair: z.ZodString;
+                    observed_at: z.ZodNumber;
+                }, z.core.$strict>;
+                reference_rates: z.ZodNullable<z.ZodObject<{
+                    source: z.ZodLiteral<"ecb">;
+                    usd_per_eur: z.ZodString;
+                    currency_per_eur: z.ZodString;
+                    observed_at: z.ZodNumber;
+                }, z.core.$strict>>;
+                quoted_at: z.ZodNumber;
+                expires_at: z.ZodNumber;
+            }, z.core.$strict>>;
         }, z.core.$strict>>;
         merchant_id: z.ZodString;
         connected_account: z.ZodNullable<z.ZodType<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">, z.core.$ZodTypeInternals<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">>>>;
@@ -854,6 +986,37 @@ export declare const paymentIntentRoutes: readonly [{
                 txid: z.ZodNullable<z.ZodString>;
                 confirmations: z.ZodNumber;
                 required_confirmations: z.ZodNumber;
+                quote: z.ZodNullable<z.ZodObject<{
+                    currency: z.ZodEnum<{
+                        EUR: "EUR";
+                        USD: "USD";
+                        GBP: "GBP";
+                        CHF: "CHF";
+                        SEK: "SEK";
+                        NOK: "NOK";
+                        DKK: "DKK";
+                        PLN: "PLN";
+                        CZK: "CZK";
+                        CAD: "CAD";
+                        AUD: "AUD";
+                        JPY: "JPY";
+                    }>;
+                    amount: z.ZodString;
+                    rate: z.ZodString;
+                    price: z.ZodObject<{
+                        source: z.ZodLiteral<"wfair-base">;
+                        usd_per_fair: z.ZodString;
+                        observed_at: z.ZodNumber;
+                    }, z.core.$strict>;
+                    reference_rates: z.ZodNullable<z.ZodObject<{
+                        source: z.ZodLiteral<"ecb">;
+                        usd_per_eur: z.ZodString;
+                        currency_per_eur: z.ZodString;
+                        observed_at: z.ZodNumber;
+                    }, z.core.$strict>>;
+                    quoted_at: z.ZodNumber;
+                    expires_at: z.ZodNumber;
+                }, z.core.$strict>>;
             }, z.core.$strict>>;
             merchant_id: z.ZodString;
             connected_account: z.ZodNullable<z.ZodType<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">, z.core.$ZodTypeInternals<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">>>>;
@@ -1017,6 +1180,37 @@ export declare const paymentIntentRoutes: readonly [{
             txid: z.ZodNullable<z.ZodString>;
             confirmations: z.ZodNumber;
             required_confirmations: z.ZodNumber;
+            quote: z.ZodNullable<z.ZodObject<{
+                currency: z.ZodEnum<{
+                    EUR: "EUR";
+                    USD: "USD";
+                    GBP: "GBP";
+                    CHF: "CHF";
+                    SEK: "SEK";
+                    NOK: "NOK";
+                    DKK: "DKK";
+                    PLN: "PLN";
+                    CZK: "CZK";
+                    CAD: "CAD";
+                    AUD: "AUD";
+                    JPY: "JPY";
+                }>;
+                amount: z.ZodString;
+                rate: z.ZodString;
+                price: z.ZodObject<{
+                    source: z.ZodLiteral<"wfair-base">;
+                    usd_per_fair: z.ZodString;
+                    observed_at: z.ZodNumber;
+                }, z.core.$strict>;
+                reference_rates: z.ZodNullable<z.ZodObject<{
+                    source: z.ZodLiteral<"ecb">;
+                    usd_per_eur: z.ZodString;
+                    currency_per_eur: z.ZodString;
+                    observed_at: z.ZodNumber;
+                }, z.core.$strict>>;
+                quoted_at: z.ZodNumber;
+                expires_at: z.ZodNumber;
+            }, z.core.$strict>>;
         }, z.core.$strict>>;
         merchant_id: z.ZodString;
         connected_account: z.ZodNullable<z.ZodType<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">, z.core.$ZodTypeInternals<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">>>>;
@@ -1194,6 +1388,37 @@ export declare const paymentIntentRoutes: readonly [{
             txid: z.ZodNullable<z.ZodString>;
             confirmations: z.ZodNumber;
             required_confirmations: z.ZodNumber;
+            quote: z.ZodNullable<z.ZodObject<{
+                currency: z.ZodEnum<{
+                    EUR: "EUR";
+                    USD: "USD";
+                    GBP: "GBP";
+                    CHF: "CHF";
+                    SEK: "SEK";
+                    NOK: "NOK";
+                    DKK: "DKK";
+                    PLN: "PLN";
+                    CZK: "CZK";
+                    CAD: "CAD";
+                    AUD: "AUD";
+                    JPY: "JPY";
+                }>;
+                amount: z.ZodString;
+                rate: z.ZodString;
+                price: z.ZodObject<{
+                    source: z.ZodLiteral<"wfair-base">;
+                    usd_per_fair: z.ZodString;
+                    observed_at: z.ZodNumber;
+                }, z.core.$strict>;
+                reference_rates: z.ZodNullable<z.ZodObject<{
+                    source: z.ZodLiteral<"ecb">;
+                    usd_per_eur: z.ZodString;
+                    currency_per_eur: z.ZodString;
+                    observed_at: z.ZodNumber;
+                }, z.core.$strict>>;
+                quoted_at: z.ZodNumber;
+                expires_at: z.ZodNumber;
+            }, z.core.$strict>>;
         }, z.core.$strict>>;
         merchant_id: z.ZodString;
         connected_account: z.ZodNullable<z.ZodType<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">, z.core.$ZodTypeInternals<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">>>>;
@@ -1401,6 +1626,37 @@ export declare const paymentIntentRoutes: readonly [{
             txid: z.ZodNullable<z.ZodString>;
             confirmations: z.ZodNumber;
             required_confirmations: z.ZodNumber;
+            quote: z.ZodNullable<z.ZodObject<{
+                currency: z.ZodEnum<{
+                    EUR: "EUR";
+                    USD: "USD";
+                    GBP: "GBP";
+                    CHF: "CHF";
+                    SEK: "SEK";
+                    NOK: "NOK";
+                    DKK: "DKK";
+                    PLN: "PLN";
+                    CZK: "CZK";
+                    CAD: "CAD";
+                    AUD: "AUD";
+                    JPY: "JPY";
+                }>;
+                amount: z.ZodString;
+                rate: z.ZodString;
+                price: z.ZodObject<{
+                    source: z.ZodLiteral<"wfair-base">;
+                    usd_per_fair: z.ZodString;
+                    observed_at: z.ZodNumber;
+                }, z.core.$strict>;
+                reference_rates: z.ZodNullable<z.ZodObject<{
+                    source: z.ZodLiteral<"ecb">;
+                    usd_per_eur: z.ZodString;
+                    currency_per_eur: z.ZodString;
+                    observed_at: z.ZodNumber;
+                }, z.core.$strict>>;
+                quoted_at: z.ZodNumber;
+                expires_at: z.ZodNumber;
+            }, z.core.$strict>>;
         }, z.core.$strict>>;
         merchant_id: z.ZodString;
         connected_account: z.ZodNullable<z.ZodType<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">, z.core.$ZodTypeInternals<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">>>>;
@@ -1562,6 +1818,37 @@ export declare const paymentIntentRoutes: readonly [{
             txid: z.ZodNullable<z.ZodString>;
             confirmations: z.ZodNumber;
             required_confirmations: z.ZodNumber;
+            quote: z.ZodNullable<z.ZodObject<{
+                currency: z.ZodEnum<{
+                    EUR: "EUR";
+                    USD: "USD";
+                    GBP: "GBP";
+                    CHF: "CHF";
+                    SEK: "SEK";
+                    NOK: "NOK";
+                    DKK: "DKK";
+                    PLN: "PLN";
+                    CZK: "CZK";
+                    CAD: "CAD";
+                    AUD: "AUD";
+                    JPY: "JPY";
+                }>;
+                amount: z.ZodString;
+                rate: z.ZodString;
+                price: z.ZodObject<{
+                    source: z.ZodLiteral<"wfair-base">;
+                    usd_per_fair: z.ZodString;
+                    observed_at: z.ZodNumber;
+                }, z.core.$strict>;
+                reference_rates: z.ZodNullable<z.ZodObject<{
+                    source: z.ZodLiteral<"ecb">;
+                    usd_per_eur: z.ZodString;
+                    currency_per_eur: z.ZodString;
+                    observed_at: z.ZodNumber;
+                }, z.core.$strict>>;
+                quoted_at: z.ZodNumber;
+                expires_at: z.ZodNumber;
+            }, z.core.$strict>>;
         }, z.core.$strict>>;
         merchant_id: z.ZodString;
         connected_account: z.ZodNullable<z.ZodType<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">, z.core.$ZodTypeInternals<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">>>>;
@@ -1728,6 +2015,37 @@ export declare const paymentIntentRoutes: readonly [{
             txid: z.ZodNullable<z.ZodString>;
             confirmations: z.ZodNumber;
             required_confirmations: z.ZodNumber;
+            quote: z.ZodNullable<z.ZodObject<{
+                currency: z.ZodEnum<{
+                    EUR: "EUR";
+                    USD: "USD";
+                    GBP: "GBP";
+                    CHF: "CHF";
+                    SEK: "SEK";
+                    NOK: "NOK";
+                    DKK: "DKK";
+                    PLN: "PLN";
+                    CZK: "CZK";
+                    CAD: "CAD";
+                    AUD: "AUD";
+                    JPY: "JPY";
+                }>;
+                amount: z.ZodString;
+                rate: z.ZodString;
+                price: z.ZodObject<{
+                    source: z.ZodLiteral<"wfair-base">;
+                    usd_per_fair: z.ZodString;
+                    observed_at: z.ZodNumber;
+                }, z.core.$strict>;
+                reference_rates: z.ZodNullable<z.ZodObject<{
+                    source: z.ZodLiteral<"ecb">;
+                    usd_per_eur: z.ZodString;
+                    currency_per_eur: z.ZodString;
+                    observed_at: z.ZodNumber;
+                }, z.core.$strict>>;
+                quoted_at: z.ZodNumber;
+                expires_at: z.ZodNumber;
+            }, z.core.$strict>>;
         }, z.core.$strict>>;
         merchant_id: z.ZodString;
         connected_account: z.ZodNullable<z.ZodType<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">, z.core.$ZodTypeInternals<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">>>>;
@@ -1887,6 +2205,37 @@ export declare const paymentIntentRoutes: readonly [{
             txid: z.ZodNullable<z.ZodString>;
             confirmations: z.ZodNumber;
             required_confirmations: z.ZodNumber;
+            quote: z.ZodNullable<z.ZodObject<{
+                currency: z.ZodEnum<{
+                    EUR: "EUR";
+                    USD: "USD";
+                    GBP: "GBP";
+                    CHF: "CHF";
+                    SEK: "SEK";
+                    NOK: "NOK";
+                    DKK: "DKK";
+                    PLN: "PLN";
+                    CZK: "CZK";
+                    CAD: "CAD";
+                    AUD: "AUD";
+                    JPY: "JPY";
+                }>;
+                amount: z.ZodString;
+                rate: z.ZodString;
+                price: z.ZodObject<{
+                    source: z.ZodLiteral<"wfair-base">;
+                    usd_per_fair: z.ZodString;
+                    observed_at: z.ZodNumber;
+                }, z.core.$strict>;
+                reference_rates: z.ZodNullable<z.ZodObject<{
+                    source: z.ZodLiteral<"ecb">;
+                    usd_per_eur: z.ZodString;
+                    currency_per_eur: z.ZodString;
+                    observed_at: z.ZodNumber;
+                }, z.core.$strict>>;
+                quoted_at: z.ZodNumber;
+                expires_at: z.ZodNumber;
+            }, z.core.$strict>>;
         }, z.core.$strict>>;
         merchant_id: z.ZodString;
         connected_account: z.ZodNullable<z.ZodType<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">, z.core.$ZodTypeInternals<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">>>>;
@@ -2046,6 +2395,37 @@ export declare const paymentIntentRoutes: readonly [{
                 txid: z.ZodNullable<z.ZodString>;
                 confirmations: z.ZodNumber;
                 required_confirmations: z.ZodNumber;
+                quote: z.ZodNullable<z.ZodObject<{
+                    currency: z.ZodEnum<{
+                        EUR: "EUR";
+                        USD: "USD";
+                        GBP: "GBP";
+                        CHF: "CHF";
+                        SEK: "SEK";
+                        NOK: "NOK";
+                        DKK: "DKK";
+                        PLN: "PLN";
+                        CZK: "CZK";
+                        CAD: "CAD";
+                        AUD: "AUD";
+                        JPY: "JPY";
+                    }>;
+                    amount: z.ZodString;
+                    rate: z.ZodString;
+                    price: z.ZodObject<{
+                        source: z.ZodLiteral<"wfair-base">;
+                        usd_per_fair: z.ZodString;
+                        observed_at: z.ZodNumber;
+                    }, z.core.$strict>;
+                    reference_rates: z.ZodNullable<z.ZodObject<{
+                        source: z.ZodLiteral<"ecb">;
+                        usd_per_eur: z.ZodString;
+                        currency_per_eur: z.ZodString;
+                        observed_at: z.ZodNumber;
+                    }, z.core.$strict>>;
+                    quoted_at: z.ZodNumber;
+                    expires_at: z.ZodNumber;
+                }, z.core.$strict>>;
             }, z.core.$strict>>;
             merchant_id: z.ZodString;
             connected_account: z.ZodNullable<z.ZodType<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">, z.core.$ZodTypeInternals<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">>>>;

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

@@ -1,7 +1,8 @@
 import { z } from 'zod';
 import { type Expand } from '../../common/objects';
 /**
- * Refunds (`re_…`) and a payment's settlement figures. The provider's own
+ * Refunds (`re_…`) and the settlement figures of a payment, a refund or a
+ * dispute. The provider's own
  * refund id never appears: a merchant integrates against Peable and never
  * learns which acquirer sat behind it (ADR 0001 D3).
  */
@@ -49,15 +50,28 @@ export declare const refundSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type Refund = Expand<z.output<typeof refundSchema>>;
 /**
- * What a payment actually came to, as the PROVIDER reports it. Every figure is
- * nullable and that is the contract: "the fee was zero" and "the fee is not
- * known yet" are different facts, and `status` says which produced the nulls.
- * It reports what the provider took; it attributes that cost to nobody.
+ * One movement of the settlement balance, as the PROVIDER reports it: what a
+ * payment brought in (`GET /v1/payment_intents/{intentId}/settlement`), what a
+ * refund took out (`GET /v1/refunds/{id}/settlement`) or what a dispute
+ * withdrew (`GET /v1/disputes/{disputeId}/settlement`). `refund` and `dispute`
+ * say which: both `null` for a payment's.
+ *
+ * Every figure is nullable and that is the contract: "the fee was zero" and
+ * "the fee is not known yet" are different facts, and `status` says which
+ * produced the nulls. It reports what the provider took; it attributes that
+ * cost to nobody.
+ *
+ * The signs: `gross` is the MAGNITUDE of the movement, `fee` the provider's fee
+ * on it (positive when charged, negative when returned), `net` its SIGNED
+ * effect on the balance — so `net = gross − fee` for a payment and
+ * `net = −gross − fee` for a refund or a dispute.
  */
 export declare const settlementSchema: z.ZodObject<{
     object: z.ZodLiteral<"settlement">;
     livemode: z.ZodBoolean;
     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">>>;
+    refund: z.ZodNullable<z.ZodType<string | import("../..").Ref<"refund">, string | import("../..").Ref<"refund">, z.core.$ZodTypeInternals<string | import("../..").Ref<"refund">, string | import("../..").Ref<"refund">>>>;
+    dispute: z.ZodNullable<z.ZodType<string | import("../..").Ref<"dispute">, string | import("../..").Ref<"dispute">, z.core.$ZodTypeInternals<string | import("../..").Ref<"dispute">, string | import("../..").Ref<"dispute">>>>;
     status: z.ZodEnum<{
         unknown: "unknown";
         pending: "pending";
@@ -601,6 +615,8 @@ export declare const refundRoutes: readonly [{
         object: z.ZodLiteral<"settlement">;
         livemode: z.ZodBoolean;
         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">>>;
+        refund: z.ZodNullable<z.ZodType<string | import("../..").Ref<"refund">, string | import("../..").Ref<"refund">, z.core.$ZodTypeInternals<string | import("../..").Ref<"refund">, string | import("../..").Ref<"refund">>>>;
+        dispute: z.ZodNullable<z.ZodType<string | import("../..").Ref<"dispute">, string | import("../..").Ref<"dispute">, z.core.$ZodTypeInternals<string | import("../..").Ref<"dispute">, string | import("../..").Ref<"dispute">>>>;
         status: z.ZodEnum<{
             unknown: "unknown";
             pending: "pending";
@@ -615,6 +631,41 @@ export declare const refundRoutes: readonly [{
     }, z.core.$strict>;
     readonly sdk: "refunds.settlement";
     readonly expandable: "settlement";
+}, {
+    readonly operationId: "retrieveRefundSettlement";
+    readonly method: "get";
+    readonly path: "/v1/refunds/{id}/settlement";
+    readonly tag: "Refunds";
+    readonly summary: "Retrieve a refund's settlement";
+    readonly description: "What the refund took off the settlement balance — `gross`, `fee`, a negative `net` — in the settlement currency, read live from the provider. A missing figure is `null` with a `status`, never `0`; a refund that failed or was canceled is `unknown`.";
+    readonly auth: "service";
+    readonly scope: "payments:read";
+    readonly params: {
+        id: 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<{
+        object: z.ZodLiteral<"settlement">;
+        livemode: z.ZodBoolean;
+        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">>>;
+        refund: z.ZodNullable<z.ZodType<string | import("../..").Ref<"refund">, string | import("../..").Ref<"refund">, z.core.$ZodTypeInternals<string | import("../..").Ref<"refund">, string | import("../..").Ref<"refund">>>>;
+        dispute: z.ZodNullable<z.ZodType<string | import("../..").Ref<"dispute">, string | import("../..").Ref<"dispute">, z.core.$ZodTypeInternals<string | import("../..").Ref<"dispute">, string | import("../..").Ref<"dispute">>>>;
+        status: z.ZodEnum<{
+            unknown: "unknown";
+            pending: "pending";
+            available: "available";
+        }>;
+        gross: z.ZodNullable<z.ZodString>;
+        fee: z.ZodNullable<z.ZodString>;
+        net: z.ZodNullable<z.ZodString>;
+        currency: z.ZodNullable<z.ZodString>;
+        available_on: z.ZodNullable<z.ZodNumber>;
+        exchange_rate: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>;
+    readonly sdk: "refunds.refundSettlement";
+    readonly expandable: "settlement";
 }, {
     readonly operationId: "searchRefunds";
     readonly method: "get";

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

@@ -150,6 +150,37 @@ export declare const paymentIntentTestHelperRoutes: readonly [{
             txid: z.ZodNullable<z.ZodString>;
             confirmations: z.ZodNumber;
             required_confirmations: z.ZodNumber;
+            quote: z.ZodNullable<z.ZodObject<{
+                currency: z.ZodEnum<{
+                    EUR: "EUR";
+                    USD: "USD";
+                    GBP: "GBP";
+                    CHF: "CHF";
+                    SEK: "SEK";
+                    NOK: "NOK";
+                    DKK: "DKK";
+                    PLN: "PLN";
+                    CZK: "CZK";
+                    CAD: "CAD";
+                    AUD: "AUD";
+                    JPY: "JPY";
+                }>;
+                amount: z.ZodString;
+                rate: z.ZodString;
+                price: z.ZodObject<{
+                    source: z.ZodLiteral<"wfair-base">;
+                    usd_per_fair: z.ZodString;
+                    observed_at: z.ZodNumber;
+                }, z.core.$strict>;
+                reference_rates: z.ZodNullable<z.ZodObject<{
+                    source: z.ZodLiteral<"ecb">;
+                    usd_per_eur: z.ZodString;
+                    currency_per_eur: z.ZodString;
+                    observed_at: z.ZodNumber;
+                }, z.core.$strict>>;
+                quoted_at: z.ZodNumber;
+                expires_at: z.ZodNumber;
+            }, z.core.$strict>>;
         }, z.core.$strict>>;
         merchant_id: z.ZodString;
         connected_account: z.ZodNullable<z.ZodType<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">, z.core.$ZodTypeInternals<string | import("../..").Ref<"connected_account">, string | import("../..").Ref<"connected_account">>>>;

package/dist/types/resources/tax/deadlines.d.ts

@@ -7,8 +7,8 @@ import { type Expand } from '../../common/objects';
 export declare const taxDeadlineSchema: z.ZodObject<{
     object: z.ZodLiteral<"tax.deadline">;
     kind: z.ZodEnum<{
-        return: "return";
         payment: "payment";
+        return: "return";
         registration: "registration";
     }>;
     rule: z.ZodString;
@@ -50,8 +50,8 @@ export declare const taxDeadlineListSchema: z.ZodObject<{
     data: z.ZodArray<z.ZodObject<{
         object: z.ZodLiteral<"tax.deadline">;
         kind: z.ZodEnum<{
-            return: "return";
             payment: "payment";
+            return: "return";
             registration: "registration";
         }>;
         rule: z.ZodString;
@@ -97,8 +97,8 @@ export declare const taxDeadlineRoutes: readonly [{
         data: z.ZodArray<z.ZodObject<{
             object: z.ZodLiteral<"tax.deadline">;
             kind: z.ZodEnum<{
-                return: "return";
                 payment: "payment";
+                return: "return";
                 registration: "registration";
             }>;
             rule: z.ZodString;

package/dist/types/resources/tax/index.d.ts

@@ -108,9 +108,9 @@ export declare const taxRoutes: readonly [{
             expires_at: import("zod").ZodNullable<import("zod").ZodNumber>;
             status: import("zod").ZodEnum<{
                 active: "active";
+                expired: "expired";
                 pending_approval: "pending_approval";
                 scheduled: "scheduled";
-                expired: "expired";
             }>;
             approved_at: import("zod").ZodNullable<import("zod").ZodNumber>;
             provider_registration_ref: import("zod").ZodNullable<import("zod").ZodString>;
@@ -1275,8 +1275,8 @@ export declare const taxRoutes: readonly [{
         data: import("zod").ZodArray<import("zod").ZodObject<{
             object: import("zod").ZodLiteral<"tax.deadline">;
             kind: import("zod").ZodEnum<{
-                return: "return";
                 payment: "payment";
+                return: "return";
                 registration: "registration";
             }>;
             rule: import("zod").ZodString;

package/dist/types/resources/tax/registrations.d.ts

@@ -23,9 +23,9 @@ export declare const taxRegistrationSchema: z.ZodObject<{
     expires_at: z.ZodNullable<z.ZodNumber>;
     status: z.ZodEnum<{
         active: "active";
+        expired: "expired";
         pending_approval: "pending_approval";
         scheduled: "scheduled";
-        expired: "expired";
     }>;
     approved_at: z.ZodNullable<z.ZodNumber>;
     provider_registration_ref: z.ZodNullable<z.ZodString>;
@@ -88,9 +88,9 @@ export declare const taxRegistrationRoutes: readonly [{
             expires_at: z.ZodNullable<z.ZodNumber>;
             status: z.ZodEnum<{
                 active: "active";
+                expired: "expired";
                 pending_approval: "pending_approval";
                 scheduled: "scheduled";
-                expired: "expired";
             }>;
             approved_at: z.ZodNullable<z.ZodNumber>;
             provider_registration_ref: z.ZodNullable<z.ZodString>;