@openrails/billing-ui 0.234.0 → 0.236.0

package/dist/client/types.d.ts

@@ -43,6 +43,7 @@ export declare const priceSchema: z.ZodObject<{
     id: z.ZodString;
     key: z.ZodString;
     revision: z.ZodOptional<z.ZodNumber>;
+    version: z.ZodOptional<z.ZodNumber>;
     product_id: z.ZodString;
     archived: z.ZodBoolean;
     unit_amount: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
@@ -94,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>;
 /**
@@ -130,7 +132,9 @@ export declare const subscriptionSchema: z.ZodObject<{
     rail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     product_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     price_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    quantity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     psp_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    collection_policy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     payment_method_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     started_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     ended_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -158,6 +162,7 @@ export declare const subscriptionSchema: z.ZodObject<{
         id: z.ZodString;
         key: z.ZodString;
         revision: z.ZodOptional<z.ZodNumber>;
+        version: z.ZodOptional<z.ZodNumber>;
         product_id: z.ZodString;
         archived: z.ZodBoolean;
         unit_amount: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
@@ -196,6 +201,7 @@ export declare const subscriptionSchema: z.ZodObject<{
             id: z.ZodString;
             key: z.ZodString;
             revision: z.ZodOptional<z.ZodNumber>;
+            version: z.ZodOptional<z.ZodNumber>;
             product_id: z.ZodString;
             archived: z.ZodBoolean;
             unit_amount: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
@@ -240,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;
@@ -270,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<{
@@ -291,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>>;
@@ -301,10 +315,209 @@ export declare const paymentMethodSchema: z.ZodObject<{
         id: z.ZodString;
         display_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>>>;
-    collection_currencies: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    default_currencies: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     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;
@@ -326,6 +539,7 @@ export declare const productSchema: z.ZodObject<{
         id: z.ZodString;
         key: z.ZodString;
         revision: z.ZodOptional<z.ZodNumber>;
+        version: z.ZodOptional<z.ZodNumber>;
         product_id: z.ZodString;
         archived: z.ZodBoolean;
         unit_amount: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
@@ -359,6 +573,7 @@ export declare const productSchema: z.ZodObject<{
         created_at: string;
         updated_at: string;
         revision?: number | undefined;
+        version?: number | undefined;
         customer_amount?: {
             min_amount: string;
             max_amount: string;
@@ -382,6 +597,7 @@ export declare const productSchema: z.ZodObject<{
         created_at: string;
         updated_at: string;
         revision?: number | undefined;
+        version?: number | undefined;
         customer_amount?: {
             min_amount: string;
             max_amount: string;
@@ -412,6 +628,7 @@ export declare const paymentSchema: z.ZodObject<{
         id: z.ZodString;
         key: z.ZodString;
         revision: z.ZodOptional<z.ZodNumber>;
+        version: z.ZodOptional<z.ZodNumber>;
         product_id: z.ZodString;
         archived: z.ZodBoolean;
         unit_amount: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
@@ -465,8 +682,8 @@ export declare const balanceSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type Balance = z.infer<typeof balanceSchema>;
 /**
- * The signed-in customer's summary (`GET /me`): money per currency, the card
- * that pays each currency's invoices, and how many notices are unread.
+ * The signed-in customer's summary (`GET /me`): money per currency, the
+ * default card of each currency, and how many notices are unread.
  */
 export declare const accountSchema: z.ZodObject<{
     id: z.ZodString;
@@ -478,7 +695,7 @@ export declare const accountSchema: z.ZodObject<{
         available_amount: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
         owed_amount: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
     }, z.core.$strip>>;
-    collection_payment_methods: z.ZodArray<z.ZodObject<{
+    default_payment_methods: z.ZodArray<z.ZodObject<{
         currency: z.ZodString;
         payment_method_id: z.ZodString;
     }, z.core.$strip>>;
@@ -507,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>;
@@ -519,9 +737,9 @@ export declare const currencySchema: z.ZodObject<{
     minor_decimals: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 export type Currency = z.infer<typeof currencySchema>;
-export declare const tierChangePreviewSchema: z.ZodObject<{
-    action: z.ZodString;
+export declare const subscriptionChangePreviewSchema: z.ZodObject<{
     price_id: z.ZodString;
+    quantity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     rail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     currency: z.ZodString;
     amount_due_now: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
@@ -531,12 +749,12 @@ export declare const tierChangePreviewSchema: z.ZodObject<{
     is_estimate: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
-export type TierChangePreview = z.infer<typeof tierChangePreviewSchema>;
-export declare const tierChangeSchema: z.ZodObject<{
+export type SubscriptionChangePreview = z.infer<typeof subscriptionChangePreviewSchema>;
+export declare const subscriptionChangeSchema: z.ZodObject<{
     status: z.ZodString;
-    action: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     effective: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     price_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    quantity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     subscription_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     next_action: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         type: z.ZodString;
@@ -553,7 +771,7 @@ export declare const tierChangeSchema: z.ZodObject<{
     message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     operation_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
-export type TierChange = z.infer<typeof tierChangeSchema>;
+export type SubscriptionChange = z.infer<typeof subscriptionChangeSchema>;
 export declare const solanaTokenSchema: z.ZodObject<{
     symbol: z.ZodString;
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -716,11 +934,32 @@ export declare const paymentConfigSchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type PaymentConfig = z.infer<typeof paymentConfigSchema>;
+/**
+ * The challenge to solve when a request answers 403 `captcha_required`: load
+ * `script_url`, solve with `site_key` and `action`, and resend the request
+ * with the token in the `token_header` header.
+ */
+export declare const captchaConfigSchema: z.ZodObject<{
+    provider: z.ZodString;
+    site_key: z.ZodString;
+    script_url: z.ZodString;
+    action: z.ZodString;
+    token_header: z.ZodString;
+}, z.core.$strip>;
+export type CaptchaConfig = z.infer<typeof captchaConfigSchema>;
 /**
  * What a browser needs to know about the deployment and its merchant
- * (`GET /config`): the mount's capabilities, the currency registry and the
- * merchant's payment setup (null when the request resolves no merchant).
+ * (`GET /config`): the mount's capabilities, the currency registry, the
+ * 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>;
@@ -802,16 +1041,20 @@ 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;
+        script_url: z.ZodString;
+        action: z.ZodString;
+        token_header: z.ZodString;
+    }, 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>;
@@ -833,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;