@peable.to/contracts 3.1.0 → 4.0.0

package/dist/esm/vocabulary/checkout.js

@@ -2,6 +2,23 @@
 // Checkout Sessions and Payment Links. Zod-free, so the hosted checkout and
 // the wallet import them without the schemas (`@peable.to/contracts/vocabulary`,
 // re-exported by `@peable.to/shared-types`).
+/**
+ * Why FairCoin cannot be paid with on an order right now (ADR 0021). It is
+ * still offered — never hidden — and says why:
+ *
+ *  - `faircoin_wallet_missing` — the Peable wallet of the account that receives
+ *    (the merchant's owner, or the seller) isn't set up yet: no identity key;
+ *  - `faircoin_network_closed` — this deployment does not open payments on the
+ *    order's FairCoin network yet (ADR 0002's gate);
+ *  - `price_unavailable` — no fresh FairCoin price exists to quote a fiat order;
+ *  - `temporarily_unavailable` — whether the wallet exists could not be checked.
+ */
+export const FAIRCOIN_UNAVAILABLE_REASONS = [
+    'faircoin_wallet_missing',
+    'faircoin_network_closed',
+    'price_unavailable',
+    'temporarily_unavailable',
+];
 export const CHECKOUT_SESSION_MODES = ['payment', 'setup', 'subscription'];
 export const CHECKOUT_SESSION_STATUSES = ['open', 'complete', 'expired'];
 export const CHECKOUT_PAYMENT_STATUSES = ['paid', 'unpaid', 'no_payment_required'];

package/dist/esm/vocabulary/errors.js

@@ -55,6 +55,7 @@ export const ERROR_CODE_DESCRIPTIONS = {
     parameter_missing: 'A required parameter is missing; `param` names it.',
     parameter_unknown: 'The request carries a parameter this route does not accept; `param` names it.',
     payment_intent_unexpected_state: 'The PaymentIntent is in a status that does not allow this operation.',
+    payment_method_locked: 'The payment method cannot be turned off or removed: FairCoin is always offered to every payer; `param` names the field.',
     payout_not_allowed: 'Payouts cannot be created for this account.',
     rate_limited: 'Too many requests; back off and retry.',
     refund_not_cancelable: 'The refund has already left a cancelable state.',
@@ -65,7 +66,6 @@ export const ERROR_CODE_DESCRIPTIONS = {
     test_mode_only: 'This operation exists in test mode only.',
     too_many_streams: 'Too many live streams are open for this merchant.',
     url_invalid: 'The URL is not an allowed https URL.',
-    watch_only_violation: 'The extended key carries a private key. Peable only ever accepts watch-only (public) keys.',
     webhook_endpoint_disabled: 'The webhook endpoint is disabled.',
     webhook_endpoint_limit_reached: 'The merchant already has the maximum number of webhook endpoints.',
     account_not_ready: 'The connected account cannot take this payment yet: its onboarding or a capability is incomplete.',
@@ -126,6 +126,9 @@ export const ERROR_CODE_DESCRIPTIONS = {
     promotion_code_minimum_amount: 'The purchase is below the promotion code minimum amount.',
     payment_method_missing: 'No payment method is available to charge.',
     faircoin_cannot_debit: 'A FairCoin invoice cannot be charged automatically: the payer signs every payment.',
+    faircoin_price_unavailable: 'No fresh FairCoin price exists right now, so this order cannot be quoted in FAIR. The other payment methods still work; try FairCoin again shortly.',
+    faircoin_wallet_missing: "The Peable wallet that receives this payment (the merchant owner's, or the seller's) isn't set up yet, so it cannot be paid in FairCoin. The other payment methods still work.",
+    faircoin_network_closed: 'FairCoin payments on this network are not open on this deployment yet. The other payment methods still work.',
     credit_note_exceeds_invoice: "The credit note's amount exceeds what the invoice can still credit.",
     test_clock_unexpected_state: 'The test clock is advancing; wait until it is ready.',
     meter_event_customer_missing: 'The meter event names no customer of this merchant.',
@@ -138,8 +141,7 @@ export const ERROR_CODE_DESCRIPTIONS = {
     // Connect onboarding (ADR 0012 D3): the seller-facing refusals.
     link_expired: 'The onboarding link has expired or was already used; `refresh_url` is where the seller gets a fresh one.',
     wrong_seller: 'The onboarding link names a different Oxy account; sign in as the seller it was minted for.',
-    already_registered: 'The seller already registered a FairCoin key, and it cannot be changed.',
-    key_in_use: 'The key already receives payments for another account.',
+    already_registered: 'The seller already confirmed FairCoin payments into their Peable wallet.',
     no_faircoin_half: 'The connected account has no FairCoin half to register a key for.',
     // The dashboard routes (`/v1/dashboard/*`, Orbit): the signed-in person, not a credential.
     merchant_missing: 'The application has no merchant in this environment yet; register one (Orbit shows "Set up payments").',

package/dist/esm/vocabulary/paymentMethodConfigurations.js

@@ -1,7 +1,15 @@
-// Payment method breadth on the card rail (`pmc_…`, `pmd_…`). Zod-free.
-import { FIAT_CURRENCY_CODES } from './money.js';
+// Payment method breadth (`pmc_…`, `pmd_…`): the merchant's card-rail methods,
+// and FairCoin, which is always offered (ADR 0021). Zod-free.
+import { CURRENCY_CODES, FIAT_CURRENCY_CODES } from './money.js';
 /**
- * The methods a configuration can turn on.
+ * The methods a configuration lists.
+ *
+ * `faircoin` is listed and LOCKED (ADR 0021 D2): every payer can always pay
+ * with FairCoin, so its entry is always `display_preference.value: 'on'` with
+ * `locked: true`, and a create or update that sets it `off` is refused with
+ * `payment_method_locked`. It is the chain rail, never a card-provider method:
+ * it is never pushed to the provider and never appears in a card PaymentIntent's
+ * `payment_method_types`. Every other method is the merchant's to turn on and off.
  *
  * `apple_pay` and `google_pay` are WALLETS over a card: a payment made with one
  * is a `card` payment, so they appear here and never in a PaymentIntent's
@@ -13,6 +21,7 @@ import { FIAT_CURRENCY_CODES } from './money.js';
  * scheme).
  */
 export const PAYMENT_METHOD_CONFIGURATION_TYPES = [
+    'faircoin',
     'card',
     'apple_pay',
     'google_pay',
@@ -26,18 +35,29 @@ export const PAYMENT_METHOD_CONFIGURATION_TYPES = [
  * Why a method cannot be offered whatever the merchant chooses.
  *
  *  - `provider_unsupported` — the processing provider does not offer it;
- *  - `requires_card` — a wallet rides on card payments, and card is off.
+ *  - `requires_card` — a wallet rides on card payments, and card is off;
+ *  - `faircoin_wallet_missing` — the Peable wallet of the account that owns
+ *    the merchant isn't set up yet (no identity key), so FairCoin cannot be
+ *    received (ADR 0021 D5); the owner sets it up in Peable;
+ *  - `faircoin_network_closed` — the deployment does not open the merchant's
+ *    FairCoin network yet (ADR 0002's gate);
+ *  - `temporarily_unavailable` — the wallet could not be checked just now.
  */
 export const PAYMENT_METHOD_UNAVAILABLE_REASONS = [
     'provider_unsupported',
     'requires_card',
+    'faircoin_wallet_missing',
+    'faircoin_network_closed',
+    'temporarily_unavailable',
 ];
 /**
  * The currencies each method can take a payment in. A method is offered on a
  * payment only when its currency is listed — so iDEAL never appears on a USD
- * payment, and a payer is never shown a method that would fail.
+ * payment, and a payer is never shown a method that would fail. FairCoin takes
+ * every currency: a `FAIR` order directly, a fiat one at a quoted price (ADR 0021).
  */
 export const PAYMENT_METHOD_CURRENCIES = Object.freeze({
+    faircoin: CURRENCY_CODES,
     card: FIAT_CURRENCY_CODES,
     apple_pay: FIAT_CURRENCY_CODES,
     google_pay: FIAT_CURRENCY_CODES,

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

@@ -4822,6 +4822,15 @@ export declare const billingEngineRoutes: readonly [{
             card: "card";
             faircoin: "faircoin";
         }>>;
+        faircoin: import("zod").ZodObject<{
+            available: import("zod").ZodBoolean;
+            unavailable_reason: import("zod").ZodNullable<import("zod").ZodEnum<{
+                faircoin_wallet_missing: "faircoin_wallet_missing";
+                faircoin_network_closed: "faircoin_network_closed";
+                price_unavailable: "price_unavailable";
+                temporarily_unavailable: "temporarily_unavailable";
+            }>>;
+        }, import("zod/v4/core").$strict>;
         invoice_pdf: import("zod").ZodString;
     }, import("zod/v4/core").$strict>;
 }, {
@@ -4830,12 +4839,17 @@ export declare const billingEngineRoutes: readonly [{
     readonly path: "/v1/invoices/public/{token}/pay";
     readonly tag: "Hosted invoices";
     readonly summary: "Pay a hosted invoice";
-    readonly description: "The PaymentIntent the payer completes — a card through the provider’s own fields, FairCoin from the payer’s wallet. The same invoice answers the same intent while it can still be paid.";
+    readonly description: "The PaymentIntent the payer completes in the method they chose — a card through the provider’s own fields, or FairCoin from the payer’s wallet (quoted on a fiat invoice, ADR 0021). The same invoice answers the same intent while it can still be paid in that method.";
     readonly auth: "public";
     readonly params: {
         readonly token: "The hosted invoice token (from `hosted_invoice_url`).";
     };
-    readonly body: import("zod").ZodObject<{}, import("zod/v4/core").$strict>;
+    readonly body: import("zod").ZodObject<{
+        payment_method_type: import("zod").ZodOptional<import("zod").ZodEnum<{
+            card: "card";
+            faircoin: "faircoin";
+        }>>;
+    }, import("zod/v4/core").$strict>;
     readonly response: import("zod").ZodObject<{
         object: import("zod").ZodLiteral<"public_invoice_payment">;
         payment_intent: import("zod").ZodString;

package/dist/types/resources/billingEngine/public.d.ts

@@ -59,6 +59,15 @@ export declare const publicInvoiceSchema: z.ZodObject<{
         card: "card";
         faircoin: "faircoin";
     }>>;
+    faircoin: z.ZodObject<{
+        available: z.ZodBoolean;
+        unavailable_reason: z.ZodNullable<z.ZodEnum<{
+            faircoin_wallet_missing: "faircoin_wallet_missing";
+            faircoin_network_closed: "faircoin_network_closed";
+            price_unavailable: "price_unavailable";
+            temporarily_unavailable: "temporarily_unavailable";
+        }>>;
+    }, z.core.$strict>;
     invoice_pdf: z.ZodString;
 }, z.core.$strict>;
 export type PublicInvoice = Expand<z.output<typeof publicInvoiceSchema>>;
@@ -509,7 +518,13 @@ declare module '../../common/objects' {
         'billing_portal.public_session': PublicPortalSession;
     }
 }
-export declare const payPublicInvoiceParams: z.ZodObject<{}, z.core.$strict>;
+/** How the payer pays the invoice (ADR 0021 D3). */
+export declare const payPublicInvoiceParams: z.ZodObject<{
+    payment_method_type: z.ZodOptional<z.ZodEnum<{
+        card: "card";
+        faircoin: "faircoin";
+    }>>;
+}, z.core.$strict>;
 /** A portal action on one of the customer's subscriptions. */
 export declare const portalSubscriptionParams: z.ZodObject<{
     subscription: z.ZodString;
@@ -611,6 +626,15 @@ export declare const publicBillingRoutes: readonly [{
             card: "card";
             faircoin: "faircoin";
         }>>;
+        faircoin: z.ZodObject<{
+            available: z.ZodBoolean;
+            unavailable_reason: z.ZodNullable<z.ZodEnum<{
+                faircoin_wallet_missing: "faircoin_wallet_missing";
+                faircoin_network_closed: "faircoin_network_closed";
+                price_unavailable: "price_unavailable";
+                temporarily_unavailable: "temporarily_unavailable";
+            }>>;
+        }, z.core.$strict>;
         invoice_pdf: z.ZodString;
     }, z.core.$strict>;
 }, {
@@ -619,12 +643,17 @@ export declare const publicBillingRoutes: readonly [{
     readonly path: "/v1/invoices/public/{token}/pay";
     readonly tag: "Hosted invoices";
     readonly summary: "Pay a hosted invoice";
-    readonly description: "The PaymentIntent the payer completes — a card through the provider’s own fields, FairCoin from the payer’s wallet. The same invoice answers the same intent while it can still be paid.";
+    readonly description: "The PaymentIntent the payer completes in the method they chose — a card through the provider’s own fields, or FairCoin from the payer’s wallet (quoted on a fiat invoice, ADR 0021). The same invoice answers the same intent while it can still be paid in that method.";
     readonly auth: "public";
     readonly params: {
         readonly token: "The hosted invoice token (from `hosted_invoice_url`).";
     };
-    readonly body: z.ZodObject<{}, z.core.$strict>;
+    readonly body: z.ZodObject<{
+        payment_method_type: z.ZodOptional<z.ZodEnum<{
+            card: "card";
+            faircoin: "faircoin";
+        }>>;
+    }, z.core.$strict>;
     readonly response: z.ZodObject<{
         object: z.ZodLiteral<"public_invoice_payment">;
         payment_intent: z.ZodString;

package/dist/types/resources/checkout/checkoutSessions.d.ts

@@ -2,10 +2,6 @@ import { z } from 'zod';
 import { type Expand } from '../../common/objects';
 /** The merchant/SDK-facing session — Stripe's Checkout Session. */
 export declare const checkoutSessionSchema: z.ZodObject<{
-    payment_method_types: z.ZodArray<z.ZodEnum<{
-        card: "card";
-        faircoin: "faircoin";
-    }>>;
     discounts: z.ZodArray<z.ZodObject<{
         coupon: z.ZodString;
         promotion_code: z.ZodNullable<z.ZodString>;
@@ -174,6 +170,10 @@ export declare const checkoutSessionSchema: z.ZodObject<{
         mainnet: "mainnet";
         testnet: "testnet";
     }>>;
+    payment_method_types: z.ZodArray<z.ZodEnum<{
+        card: "card";
+        faircoin: "faircoin";
+    }>>;
     amount_subtotal: z.ZodString;
     amount_total: z.ZodString;
     total_details: z.ZodObject<{
@@ -314,6 +314,15 @@ export declare const checkoutSessionPublicSchema: z.ZodObject<{
         }>;
     }, z.core.$strict>;
     publishable_key: z.ZodNullable<z.ZodString>;
+    faircoin: z.ZodNullable<z.ZodObject<{
+        available: z.ZodBoolean;
+        unavailable_reason: z.ZodNullable<z.ZodEnum<{
+            faircoin_wallet_missing: "faircoin_wallet_missing";
+            faircoin_network_closed: "faircoin_network_closed";
+            price_unavailable: "price_unavailable";
+            temporarily_unavailable: "temporarily_unavailable";
+        }>>;
+    }, z.core.$strict>>;
     shipping_details: z.ZodNullable<z.ZodObject<{
         name: z.ZodString;
         address: z.ZodObject<{
@@ -437,6 +446,10 @@ export declare const checkoutSessionPublicSchema: z.ZodObject<{
         mainnet: "mainnet";
         testnet: "testnet";
     }>>;
+    payment_method_types: z.ZodArray<z.ZodEnum<{
+        card: "card";
+        faircoin: "faircoin";
+    }>>;
     amount_subtotal: z.ZodString;
     amount_total: z.ZodString;
     total_details: z.ZodObject<{
@@ -819,8 +832,16 @@ export declare const updateCheckoutSessionPublicParams: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type UpdateCheckoutSessionPublicParams = z.input<typeof updateCheckoutSessionPublicParams>;
-/** `POST /v1/checkout_sessions/{id}/public/confirm` takes nothing: the order is the session's. */
-export declare const confirmCheckoutSessionPublicParams: z.ZodObject<{}, z.core.$strict>;
+/**
+ * `POST /v1/checkout_sessions/{id}/public/confirm` — the order is the
+ * session's; the payer only chooses how to pay it (ADR 0021 D3).
+ */
+export declare const confirmCheckoutSessionPublicParams: z.ZodObject<{
+    payment_method_type: z.ZodOptional<z.ZodEnum<{
+        card: "card";
+        faircoin: "faircoin";
+    }>>;
+}, z.core.$strict>;
 export type ConfirmCheckoutSessionPublicParams = z.input<typeof confirmCheckoutSessionPublicParams>;
 /** `POST /v1/test_helpers/checkout_sessions/{id}/expire` takes nothing. */
 export declare const expireCheckoutSessionTestHelperParams: z.ZodObject<{}, z.core.$strict>;
@@ -995,10 +1016,6 @@ export declare const checkoutSessionRoutes: readonly [{
         }>>;
     }, z.core.$strict>;
     readonly response: z.ZodObject<{
-        payment_method_types: z.ZodArray<z.ZodEnum<{
-            card: "card";
-            faircoin: "faircoin";
-        }>>;
         discounts: z.ZodArray<z.ZodObject<{
             coupon: z.ZodString;
             promotion_code: z.ZodNullable<z.ZodString>;
@@ -1167,6 +1184,10 @@ export declare const checkoutSessionRoutes: readonly [{
             mainnet: "mainnet";
             testnet: "testnet";
         }>>;
+        payment_method_types: z.ZodArray<z.ZodEnum<{
+            card: "card";
+            faircoin: "faircoin";
+        }>>;
         amount_subtotal: z.ZodString;
         amount_total: z.ZodString;
         total_details: z.ZodObject<{
@@ -1223,10 +1244,6 @@ export declare const checkoutSessionRoutes: readonly [{
     readonly response: z.ZodObject<{
         object: z.ZodLiteral<"list">;
         data: z.ZodArray<z.ZodObject<{
-            payment_method_types: z.ZodArray<z.ZodEnum<{
-                card: "card";
-                faircoin: "faircoin";
-            }>>;
             discounts: z.ZodArray<z.ZodObject<{
                 coupon: z.ZodString;
                 promotion_code: z.ZodNullable<z.ZodString>;
@@ -1395,6 +1412,10 @@ export declare const checkoutSessionRoutes: readonly [{
                 mainnet: "mainnet";
                 testnet: "testnet";
             }>>;
+            payment_method_types: z.ZodArray<z.ZodEnum<{
+                card: "card";
+                faircoin: "faircoin";
+            }>>;
             amount_subtotal: z.ZodString;
             amount_total: z.ZodString;
             total_details: z.ZodObject<{
@@ -1432,10 +1453,6 @@ export declare const checkoutSessionRoutes: readonly [{
         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<{
-        payment_method_types: z.ZodArray<z.ZodEnum<{
-            card: "card";
-            faircoin: "faircoin";
-        }>>;
         discounts: z.ZodArray<z.ZodObject<{
             coupon: z.ZodString;
             promotion_code: z.ZodNullable<z.ZodString>;
@@ -1604,6 +1621,10 @@ export declare const checkoutSessionRoutes: readonly [{
             mainnet: "mainnet";
             testnet: "testnet";
         }>>;
+        payment_method_types: z.ZodArray<z.ZodEnum<{
+            card: "card";
+            faircoin: "faircoin";
+        }>>;
         amount_subtotal: z.ZodString;
         amount_total: z.ZodString;
         total_details: z.ZodObject<{
@@ -1641,10 +1662,6 @@ export declare const checkoutSessionRoutes: readonly [{
         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<{
-        payment_method_types: z.ZodArray<z.ZodEnum<{
-            card: "card";
-            faircoin: "faircoin";
-        }>>;
         discounts: z.ZodArray<z.ZodObject<{
             coupon: z.ZodString;
             promotion_code: z.ZodNullable<z.ZodString>;
@@ -1813,6 +1830,10 @@ export declare const checkoutSessionRoutes: readonly [{
             mainnet: "mainnet";
             testnet: "testnet";
         }>>;
+        payment_method_types: z.ZodArray<z.ZodEnum<{
+            card: "card";
+            faircoin: "faircoin";
+        }>>;
         amount_subtotal: z.ZodString;
         amount_total: z.ZodString;
         total_details: z.ZodObject<{
@@ -1849,10 +1870,6 @@ export declare const checkoutSessionRoutes: readonly [{
         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<{
-        payment_method_types: z.ZodArray<z.ZodEnum<{
-            card: "card";
-            faircoin: "faircoin";
-        }>>;
         discounts: z.ZodArray<z.ZodObject<{
             coupon: z.ZodString;
             promotion_code: z.ZodNullable<z.ZodString>;
@@ -2021,6 +2038,10 @@ export declare const checkoutSessionRoutes: readonly [{
             mainnet: "mainnet";
             testnet: "testnet";
         }>>;
+        payment_method_types: z.ZodArray<z.ZodEnum<{
+            card: "card";
+            faircoin: "faircoin";
+        }>>;
         amount_subtotal: z.ZodString;
         amount_total: z.ZodString;
         total_details: z.ZodObject<{
@@ -2233,6 +2254,15 @@ export declare const checkoutSessionRoutes: readonly [{
             }>;
         }, z.core.$strict>;
         publishable_key: z.ZodNullable<z.ZodString>;
+        faircoin: z.ZodNullable<z.ZodObject<{
+            available: z.ZodBoolean;
+            unavailable_reason: z.ZodNullable<z.ZodEnum<{
+                faircoin_wallet_missing: "faircoin_wallet_missing";
+                faircoin_network_closed: "faircoin_network_closed";
+                price_unavailable: "price_unavailable";
+                temporarily_unavailable: "temporarily_unavailable";
+            }>>;
+        }, z.core.$strict>>;
         shipping_details: z.ZodNullable<z.ZodObject<{
             name: z.ZodString;
             address: z.ZodObject<{
@@ -2356,6 +2386,10 @@ export declare const checkoutSessionRoutes: readonly [{
             mainnet: "mainnet";
             testnet: "testnet";
         }>>;
+        payment_method_types: z.ZodArray<z.ZodEnum<{
+            card: "card";
+            faircoin: "faircoin";
+        }>>;
         amount_subtotal: z.ZodString;
         amount_total: z.ZodString;
         total_details: z.ZodObject<{
@@ -2545,6 +2579,15 @@ export declare const checkoutSessionRoutes: readonly [{
             }>;
         }, z.core.$strict>;
         publishable_key: z.ZodNullable<z.ZodString>;
+        faircoin: z.ZodNullable<z.ZodObject<{
+            available: z.ZodBoolean;
+            unavailable_reason: z.ZodNullable<z.ZodEnum<{
+                faircoin_wallet_missing: "faircoin_wallet_missing";
+                faircoin_network_closed: "faircoin_network_closed";
+                price_unavailable: "price_unavailable";
+                temporarily_unavailable: "temporarily_unavailable";
+            }>>;
+        }, z.core.$strict>>;
         shipping_details: z.ZodNullable<z.ZodObject<{
             name: z.ZodString;
             address: z.ZodObject<{
@@ -2668,6 +2711,10 @@ export declare const checkoutSessionRoutes: readonly [{
             mainnet: "mainnet";
             testnet: "testnet";
         }>>;
+        payment_method_types: z.ZodArray<z.ZodEnum<{
+            card: "card";
+            faircoin: "faircoin";
+        }>>;
         amount_subtotal: z.ZodString;
         amount_total: z.ZodString;
         total_details: z.ZodObject<{
@@ -2696,7 +2743,12 @@ export declare const checkoutSessionRoutes: readonly [{
     readonly params: {
         readonly id: "The Checkout Session (`cs_…`).";
     };
-    readonly body: z.ZodObject<{}, z.core.$strict>;
+    readonly body: z.ZodObject<{
+        payment_method_type: z.ZodOptional<z.ZodEnum<{
+            card: "card";
+            faircoin: "faircoin";
+        }>>;
+    }, z.core.$strict>;
     readonly response: z.ZodObject<{
         line_items: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -2809,6 +2861,15 @@ export declare const checkoutSessionRoutes: readonly [{
             }>;
         }, z.core.$strict>;
         publishable_key: z.ZodNullable<z.ZodString>;
+        faircoin: z.ZodNullable<z.ZodObject<{
+            available: z.ZodBoolean;
+            unavailable_reason: z.ZodNullable<z.ZodEnum<{
+                faircoin_wallet_missing: "faircoin_wallet_missing";
+                faircoin_network_closed: "faircoin_network_closed";
+                price_unavailable: "price_unavailable";
+                temporarily_unavailable: "temporarily_unavailable";
+            }>>;
+        }, z.core.$strict>>;
         shipping_details: z.ZodNullable<z.ZodObject<{
             name: z.ZodString;
             address: z.ZodObject<{
@@ -2932,6 +2993,10 @@ export declare const checkoutSessionRoutes: readonly [{
             mainnet: "mainnet";
             testnet: "testnet";
         }>>;
+        payment_method_types: z.ZodArray<z.ZodEnum<{
+            card: "card";
+            faircoin: "faircoin";
+        }>>;
         amount_subtotal: z.ZodString;
         amount_total: z.ZodString;
         total_details: z.ZodObject<{
@@ -2965,10 +3030,6 @@ export declare const checkoutSessionRoutes: readonly [{
     };
     readonly body: z.ZodObject<{}, z.core.$strict>;
     readonly response: z.ZodObject<{
-        payment_method_types: z.ZodArray<z.ZodEnum<{
-            card: "card";
-            faircoin: "faircoin";
-        }>>;
         discounts: z.ZodArray<z.ZodObject<{
             coupon: z.ZodString;
             promotion_code: z.ZodNullable<z.ZodString>;
@@ -3137,6 +3198,10 @@ export declare const checkoutSessionRoutes: readonly [{
             mainnet: "mainnet";
             testnet: "testnet";
         }>>;
+        payment_method_types: z.ZodArray<z.ZodEnum<{
+            card: "card";
+            faircoin: "faircoin";
+        }>>;
         amount_subtotal: z.ZodString;
         amount_total: z.ZodString;
         total_details: z.ZodObject<{