@openrails/billing-ui 0.248.1 → 0.250.0

package/dist/appearance.d.ts

@@ -1,6 +1,6 @@
 import { CSSProperties } from 'react';
-export type CheckoutTheme = "light" | "dark" | "auto" | "inherit";
-export interface CheckoutVariables {
+export type BillingTheme = "light" | "dark" | "auto" | "inherit";
+export interface BillingVariables {
     background?: string;
     foreground?: string;
     card?: string;
@@ -15,9 +15,9 @@ export interface CheckoutVariables {
     radius?: string;
     fontFamily?: string;
 }
-export interface CheckoutAppearance {
-    theme?: CheckoutTheme;
-    variables?: CheckoutVariables;
+export interface BillingAppearance {
+    theme?: BillingTheme;
+    variables?: BillingVariables;
 }
-export declare function appearanceStyle(appearance: CheckoutAppearance | undefined, namespace?: "orck" | "orba"): CSSProperties | undefined;
-export declare function appearanceTheme(appearance: CheckoutAppearance | undefined): CheckoutTheme;
+export declare function appearanceStyle(appearance: BillingAppearance | undefined, namespace?: "orck" | "orba"): CSSProperties | undefined;
+export declare function appearanceTheme(appearance: BillingAppearance | undefined): BillingTheme;

package/dist/buy-button.d.ts

@@ -1,14 +1,14 @@
-import { CheckoutAppearance } from './appearance';
-import { Order } from './client/types';
+import { BillingAppearance } from './appearance';
+import { Order, Price } from './client/types';
 import * as React from "react";
 export interface BuyButtonProps {
-    /** The id of the merchant that sells the product. */
-    merchant: string;
-    /** The product's catalog key. */
-    product: string;
-    /** The price's key within the product. */
-    price: string;
-    /** The button's text; by default the price's amount and terms, from the catalog. */
+    /**
+     * The price to buy, from a product the host's server put in its page (the
+     * Go Client's ListProducts, its prices as a buyer sees them:
+     * `billing.BuyerPrices`). The browser never reads the catalog.
+     */
+    price: Price;
+    /** The button's text; by default the price's amount and terms. */
     label?: string;
     /**
      * A customer-chosen deposit, in the price currency's native units, for a
@@ -23,20 +23,14 @@ export interface BuyButtonProps {
      */
     onPaid: (order: Order) => void;
     /**
-     * Buying needs a signed-in customer: called instead of the checkout when
+     * Buying needs a signed-in customer: called instead of paying when
      * `signedIn` is false or OpenRails answers 401.
      */
     onSignInRequired: () => void;
     /** false when the host knows the visitor is signed out. */
     signedIn?: boolean;
-    appearance?: CheckoutAppearance;
+    appearance?: BillingAppearance;
     className?: string;
 }
-export declare function BuyButton({ merchant, product, price: priceKey, ...props }: BuyButtonProps): React.JSX.Element;
-export type PurchaseProps = Omit<BuyButtonProps, "merchant" | "product" | "price"> & {
-    /** The price to buy; the button waits while it is unknown. */
-    priceId?: string;
-    label: string;
-};
 /** One price's button and its order. Requires `BillingProvider`. */
-export declare function Purchase({ priceId, label, amount, returnUrl, onPaid, onSignInRequired, signedIn, appearance, className, }: PurchaseProps): React.JSX.Element;
+export declare function BuyButton({ price, label, amount, returnUrl, onPaid, onSignInRequired, signedIn, appearance, className, }: BuyButtonProps): React.JSX.Element;

package/dist/cart.d.ts

@@ -1,4 +1,4 @@
-import { CheckoutAppearance } from './appearance';
+import { BillingAppearance } from './appearance';
 import { BillingClient } from './client/client';
 import { Order } from './client/types';
 import * as React from "react";
@@ -6,12 +6,12 @@ export interface CartProps {
     /** The client to read and buy through; default: the provider's. */
     client?: BillingClient;
     /**
-     * The order made from the cart. Default: pay it here with OrderCheckout.
+     * The order made from the cart. Default: pay it here with OrderPayment.
      */
     onOrder?: (order: Order) => void;
-    /** Passed to OrderCheckout: the order is complete, or processing. */
+    /** Passed to OrderPayment: the order is complete, or processing. */
     onSettled?: (order: Order) => void;
-    appearance?: CheckoutAppearance;
+    appearance?: BillingAppearance;
     className?: string;
 }
 /** The customer's cart. Requires `BillingProvider`. */

package/dist/client/client.d.ts

@@ -1,5 +1,6 @@
 import { BillingError } from './errors';
-import { Account, CustomerConfig, CustomerEntitlement, CustomerLink, LowBalanceLine, NetworkLinkChallenge, PublicConfig, CurrencyScales, ListPage, NewCard, CardCaptureReference, NextAction, Cart, Order, OrderPaymentInput, Page, Payment, PaymentMethod, Product, Subscription, SubscriptionChange, SubscriptionChangePreview, Usage } from './types';
+import { Account, CustomerConfig, CustomerEntitlement, CustomerLink, LowBalanceLine, NetworkLinkChallenge, PublicConfig, CurrencyScales, ListPage, NewCard, CardCaptureReference, NextAction, Cart, Order, OrderPaymentInput, Payment, PaymentMethod, Subscription, SubscriptionChange, SubscriptionChangePreview, Usage } from './types';
+import type * as wire from "./generated/wire";
 export interface BillingClientOptions {
     /** OpenRails embedded mount. Default "/billing/v1". */
     baseUrl?: string;
@@ -10,8 +11,8 @@ export interface BillingClientOptions {
     fetch?: (input: string, init: RequestInit) => Promise<Response>;
     /**
      * The customer's access token, sent as the bearer of every request but
-     * the two public reads (`getConfig`, `listProducts`); omit when `fetch`
-     * authenticates. A `tokenSource` keeps it fresh: a call answered 401
+     * the public read (`getConfig`); omit when `fetch` authenticates. A
+     * `tokenSource` keeps it fresh: a call answered 401
      * `credential_expired` is then retried once with a new token.
      */
     getToken?: () => string | null | undefined | Promise<string | null | undefined>;
@@ -23,15 +24,6 @@ export interface BillingClientOptions {
      */
     currencies?: CurrencyScales;
 }
-/**
- * A public catalog lookup: the products of `merchant` (its id) named by
- * `keys` (at most 100 product keys), in one page.
- */
-export interface ProductListOptions {
-    merchant: string;
-    keys: string[];
-    signal?: AbortSignal;
-}
 export interface ListOptions {
     limit?: number;
     offset?: number;
@@ -161,7 +153,12 @@ export declare function createBillingClient(options?: BillingClientOptions): {
     /**
      * Creates an order from `lines` or the cart (`cart: true`), and with
      * `payment` pays it in the same call; `expectedTotal` is the total the
-     * customer saw. A failed payment resolves as payOrder's does.
+     * customer saw; `idempotencyKey`, required with `payment`, names the
+     * payment attempt. A failed payment resolves as payOrder's does. Without
+     * `payment` the customer's open order of the same lines is answered when
+     * there is one. With `payUrl` the order answers its embedded pay URL,
+     * `order.pay_url` on the payment origin, for `<EmbeddedPayment>`, fresh
+     * on every answer: the merchant's own signed-in person only.
      */
     createOrder(input: {
         lines?: {
@@ -173,7 +170,8 @@ export declare function createBillingClient(options?: BillingClientOptions): {
         expectedTotal?: string;
         payment?: OrderPaymentInput;
         reusable?: boolean;
-        idempotencyKey: string;
+        payUrl?: wire.MyOrderPayURLParams;
+        idempotencyKey?: string;
     }): Promise<OrderResult>;
     /**
      * The customer's orders, newest first: `origin: "usage"` their usage
@@ -257,12 +255,6 @@ export declare function createBillingClient(options?: BillingClientOptions): {
      * first. Pass the answer's `next_cursor` as `cursor` for the next page.
      */
     getUsage(opts: UsageOptions): Promise<Usage>;
-    /**
-     * The products `merchant` has on sale named by `keys`, each with its
-     * current prices: a public read, the same signed in or out. No keys
-     * name no products: nothing is fetched.
-     */
-    listProducts(opts: ProductListOptions): Promise<Page<Product>>;
     /**
      * A challenge to link the customer to an openrails.dev account: its
      * `nonce` goes in the network sign-in's authorization request.

package/dist/client/generated/error-codes.d.ts

@@ -1,4 +1,4 @@
-export type OpenRailsErrorCode = "admission_captured" | "admission_not_found" | "already_owned" | "application_required" | "as_of_required" | "authentication_required" | "authentication_unavailable" | "authorization_unavailable" | "billing_archive_integrity" | "billing_archive_invalid_artifact" | "billing_archive_merchant_mismatch" | "billing_archive_not_empty" | "billing_archive_unavailable" | "billing_archive_unsupported_state" | "billing_policy_not_found" | "cancel_unsupported_on_rail" | "captcha_invalid" | "captcha_required" | "card_attempts_blocked" | "card_declined" | "card_not_saved" | "card_requires_https" | "catalog_benefit_overlap" | "catalog_revision_conflict" | "checkout_attempt_closed" | "checkout_attempt_expired" | "checkout_attempts_exhausted" | "checkout_embed_origins_required" | "checkout_expired" | "checkout_not_found" | "credential_expired" | "credential_revoked" | "credit_grant_held" | "credit_grant_not_found" | "credit_grant_unavailable" | "csrf_origin_denied" | "currency_unsupported" | "custodian_capture_unavailable" | "customer_action_required" | "customer_email_required" | "customer_issuer_mismatch" | "customer_not_found" | "customer_payment_unsupported" | "customer_session_required" | "dashboard_invalid" | "database_busy" | "default_payment_method_invalid" | "default_payment_method_required" | "default_rate_card_not_found" | "destructive_actions_held" | "finding_action_failed" | "finding_not_actionable" | "finding_requires_merchant_config" | "hold_not_found" | "host_event_not_found" | "host_principal_invalid" | "hosted_checkout_unavailable" | "idempotency_key_in_use" | "idempotency_key_required" | "idempotency_key_reused" | "insufficient_credits" | "insufficient_funds" | "internal_error" | "invalid_cursor" | "invalid_customer_id" | "invalid_host_event_request" | "invalid_param" | "invalid_payment_method" | "invalid_psp_reference" | "invalid_query" | "invalid_request_body" | "invalid_settlement_status_request" | "invoker_scoped_principal" | "merchant_config_read_only" | "merchant_mismatch" | "merchant_unresolved" | "meter_in_use" | "meter_rate_card_conflict" | "method_not_allowed" | "metrics_query_invalid" | "model_unavailable" | "network_account_linked" | "network_link_challenge_invalid" | "network_link_conflict" | "network_link_in_use" | "network_terms_required" | "order_action_not_allowed" | "order_has_recurring_line" | "order_line_unavailable" | "order_not_cancelable" | "order_not_payable" | "order_payment_in_progress" | "order_total_changed" | "payment_duplicate_refused" | "payment_exceeds_due" | "payment_failed" | "payment_idempotency_conflict" | "payment_in_progress" | "payment_method_delete_failed" | "payment_method_delete_unsupported" | "payment_method_not_psp_vaulted" | "payment_method_not_usable" | "payment_method_psp_mismatch" | "payment_method_required" | "payment_method_same_vault" | "payment_method_stale" | "payment_method_update_failed" | "payment_method_update_unsupported" | "payment_not_found" | "payment_not_refundable" | "payment_not_retryable" | "payment_option_unavailable" | "payment_provider_rejected" | "permission_required" | "price_change_currency_mismatch" | "price_change_target_archived" | "price_increase_notice_too_short" | "price_key_cadence_conflict" | "price_key_not_found" | "price_migration_not_found" | "price_not_found" | "price_not_sellable" | "product_in_use" | "product_not_found" | "product_tier_group_conflict" | "product_tier_group_in_use" | "provider_cancel_held" | "provider_outcome_unknown" | "provider_writes_held" | "psp_claim_requires_proof" | "psp_credentials_rejected" | "psp_exists" | "psp_key_taken" | "psp_last_active" | "psp_not_found" | "purchase_review_resolved" | "quantity_not_allowed" | "rate_card_product_not_found" | "rate_limit_exceeded" | "rebill_terms_committed" | "refund_failed" | "refund_rail_unavailable" | "refund_unsupported" | "request_body_too_large" | "resource_access_denied" | "resource_conflict" | "resource_not_found" | "revision_mismatch" | "route_not_found" | "running_charge_not_found" | "scheduled_change_exists" | "service_credential_customer_scope_denied" | "service_unavailable" | "solana_rpc_unavailable" | "solana_transaction_refused" | "step_up_required" | "step_up_unavailable" | "stored_credential_required" | "subscription_change_already_scheduled" | "subscription_change_cadence_unsupported" | "subscription_change_credit_exceeds_price" | "subscription_change_cycle_unknown" | "subscription_change_idempotency_conflict" | "subscription_change_idempotency_key_required" | "subscription_change_in_flight" | "subscription_change_period_unknown" | "subscription_change_provider_conflict" | "subscription_change_refused" | "subscription_change_renewal_due" | "subscription_change_requires_linked_plan" | "subscription_change_target_inactive" | "subscription_change_unsupported_on_rail" | "subscription_not_active" | "subscription_not_found" | "subscription_paid_through" | "subscription_resumable" | "trial_unsupported_on_rail" | "unknown_field" | "unsupported_media_type" | "usage_meter_invalid" | "usage_meter_not_found" | "usage_not_priced" | "usage_rate_card_invalid" | "webhook_account_mismatch" | "webhook_invalid";
+export type OpenRailsErrorCode = "admission_captured" | "admission_not_found" | "already_owned" | "application_required" | "as_of_required" | "authentication_required" | "authentication_unavailable" | "authorization_unavailable" | "billing_archive_integrity" | "billing_archive_invalid_artifact" | "billing_archive_merchant_mismatch" | "billing_archive_not_empty" | "billing_archive_platform_cards" | "billing_archive_unavailable" | "billing_archive_unsupported_state" | "billing_policy_not_found" | "cancel_unsupported_on_rail" | "captcha_invalid" | "captcha_required" | "card_attempts_blocked" | "card_custody_reserved" | "card_declined" | "card_not_saved" | "card_requires_https" | "catalog_benefit_overlap" | "catalog_revision_conflict" | "credential_expired" | "credential_revoked" | "credit_grant_held" | "credit_grant_not_found" | "credit_grant_unavailable" | "csrf_origin_denied" | "currency_unsupported" | "custodian_capture_unavailable" | "customer_action_required" | "customer_email_required" | "customer_issuer_mismatch" | "customer_not_found" | "customer_payment_unsupported" | "customer_session_required" | "dashboard_invalid" | "database_busy" | "default_payment_method_invalid" | "default_payment_method_required" | "default_rate_card_not_found" | "destructive_actions_held" | "embed_origins_required" | "entitlement_required" | "finding_action_failed" | "finding_not_actionable" | "finding_requires_merchant_config" | "hold_not_found" | "host_event_not_found" | "host_principal_invalid" | "idempotency_key_in_use" | "idempotency_key_required" | "idempotency_key_reused" | "insufficient_credits" | "insufficient_funds" | "internal_error" | "invalid_cursor" | "invalid_customer_id" | "invalid_host_event_request" | "invalid_param" | "invalid_payment_method" | "invalid_psp_reference" | "invalid_query" | "invalid_request_body" | "invalid_settlement_status_request" | "invoker_scoped_principal" | "merchant_config_read_only" | "merchant_mismatch" | "merchant_unresolved" | "meter_in_use" | "meter_rate_card_conflict" | "method_not_allowed" | "metrics_query_invalid" | "model_unavailable" | "network_account_linked" | "network_link_challenge_invalid" | "network_link_conflict" | "network_link_in_use" | "network_terms_required" | "order_action_not_allowed" | "order_attempt_closed" | "order_attempt_expired" | "order_has_recurring_line" | "order_line_unavailable" | "order_not_cancelable" | "order_not_payable" | "order_payment_in_progress" | "order_total_changed" | "pay_url_attempts_exhausted" | "pay_url_expired" | "pay_url_not_found" | "pay_url_unavailable" | "payment_duplicate_refused" | "payment_exceeds_due" | "payment_failed" | "payment_idempotency_conflict" | "payment_in_progress" | "payment_method_delete_failed" | "payment_method_delete_unsupported" | "payment_method_not_psp_vaulted" | "payment_method_not_usable" | "payment_method_psp_mismatch" | "payment_method_required" | "payment_method_same_vault" | "payment_method_stale" | "payment_method_update_failed" | "payment_method_update_unsupported" | "payment_not_found" | "payment_not_refundable" | "payment_not_retryable" | "payment_option_unavailable" | "payment_provider_rejected" | "permission_required" | "platform_vault_unavailable" | "platform_vault_unreachable" | "price_change_currency_mismatch" | "price_change_target_archived" | "price_increase_notice_too_short" | "price_key_cadence_conflict" | "price_key_not_found" | "price_migration_not_found" | "price_not_found" | "price_not_sellable" | "product_in_use" | "product_not_found" | "product_tier_group_conflict" | "product_tier_group_in_use" | "provider_cancel_held" | "provider_outcome_unknown" | "provider_writes_held" | "psp_claim_requires_proof" | "psp_credentials_rejected" | "psp_exists" | "psp_key_taken" | "psp_last_active" | "psp_not_found" | "purchase_review_resolved" | "quantity_not_allowed" | "rate_card_product_not_found" | "rate_limit_exceeded" | "rebill_terms_committed" | "refund_failed" | "refund_rail_unavailable" | "refund_unsupported" | "request_body_too_large" | "resource_access_denied" | "resource_conflict" | "resource_not_found" | "revision_mismatch" | "route_not_found" | "running_charge_not_found" | "scheduled_change_exists" | "service_credential_customer_scope_denied" | "service_unavailable" | "solana_rpc_unavailable" | "solana_transaction_refused" | "step_up_required" | "step_up_unavailable" | "stored_credential_required" | "subscription_change_already_scheduled" | "subscription_change_cadence_unsupported" | "subscription_change_credit_exceeds_price" | "subscription_change_cycle_unknown" | "subscription_change_idempotency_conflict" | "subscription_change_idempotency_key_required" | "subscription_change_in_flight" | "subscription_change_period_unknown" | "subscription_change_provider_conflict" | "subscription_change_refused" | "subscription_change_renewal_due" | "subscription_change_requires_linked_plan" | "subscription_change_target_inactive" | "subscription_change_unsupported_on_rail" | "subscription_not_active" | "subscription_not_found" | "subscription_paid_through" | "subscription_resumable" | "trial_unsupported_on_rail" | "unknown_field" | "unsupported_media_type" | "usage_meter_invalid" | "usage_meter_not_found" | "usage_not_priced" | "usage_rate_card_invalid" | "webhook_account_mismatch" | "webhook_invalid";
 export type OpenRailsErrorType = "api_error" | "authentication_error" | "authorization_error" | "card_error" | "invalid_request_error" | "rate_limit_error";
 export declare const OPENRAILS_ERROR_CODES: Readonly<Record<OpenRailsErrorCode, {
     status: number;

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

@@ -98,7 +98,7 @@ export declare const OPENRAILS_ROUTES: readonly [{
         readonly 200: "Order";
         readonly 201: "Order";
     };
-    readonly errors: readonly ["already_owned", "card_attempts_blocked", "card_declined", "customer_action_required", "idempotency_key_in_use", "idempotency_key_required", "idempotency_key_reused", "invalid_param", "order_line_unavailable", "order_not_payable", "order_payment_in_progress", "order_total_changed", "payment_failed", "payment_method_stale", "payment_option_unavailable", "payment_provider_rejected", "quantity_not_allowed", "resource_conflict", "resource_not_found", "service_unavailable"];
+    readonly errors: readonly ["already_owned", "card_attempts_blocked", "card_declined", "customer_action_required", "customer_session_required", "embed_origins_required", "entitlement_required", "idempotency_key_in_use", "idempotency_key_required", "idempotency_key_reused", "invalid_param", "order_line_unavailable", "order_not_payable", "order_payment_in_progress", "order_total_changed", "pay_url_unavailable", "payment_failed", "payment_method_stale", "payment_option_unavailable", "payment_provider_rejected", "quantity_not_allowed", "resource_conflict", "resource_not_found", "service_unavailable"];
     readonly errorSets: readonly ["tier:customer", "request"];
 }, {
     readonly method: "GET";
@@ -140,7 +140,7 @@ export declare const OPENRAILS_ROUTES: readonly [{
     readonly responses: {
         readonly 200: "Order";
     };
-    readonly errors: readonly ["card_attempts_blocked", "card_declined", "customer_action_required", "idempotency_key_in_use", "idempotency_key_required", "idempotency_key_reused", "invalid_param", "order_not_payable", "order_payment_in_progress", "order_total_changed", "payment_failed", "payment_method_stale", "payment_option_unavailable", "payment_provider_rejected", "resource_conflict", "resource_not_found", "service_unavailable"];
+    readonly errors: readonly ["card_attempts_blocked", "card_declined", "customer_action_required", "entitlement_required", "idempotency_key_in_use", "idempotency_key_required", "idempotency_key_reused", "invalid_param", "order_not_payable", "order_payment_in_progress", "order_total_changed", "payment_failed", "payment_method_stale", "payment_option_unavailable", "payment_provider_rejected", "resource_conflict", "resource_not_found", "service_unavailable"];
     readonly errorSets: readonly ["tier:customer", "request"];
 }, {
     readonly method: "POST";
@@ -173,7 +173,7 @@ export declare const OPENRAILS_ROUTES: readonly [{
 }, {
     readonly method: "GET";
     readonly path: "/v1/orders/{id}/solana-pay";
-    readonly group: "checkout";
+    readonly group: "payment";
     readonly auth: "public";
     readonly permission: null;
     readonly sensitive: false;
@@ -187,7 +187,7 @@ export declare const OPENRAILS_ROUTES: readonly [{
 }, {
     readonly method: "POST";
     readonly path: "/v1/orders/{id}/solana-pay";
-    readonly group: "checkout";
+    readonly group: "payment";
     readonly auth: "public";
     readonly permission: null;
     readonly sensitive: false;
@@ -231,7 +231,7 @@ export declare const OPENRAILS_ROUTES: readonly [{
         readonly 200: "Order";
         readonly 201: "Order";
     };
-    readonly errors: readonly ["already_owned", "checkout_embed_origins_required", "idempotency_key_in_use", "idempotency_key_required", "idempotency_key_reused", "invalid_param", "order_line_unavailable", "quantity_not_allowed", "resource_not_found", "service_unavailable"];
+    readonly errors: readonly ["already_owned", "embed_origins_required", "entitlement_required", "idempotency_key_in_use", "idempotency_key_required", "idempotency_key_reused", "invalid_param", "order_line_unavailable", "quantity_not_allowed", "resource_not_found", "service_unavailable"];
     readonly errorSets: readonly ["tier:application", "request"];
 }, {
     readonly method: "POST";
@@ -360,20 +360,6 @@ export declare const OPENRAILS_ROUTES: readonly [{
     };
     readonly errors: readonly ["service_unavailable"];
     readonly errorSets: readonly ["tier:customer"];
-}, {
-    readonly method: "GET";
-    readonly path: "/v1/products";
-    readonly group: "checkout";
-    readonly auth: "public";
-    readonly permission: null;
-    readonly sensitive: false;
-    readonly mountedWhen: null;
-    readonly request: null;
-    readonly responses: {
-        readonly 200: "ListPage<Product>";
-    };
-    readonly errors: readonly ["invalid_query", "resource_not_found"];
-    readonly errorSets: readonly ["tier:public", "request"];
 }, {
     readonly method: "POST";
     readonly path: "/v1/catalog/apply";
@@ -1823,7 +1809,7 @@ export declare const OPENRAILS_ROUTES: readonly [{
     readonly responses: {
         readonly 201: "PSP";
     };
-    readonly errors: readonly ["invalid_param", "psp_claim_requires_proof", "psp_credentials_rejected", "psp_exists", "psp_key_taken", "revision_mismatch", "service_unavailable"];
+    readonly errors: readonly ["invalid_param", "platform_vault_unreachable", "psp_claim_requires_proof", "psp_credentials_rejected", "psp_exists", "psp_key_taken", "revision_mismatch", "service_unavailable"];
     readonly errorSets: readonly ["tier:merchant", "request"];
 }, {
     readonly method: "GET";
@@ -1939,7 +1925,7 @@ export declare const OPENRAILS_ROUTES: readonly [{
     readonly responses: {
         readonly 200: "MerchantConfigurationState";
     };
-    readonly errors: readonly ["invalid_param", "revision_mismatch", "service_unavailable"];
+    readonly errors: readonly ["card_custody_reserved", "invalid_param", "platform_vault_unavailable", "platform_vault_unreachable", "resource_conflict", "revision_mismatch", "service_unavailable"];
     readonly errorSets: readonly ["tier:merchant", "request"];
 }, {
     readonly method: "GET";
@@ -2024,7 +2010,7 @@ export declare const OPENRAILS_ROUTES: readonly [{
     readonly responses: {
         readonly 200: "application/x-ndjson";
     };
-    readonly errors: readonly ["billing_archive_unavailable", "billing_archive_unsupported_state"];
+    readonly errors: readonly ["billing_archive_platform_cards", "billing_archive_unavailable", "billing_archive_unsupported_state"];
     readonly errorSets: readonly ["tier:merchant"];
 }, {
     readonly method: "POST";
@@ -2041,7 +2027,7 @@ export declare const OPENRAILS_ROUTES: readonly [{
     readonly responses: {
         readonly 200: "BillingArchiveImport";
     };
-    readonly errors: readonly ["billing_archive_integrity", "billing_archive_invalid_artifact", "billing_archive_merchant_mismatch", "billing_archive_not_empty", "billing_archive_unavailable", "billing_archive_unsupported_state", "request_body_too_large"];
+    readonly errors: readonly ["billing_archive_integrity", "billing_archive_invalid_artifact", "billing_archive_merchant_mismatch", "billing_archive_not_empty", "billing_archive_platform_cards", "billing_archive_unavailable", "billing_archive_unsupported_state", "request_body_too_large"];
     readonly errorSets: readonly ["tier:merchant", "request"];
 }, {
     readonly method: "POST";
@@ -2607,7 +2593,7 @@ export declare const OPENRAILS_ROUTES: readonly [{
     readonly responses: {
         readonly 200: "Order";
     };
-    readonly errors: readonly ["card_attempts_blocked", "card_declined", "customer_action_required", "idempotency_key_in_use", "idempotency_key_required", "idempotency_key_reused", "invalid_param", "order_not_payable", "order_payment_in_progress", "order_total_changed", "payment_failed", "payment_method_stale", "payment_option_unavailable", "payment_provider_rejected", "resource_conflict", "resource_not_found", "service_unavailable"];
+    readonly errors: readonly ["card_attempts_blocked", "card_declined", "customer_action_required", "entitlement_required", "idempotency_key_in_use", "idempotency_key_required", "idempotency_key_reused", "invalid_param", "order_not_payable", "order_payment_in_progress", "order_total_changed", "payment_failed", "payment_method_stale", "payment_option_unavailable", "payment_provider_rejected", "resource_conflict", "resource_not_found", "service_unavailable"];
     readonly errorSets: readonly ["tier:network", "request"];
 }, {
     readonly method: "POST";

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

@@ -145,6 +145,7 @@ export type ApplyProduct = {
     archived?: boolean | null;
     ownership?: "consumable" | "extend" | "unique" | null;
     entitlements?: string[];
+    required_entitlements?: string[];
     credit_grant?: CreditGrantSpec | null;
     prices?: Record<string, ApplyPrice>;
     rate_cards?: RateCard[] | null;
@@ -407,17 +408,6 @@ export type CheckEntitlementsParams = {
     prefix_limit?: number;
     at?: string;
 };
-export type CheckoutRoutingMatch = {
-    currency?: string;
-    product?: string;
-    price?: string;
-    mode?: string;
-    country?: string;
-};
-export type CheckoutRoutingRule = {
-    match?: CheckoutRoutingMatch;
-    prefer: string[];
-};
 export type ClearDestructiveHoldParams = {
     reason?: string;
 };
@@ -455,6 +445,7 @@ export type CreateMyOrderParams = {
     expected_total?: string;
     payment?: OrderPaymentParams;
     reusable?: boolean;
+    pay_url?: MyOrderPayURLParams;
 };
 export type CreateNetworkLinkParams = {
     challenge_id?: string;
@@ -464,7 +455,7 @@ export type CreateOrderParams = {
     customer_id?: string;
     lines?: OrderLineParams[];
     expires_at?: string;
-    checkout?: OrderCheckoutParams;
+    pay_url?: OrderPayURLParams;
 };
 export type CreatePSPParams = {
     key?: string;
@@ -531,6 +522,7 @@ export type CreateProductParams = {
     display_name?: string;
     description?: string;
     entitlements?: string[];
+    required_entitlements?: string[];
     credit_grant?: CreditGrantSpec;
     tier_group?: string;
     tier_rank?: number;
@@ -638,7 +630,7 @@ export type CustomerLink = {
     merchant_id: string;
     customer_id: string;
     account_id: string;
-    method: "checkout" | "connect" | "sign_in";
+    method: "connect" | "payment_page" | "sign_in";
     status: "active" | "revoked";
     linked_at: string;
     revoked_at: string | null;
@@ -647,12 +639,12 @@ export type CustomerLink = {
 export type CustomerNetwork = {
     account_id: string;
     linked_at: string;
-    method: "checkout" | "connect" | "sign_in";
+    method: "connect" | "payment_page" | "sign_in";
 };
 export type CustomerNetworkHostEvent = {
     customer_id: string;
     account_id: string;
-    method: "checkout" | "connect" | "sign_in" | null;
+    method: "connect" | "payment_page" | "sign_in" | null;
     revoked_by: "account_deleted" | "customer" | "merchant_left" | null;
 };
 export type CustomerSettings = {
@@ -699,10 +691,18 @@ export type DeclaredBilling = {
     subscriptions?: DeclaredSubscription[];
     transactions?: DeclaredTransaction[];
     admin_grants?: DeclaredAdminGrant[];
+    purchases?: DeclaredPurchase[];
 };
 export type DeclaredCustomer = {
     customer?: string;
 };
+export type DeclaredOrderLine = {
+    price?: string;
+    quantity?: number;
+    unit_amount?: string;
+    description?: string;
+    access_ends_at?: string;
+};
 export type DeclaredPaymentMethod = {
     customer?: string;
     rail?: string;
@@ -722,6 +722,25 @@ export type DeclaredProviderSchedule = {
     interval_months?: number;
     first_due_at?: string;
 };
+export type DeclaredPurchase = {
+    source_id?: string;
+    customer?: string;
+    rail?: string;
+    psp?: PSPRef;
+    transaction_id?: string;
+    currency?: string;
+    amount?: string;
+    paid_at?: string;
+    lines?: DeclaredOrderLine[];
+    settlement?: DeclaredSettlement;
+    evidence?: unknown;
+};
+export type DeclaredSettlement = {
+    asset?: string;
+    quantity?: string;
+    payer?: string;
+    recipient?: string;
+};
 export type DeclaredStripeInvoice = {
     id?: string;
     customer_reference?: string;
@@ -999,13 +1018,14 @@ export type MatrixCell = {
     unit_amount: string;
     maximum_amount?: string;
 };
-export type MerchantCheckoutSettings = {
-    embed_origins?: string[];
-};
 export type MerchantConfigurationState = {
     revision: number;
     display_name: string;
     settings: MerchantSettings;
+    platform_vault: PlatformVaultState;
+};
+export type MerchantPaymentPageSettings = {
+    embed_origins?: string[];
 };
 export type MerchantProfile = {
     logo_url?: string;
@@ -1024,10 +1044,11 @@ export type MerchantSettings = {
     provider_refund_access?: string;
     arrears_grace_days?: number;
     arrears_delinquency_floor?: string;
-    checkout_routing?: CheckoutRoutingRule[];
+    psp_routing?: PSPRoutingRule[];
     dunning_policy?: DunningPolicy;
-    checkout?: MerchantCheckoutSettings;
+    payment_page?: MerchantPaymentPageSettings;
     balance_notices?: BalanceNoticeSettings;
+    card_custody?: "hosted" | "merchant" | "platform";
     billing_policies?: BillingPolicy[];
     billing_policy_bindings?: BillingPolicyBinding[];
     delegated_invoker_wasted_spend_limits?: BudgetWindow[];
@@ -1131,6 +1152,9 @@ export type MetricsSchema = {
     limits: MetricsLimits;
     query_shape: string;
 };
+export type MyOrderPayURLParams = {
+    embedded?: boolean;
+};
 export type NetworkLink = {
     link: CustomerLink;
     merchant: PublicMerchant;
@@ -1189,7 +1213,12 @@ export type Order = {
     lines: OrderLine[];
     payment: OrderPayment;
     payment_options: OrderPaymentOption[];
-    checkout: OrderCheckout | null;
+    pay_url: string | null;
+    pay_url_expires_at: string | null;
+    embedded: boolean;
+    success_url: string | null;
+    cancel_url: string | null;
+    saved_payment_methods: boolean;
     renewal: OrderRenewal | null;
     usage: OrderUsage | null;
     expires_at: string | null;
@@ -1200,21 +1229,6 @@ export type Order = {
     uncollectible_at: string | null;
     created_at: string;
 };
-export type OrderCheckout = {
-    url: string | null;
-    ui_mode: "embedded" | "hosted";
-    expires_at: string;
-    success_url: string;
-    cancel_url: string | null;
-    saved_payment_methods: boolean;
-};
-export type OrderCheckoutParams = {
-    ui_mode?: "embedded" | "hosted";
-    success_url?: string;
-    cancel_url?: string;
-    expires_at?: string;
-    saved_payment_methods?: boolean;
-};
 export type OrderHostEvent = {
     order_id: string;
     customer_id: string;
@@ -1250,6 +1264,14 @@ export type OrderLineRefusal = {
     message: string;
     owned_by: string | null;
     hint: string | null;
+    missing?: string[];
+};
+export type OrderPayURLParams = {
+    embedded?: boolean;
+    success_url?: string;
+    cancel_url?: string;
+    expires_at?: string;
+    saved_payment_methods?: boolean;
 };
 export type OrderPayment = {
     status: "processing" | "requires_action" | "requires_payment_method" | "succeeded";
@@ -1350,7 +1372,7 @@ export type PSPPaymentConfig = {
     custodian: string;
     display_name: string;
     flow: string;
-    checkout: boolean;
+    routed: boolean;
     config?: Record<string, string>;
     status?: string;
     retry_after?: number;
@@ -1368,6 +1390,13 @@ export type PSPRoutingCandidate = {
     rail: "ccbill" | "nmi" | "solana" | "stripe";
     skip: string | null;
 };
+export type PSPRoutingMatch = {
+    currency?: string;
+    product?: string;
+    price?: string;
+    mode?: string;
+    country?: string;
+};
 export type PSPRoutingPreview = {
     policy: string;
     rule: number | null;
@@ -1376,6 +1405,10 @@ export type PSPRoutingPreview = {
     mode: string | null;
     candidates: PSPRoutingCandidate[];
 };
+export type PSPRoutingRule = {
+    match?: PSPRoutingMatch;
+    prefer: string[];
+};
 export type PackagePrice = {
     amount?: string;
     package_size?: number;
@@ -1513,6 +1546,9 @@ export type PerUnitPrice = {
     maximum_amount?: string;
     matrix?: Matrix;
 };
+export type PlatformVaultState = {
+    available: boolean;
+};
 export type PreviewMyOrderParams = {
     lines?: OrderLineParams[];
     cart?: boolean;
@@ -1616,6 +1652,7 @@ export type Product = {
     display_name: string;
     description: string;
     entitlements: string[];
+    required_entitlements: string[];
     credit_grant?: CreditGrantSpec;
     tier_group: string | null;
     tier_rank: number;
@@ -2016,6 +2053,7 @@ export type UpdateProductParams = {
     display_name?: string | null;
     description?: string | null;
     entitlements?: string[];
+    required_entitlements?: string[];
     credit_grant?: CreditGrantSpec | null;
     tier_group?: string | null;
     tier_rank?: number | null;

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 ListOptions, type OrderResult, type ProductListOptions, type SendSolanaTransaction, type SubscriptionChangeInput, type UsageOptions, } 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 SendSolanaTransaction, type SubscriptionChangeInput, type UsageOptions, } from './client';
 export { redeemAssertion, tokenSource, type RedeemAssertionOptions, type TokenResponse, type TokenSource, type TokenSourceOptions, } from './token-source';
 export { BillingError, isBillingError, isServerError, readBillingError, toBillingError, type BillingErrorBody, } from './errors';
 export type { Account, Balance, CaptchaConfig, CardSummary, Cart, Currency, CurrencyScales, CustomerConfig, CustomerEntitlement, CustomerLink, PaymentConfig, PaymentFailure, PublicConfig, PublicMerchant, ListPage, LowBalanceLine, NetworkLinkChallenge, NewCard, CardCaptureReference, NextAction, Order, OrderLine, OrderLineRefusal, OrderPaymentInput, OrderPreviewLine, Page, Payment, PaymentMethod, PaymentRecovery, Price, Product, Subscription, SubscriptionDunning, SubscriptionProduct, SubscriptionStatus, SubscriptionChange, SubscriptionChangePreview, Usage, UsageRow, } from './types';