@openrails/billing-ui 0.235.0 → 0.236.0

package/dist/client/generated/wire.d.ts

@@ -68,6 +68,14 @@ export type CardEntry = {
     exp_year?: number;
     cvc?: string;
 };
+export type Cart = {
+    currency: string;
+    total: string;
+    lines: OrderPreviewLine[];
+    payment_options: OrderPaymentOption[];
+    last_changed_at: string | null;
+    expires_at: string | null;
+};
 export type CheckoutSession = {
     id: string;
     status: string;
@@ -133,14 +141,20 @@ export type CheckoutSessionSavedMethod = {
     rail: string;
     card: CardDetails | null;
 };
-export type CreateOrderParams = {
+export type CreateMyOrderParams = {
     lines?: OrderLineParams[];
+    cart?: boolean;
     expected_total?: string;
-    payment?: OrderPayment;
+    payment?: OrderPaymentParams;
+    reusable?: boolean;
+};
+export type CreateNetworkLinkParams = {
+    challenge_id?: string;
+    id_token?: string;
 };
 export type CreatePaymentMethodParams = {
     psp_id?: string;
-    payment_token?: string;
+    token?: string;
     card?: CardEntry;
     billing_details?: BillingDetails;
 };
@@ -179,6 +193,17 @@ export type CustomerEntitlement = {
     entitlement: string;
     quantity: number | null;
 };
+export type CustomerLink = {
+    id: string;
+    merchant_id: string;
+    customer_id: string;
+    account_id: string;
+    method: "checkout" | "connect" | "sign_in";
+    status: "active" | "revoked";
+    linked_at: string;
+    revoked_at: string | null;
+    revoked_by: "account_deleted" | "customer" | "merchant_left" | null;
+};
 export type CustomerNotificationLookup = {
     notifications: Record<string, Notification | null> | null;
 };
@@ -281,6 +306,11 @@ export type MintCheckoutSessionParams = {
     auto_renew?: boolean;
     success_url?: string;
 };
+export type NetworkLinkChallenge = {
+    id: string;
+    nonce: string;
+    expires_at: string;
+};
 export type NextAction = {
     type: string;
     url: string | null;
@@ -343,23 +373,30 @@ export type NotificationData = {
 export type Order = {
     id: string;
     customer_id: string;
-    origin: "customer" | "merchant";
-    status: "canceled" | "expired" | "open" | "paid" | "processing" | "requires_action";
+    origin: "customer" | "merchant" | "subscription";
+    status: "canceled" | "complete" | "expired" | "open" | "processing" | "void";
     number: string | null;
     currency: string;
     total: string;
     lines: OrderLine[];
-    next_action: NextAction | null;
-    last_payment_error: PaymentFailure | null;
+    payment: OrderPayment;
     payment_options: OrderPaymentOption[];
-    payment_method_id: string | null;
-    payment_id: string | null;
-    expires_at: string;
-    paid_at: string | null;
+    checkout: OrderCheckout | null;
+    renewal: OrderRenewal | null;
+    expires_at: string | null;
+    completed_at: string | null;
     canceled_at: string | null;
     expired_at: string | null;
+    voided_at: string | null;
     created_at: string;
 };
+export type OrderCheckout = {
+    url: string | null;
+    expires_at: string;
+    success_url: string;
+    cancel_url: string | null;
+    saved_payment_methods: boolean;
+};
 export type OrderLine = {
     id: string;
     price_id: string;
@@ -377,6 +414,7 @@ export type OrderLine = {
 export type OrderLineParams = {
     price_id?: string;
     quantity?: number;
+    amount?: string;
 };
 export type OrderLineRefusal = {
     code: string;
@@ -385,13 +423,25 @@ export type OrderLineRefusal = {
     hint: string | null;
 };
 export type OrderPayment = {
-    payment_method_id?: string;
+    status: "processing" | "requires_action" | "requires_payment_method" | "succeeded";
+    next_action: NextAction | null;
+    last_payment_error: PaymentFailure | null;
+    payment_method_id: string | null;
+    payment_id: string | null;
 };
 export type OrderPaymentOption = {
     psp_id: string;
     rail: string;
     accepts: string[];
 };
+export type OrderPaymentParams = {
+    payment_method_id?: string;
+    token?: string;
+    psp_id?: string;
+    billing_details?: BillingDetails;
+    token_symbol?: string;
+    return_url?: string;
+};
 export type OrderPreview = {
     currency: string;
     total: string;
@@ -410,6 +460,12 @@ export type OrderPreviewLine = {
     access_duration_hours: number | null;
     refusal: OrderLineRefusal | null;
 };
+export type OrderRenewal = {
+    subscription_id: string;
+    period_starts_at: string;
+    period_ends_at: string;
+    due_at: string;
+};
 export type PSPLinkState = {
     status: "error" | "linked" | "pending_manual_link" | "sync_disabled";
     ids: Record<string, string> | null;
@@ -442,8 +498,9 @@ export type PayInvoiceParams = {
     payment_method_id?: string;
 };
 export type PayOrderParams = {
-    payment?: OrderPayment;
+    payment?: OrderPaymentParams;
     expected_total?: string;
+    reusable?: boolean;
 };
 export type Payment = {
     id: string;
@@ -485,7 +542,8 @@ export type PaymentMethod = {
     customer_id: string;
     rail: string;
     psp_id: string | null;
-    status: "active" | "closed" | "removed" | "replaced";
+    status: "active" | "closed" | "removed" | "replaced" | "requires_action";
+    next_action: NextAction | null;
     replaced_by: string | null;
     card: CardDetails | null;
     billing_details: BillingDetails | null;
@@ -503,17 +561,6 @@ export type PaymentMethodHealth = {
     last_charge_outcome: "failed" | "succeeded" | null;
     active: boolean;
 };
-export type PaymentMethodSetup = {
-    id: string;
-    status: string;
-    setup_intent_id?: string;
-    client_secret?: string;
-    payment_method_id?: string;
-};
-export type PaymentMethodSetupParams = {
-    psp_id?: string;
-    consent?: boolean;
-};
 export type PaymentMethodSubscription = {
     id: string;
     display_name: string;
@@ -528,6 +575,7 @@ export type PaymentRecovery = {
     retryable: boolean;
     blocked_reason?: string;
     operation?: PaymentOperation;
+    order_id?: string;
 };
 export type PendingAction = {
     psp: string;
@@ -535,11 +583,9 @@ export type PendingAction = {
     hint: string;
     patch_required: Record<string, Record<string, Record<string, string>>> | null;
 };
-export type PortalResponse = {
-    url: string;
-};
-export type PreviewOrderParams = {
+export type PreviewMyOrderParams = {
     lines?: OrderLineParams[];
+    cart?: boolean;
 };
 export type PreviewSubscriptionChangeParams = {
     price_id?: string | null;
@@ -581,27 +627,6 @@ export type Product = {
     created_at: string;
     updated_at: string;
 };
-export type ProductAccessGrant = {
-    id: string;
-    customer_id: string;
-    product_id: string;
-    product_key: string;
-    product_name: string;
-    source_type: "grace" | "grant" | "purchase" | "subscription";
-    source_id: string;
-    payment_id: string | null;
-    quantity: number | null;
-    grant_reason: "comp" | "import" | "migration" | "staff" | null;
-    granted_by: string | null;
-    note: string | null;
-    status: string;
-    starts_at: string;
-    ends_at: string | null;
-    revoked_at: string | null;
-    revoke_reason: string | null;
-    created_at: string;
-    updated_at: string;
-};
 export type ProductSummary = {
     id: string;
     key: string;
@@ -616,8 +641,14 @@ export type PublicConfig = {
     currencies: CurrencyUnits[];
     rails: RailDefinition[];
     payment: PaymentConfig | null;
+    merchant: PublicMerchant | null;
     captcha: CaptchaConfig | null;
 };
+export type PublicMerchant = {
+    display_name: string;
+    logo_url: string | null;
+    support_url: string | null;
+};
 export type Quantity = {
     min: number;
     max: number;
@@ -646,6 +677,10 @@ export type ScheduledChange = {
     price?: Price;
     product?: ProductSummary;
 };
+export type SetCartLineParams = {
+    quantity?: number;
+    amount?: string;
+};
 export type SetDefaultPaymentMethodParams = {
     payment_method_id?: string;
 };
@@ -677,28 +712,15 @@ export type SolanaPaymentToken = {
     preferred: boolean;
     recurring_eligible: boolean;
 };
-export type SpendLimits = {
-    currency: string;
-    invoker: string;
-    windows: SpendWindow[];
-};
-export type SpendWindow = {
-    scope: "invoker" | "invoker_tier" | "role";
-    key: string;
-    window_seconds: number;
-    limit: string;
-    currency: string;
-    used: string;
-    reserved: string;
-    remaining: string;
-    resets_at: string;
-};
 export type StripeEngineAuthentication = {
     operation: PaymentOperation;
     payment_intent_id?: string;
     client_secret?: string;
     provider_payment_method_id?: string;
 };
+export type StripePortalSession = {
+    url: string;
+};
 export type Subscription = {
     collection_policy: string;
     recovery?: PaymentRecovery;

package/dist/client/index.d.ts

@@ -1,4 +1,4 @@
-export { CANCEL_REASON_MAX, CANCEL_REASON_MIN, createBillingClient, isWalletAction, isWalletRejection, RETRY_BUDGET_MS, signWalletAction, WalletRejectedError, type BillingClient, type BillingClientOptions, type CheckoutSourceOptions, type ListOptions, type SendSolanaTransaction, type SubscriptionChangeInput, } from './client';
+export { CANCEL_REASON_MAX, CANCEL_REASON_MIN, createBillingClient, isWalletAction, isWalletRejection, RETRY_BUDGET_MS, signWalletAction, WalletRejectedError, type BillingClient, type BillingClientOptions, type ListOptions, type OrderResult, type ProductListOptions, type SendSolanaTransaction, type SubscriptionChangeInput, } from './client';
 export { BillingError, isBillingError, isServerError, readBillingError, toBillingError, type BillingErrorBody, } from './errors';
-export type { Account, Balance, CaptchaConfig, CardSetup, CardSummary, Currency, CurrencyScales, PaymentConfig, PublicConfig, CheckoutSessionLink, Invoice, ListPage, NewCard, NextAction, Page, Payment, PaymentAuthentication, PaymentMethod, PaymentOperation, PaymentRecovery, Price, Product, SolanaToken, Subscription, SubscriptionDunning, SubscriptionProduct, SubscriptionStatus, SubscriptionChange, SubscriptionChangePreview, } from './types';
+export type { Account, Balance, CaptchaConfig, CardSummary, Cart, Currency, CurrencyScales, PaymentConfig, PaymentFailure, PublicConfig, PublicMerchant, CheckoutSessionLink, Invoice, ListPage, NewCard, NextAction, Order, OrderLine, OrderLineRefusal, OrderNextAction, OrderPaymentInput, OrderPreviewLine, Page, Payment, PaymentAuthentication, PaymentMethod, PaymentOperation, PaymentRecovery, Price, Product, SolanaToken, Subscription, SubscriptionDunning, SubscriptionProduct, SubscriptionStatus, SubscriptionChange, SubscriptionChangePreview, } from './types';
 export { amountToDecimal, decimalToAmount, formatAmount, type Amount, } from '../lib/money';

package/dist/client/types.d.ts

@@ -95,6 +95,7 @@ export declare const paymentRecoverySchema: z.ZodObject<{
         id: z.ZodString;
         status: z.ZodString;
     }, z.core.$strip>>>;
+    order_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type PaymentRecovery = z.infer<typeof paymentRecoverySchema>;
 /**
@@ -245,6 +246,7 @@ export declare const subscriptionSchema: z.ZodObject<{
             id: z.ZodString;
             status: z.ZodString;
         }, z.core.$strip>>>;
+        order_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>>;
     next_action: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         type: z.ZodString;
@@ -275,6 +277,12 @@ export declare const billingDetailsSchema: z.ZodObject<{
 export type BillingDetails = z.infer<typeof billingDetailsSchema>;
 export declare const paymentMethodSchema: z.ZodObject<{
     id: z.ZodString;
+    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    next_action: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        type: z.ZodString;
+        psp_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        payload: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    }, z.core.$strip>>>;
     rail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     psp_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     card: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -296,6 +304,7 @@ export declare const paymentMethodSchema: z.ZodObject<{
             country: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>>;
+    reusable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     health: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         expiry_status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         last_charged_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -310,6 +319,205 @@ export declare const paymentMethodSchema: z.ZodObject<{
     created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type PaymentMethod = z.infer<typeof paymentMethodSchema>;
+/** Why the latest payment attempt failed, in the customer's words. */
+export declare const paymentFailureSchema: z.ZodObject<{
+    reason: z.ZodString;
+    message: z.ZodString;
+    field: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type PaymentFailure = z.infer<typeof paymentFailureSchema>;
+/**
+ * What the customer completes before a payment can finish: `authenticate`
+ * runs the PSP's own script with `payload` (Stripe.js `handleNextAction`
+ * with `client_secret`); `redirect_to_url` leaves for `url`.
+ */
+export declare const orderNextActionSchema: z.ZodObject<{
+    type: z.ZodString;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    psp_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    transactions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    payload: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+}, z.core.$strip>;
+export type OrderNextAction = z.infer<typeof orderNextActionSchema>;
+export declare const orderLineSchema: z.ZodObject<{
+    id: z.ZodString;
+    price_id: z.ZodString;
+    product_id: z.ZodString;
+    description: z.ZodString;
+    quantity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    unit_amount: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+    amount: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+    billing_interval_hours: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    access_duration_hours: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    subscription_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    product_access_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type OrderLine = z.infer<typeof orderLineSchema>;
+/**
+ * A purchase, or a subscription's renewal (`origin: subscription`): frozen
+ * lines and total, read and paid by its own customer. `status` is the
+ * order's (`open | processing | complete | canceled | expired | void`);
+ * `payment.status` its payment's (`requires_payment_method |
+ * requires_action | processing | succeeded`).
+ */
+export declare const orderSchema: z.ZodObject<{
+    id: z.ZodString;
+    customer_id: z.ZodString;
+    origin: z.ZodString;
+    status: z.ZodString;
+    number: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    currency: z.ZodString;
+    total: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+    lines: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        price_id: z.ZodString;
+        product_id: z.ZodString;
+        description: z.ZodString;
+        quantity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        unit_amount: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+        amount: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+        billing_interval_hours: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        access_duration_hours: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        subscription_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        product_access_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    payment: z.ZodObject<{
+        status: z.ZodString;
+        next_action: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            type: z.ZodString;
+            url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            psp_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            transactions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+            payload: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        }, z.core.$strip>>>;
+        last_payment_error: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            reason: z.ZodString;
+            message: z.ZodString;
+            field: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+        payment_method_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        payment_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    payment_options: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        psp_id: z.ZodString;
+        rail: z.ZodString;
+        accepts: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>>, z.ZodTransform<{
+        psp_id: string;
+        rail: string;
+        accepts: string[];
+    }[], {
+        psp_id: string;
+        rail: string;
+        accepts: string[];
+    }[] | null | undefined>>;
+    checkout: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        success_url: z.ZodString;
+        cancel_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        saved_payment_methods: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    renewal: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        subscription_id: z.ZodString;
+        period_starts_at: z.ZodString;
+        period_ends_at: z.ZodString;
+        due_at: z.ZodString;
+    }, z.core.$strip>>>;
+    expires_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    completed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    canceled_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    expired_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    voided_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodString;
+}, z.core.$strip>;
+export type Order = z.infer<typeof orderSchema>;
+/** Why a line cannot be bought: `already_owned`, `unavailable`, ... */
+export declare const orderLineRefusalSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    owned_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    hint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type OrderLineRefusal = z.infer<typeof orderLineRefusalSchema>;
+/** One line priced as an order would freeze it, or why it cannot be bought. */
+export declare const orderPreviewLineSchema: z.ZodObject<{
+    price_id: z.ZodString;
+    product_id: z.ZodString;
+    description: z.ZodString;
+    quantity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    unit_amount: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+    amount: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+    ownership: z.ZodString;
+    billing_interval_hours: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    access_duration_hours: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    refusal: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        owned_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        hint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type OrderPreviewLine = z.infer<typeof orderPreviewLineSchema>;
+/**
+ * The customer's cart, priced live: one per customer of a merchant, shared by
+ * the merchant's sites. `last_changed_at` and `expires_at` are null while it
+ * is empty.
+ */
+export declare const cartSchema: z.ZodObject<{
+    currency: z.ZodString;
+    total: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+    lines: z.ZodArray<z.ZodObject<{
+        price_id: z.ZodString;
+        product_id: z.ZodString;
+        description: z.ZodString;
+        quantity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        unit_amount: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+        amount: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+        ownership: z.ZodString;
+        billing_interval_hours: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        access_duration_hours: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        refusal: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            owned_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            hint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    payment_options: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        psp_id: z.ZodString;
+        rail: z.ZodString;
+        accepts: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>>, z.ZodTransform<{
+        psp_id: string;
+        rail: string;
+        accepts: string[];
+    }[], {
+        psp_id: string;
+        rail: string;
+        accepts: string[];
+    }[] | null | undefined>>;
+    last_changed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    expires_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type Cart = z.infer<typeof cartSchema>;
+/**
+ * How to pay an order: a saved card, a card just entered (the token of the
+ * PSP's own fields, its `psp_id`), a Solana wallet (`token_symbol`, the
+ * token it pays in) or the PSP's hosted page (`return_url`).
+ */
+export type OrderPaymentInput = {
+    payment_method_id: string;
+} | {
+    token: string;
+    psp_id?: string;
+    billing_details?: NewCard["billing_details"];
+} | {
+    token_symbol: string;
+    psp_id?: string;
+} | {
+    return_url: string;
+    psp_id?: string;
+};
 /** A price's state on one PSP; public routes carry the status only. */
 export declare const productSchema: z.ZodObject<{
     id: z.ZodString;
@@ -516,6 +724,7 @@ export declare const invoiceSchema: z.ZodObject<{
             id: z.ZodString;
             status: z.ZodString;
         }, z.core.$strip>>>;
+        order_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>>;
     created_at: z.ZodString;
 }, z.core.$strip>;
@@ -744,6 +953,13 @@ export type CaptchaConfig = z.infer<typeof captchaConfigSchema>;
  * merchant's payment setup (null when the request resolves no merchant) and
  * the captcha (null when the deployment challenges nobody).
  */
+/** The merchant as its customers see it; logo and support are https. */
+export declare const publicMerchantSchema: z.ZodObject<{
+    display_name: z.ZodString;
+    logo_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    support_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type PublicMerchant = z.infer<typeof publicMerchantSchema>;
 export declare const publicConfigSchema: z.ZodObject<{
     capabilities: z.ZodObject<{
         route_groups: z.ZodRecord<z.ZodString, z.ZodBoolean>;
@@ -825,6 +1041,11 @@ export declare const publicConfigSchema: z.ZodObject<{
             }[] | null | undefined>>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>>;
+    merchant: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        display_name: z.ZodString;
+        logo_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        support_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
     captcha: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         provider: z.ZodString;
         site_key: z.ZodString;
@@ -834,14 +1055,6 @@ export declare const publicConfigSchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type PublicConfig = z.infer<typeof publicConfigSchema>;
-/** An in-page card setup; `payment_method_id` is set once the card is saved. */
-export declare const cardSetupSchema: z.ZodObject<{
-    id: z.ZodString;
-    status: z.ZodString;
-    client_secret: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    payment_method_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
-export type CardSetup = z.infer<typeof cardSetupSchema>;
 export declare const paymentAuthenticationSchema: z.ZodObject<{
     client_secret: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
@@ -863,22 +1076,22 @@ interface NewCardFields {
     };
 }
 /**
- * A card to save: a token from the PSP's own fields (`payment_token`), or,
- * for a PSP whose card_entry is server (`cardSetupDriver` "card"), the card
- * itself, posted to OpenRails and never kept by this package.
+ * A card to save: the single-use token of the PSP's own fields (a Collect.js
+ * token, a Stripe `pm_`), or, for a PSP whose card_entry is server
+ * (`cardSetupDriver` "card"), the card itself, posted to OpenRails and never
+ * kept by this package.
  */
 export type NewCard = NewCardFields & ({
-    payment_token: string;
+    token: string;
     card?: never;
 } | {
     card: CardEntry;
-    payment_token?: never;
+    token?: never;
 });
 /**
- * A minted checkout session. `id` reads and pays it with no other credential
- * (`client.checkoutSource(id)`); hand it to this customer's browser only.
- * `url` is the shared payment page (`<CheckoutFrame url>`), null when the app
- * renders `<Checkout>` itself.
+ * A minted checkout session. `id` reads and pays it with no other credential;
+ * hand it to this customer's browser only. `url` is the shared payment page
+ * (`<CheckoutFrame url>`), null when BuyButton renders the checkout itself.
  */
 export declare const checkoutSessionLinkSchema: z.ZodObject<{
     id: z.ZodString;