@openrails/billing-ui 0.236.0 → 0.237.0

package/CHANGELOG.md

@@ -1,5 +1,57 @@
 # Changelog
 
+## Running charges
+
+- `Balance` gains `accrued_amount`, `accrual_rate_per_hour`, `as_of` and
+  `depletes_at`: what the customer's running charges have charged and not yet
+  posted, the rate they draw the balance at, and when it runs out.
+  `available_amount` is net of the accrual.
+
+## Orders replace checkout sessions
+
+- Breaking: `<BuyButton>` and `<Offers>` create the customer's order and pay
+  it in `<OrderCheckout>`; `onPaid` receives the completed `Order`.
+  `returnUrl` replaces `successUrl`, and `autoRenew` is gone.
+- Breaking: `<CheckoutPage>`, `<CheckoutFrame>` and the shared payment page
+  are removed with checkout sessions; so are `CheckoutLayout`,
+  `CheckoutFrameTheme`, `CheckoutSession`, `CheckoutSessionStatus`,
+  `CheckoutPlan`, `CheckoutLineItem`, `CheckoutPhase`, `PaymentOption`,
+  `PayRequest`, `PayResult`, their schemas, `amountSchema`,
+  `unitDecimalsSchema`, `isCardRail`, `savedMethodsFor` and the client's
+  `CheckoutSessionLink`. `NextAction` and `PaymentFailure` are the order's,
+  from `@openrails/billing-ui/client`.
+- A page that paid a server-minted session pays the server's order instead:
+  the Go `Client.CreateOrder` creates it, and `<OrderCheckout orderId>` pays
+  it, a subscription line included.
+- `SavedPaymentMethod` names its `psp_id` (was `option_id`).
+
+## Usage orders
+
+- Breaking: `listInvoices`, `getInvoice` and `Invoice` are removed. Usage
+  billed in arrears is an order (`origin: usage`): `listOrders({ origin:
+  "usage" })` lists them, and `<OrderCheckout>` pays one with a saved card.
+- `Order` gains `usage` (its period, `due_at`, `amount_paid`, `amount_due`,
+  collection and `delinquent`) and `uncollectible_at`; `status` may be
+  `uncollectible`. A usage line names its `source`; its `price_id` and
+  `product_id` are null.
+- `Order.checkout.expires_at` is read again.
+
+## Embedded checkout
+
+- `<EmbeddedCheckout url onComplete?>` frames a merchant order's embedded
+  checkout (`checkout.ui_mode: embedded`): it follows the page's height and
+  hears its completion only from its own frame on the checkout host's origin;
+  without `onComplete` it goes to the checkout's `success_url`.
+- `Order.checkout.ui_mode`; `PublicMerchant.embed_origins`;
+  `PublicConfig.network` (the checkout page's sign-in to the customer network).
+- `createNetworkLinkChallenge()` and `createNetworkLink({challengeId, idToken})`
+  link the customer to a customer-network account.
+
+## No Solana token list
+
+- `listSolanaTokens` and `SolanaToken` are gone with `GET /v1/solana/tokens`:
+  the accepted tokens are `getConfig()`'s `payment.solana.tokens`.
+
 ## Apple Pay and Google Pay
 
 - `<OrderCheckout wallets>` offers Apple Pay and Google Pay through a Stripe

package/README.md

@@ -10,15 +10,13 @@ billing (subscriptions, saved cards, payment history).
 | `@openrails/billing-ui`           | `BillingProvider`, styled checkout and account components, i18n                    |
 | `@openrails/billing-ui/locales/*` | `en de es ja ko zh` message bundles                                                |
 
-The checkout owns the browser payment flow, behind `<BuyButton>` and
-`<Offers>`. OpenRails holds the checkout session: the signed-in customer mints
-one for a price, and its `ocs_` id alone reads and pays it. Card data is tokenized in NMI-hosted Collect.js iframes and
-never enters the host application, unless the PSP takes cards on OpenRails
-itself (`card_entry: server`, driver `card`).
+The checkout owns the browser payment flow, behind `<BuyButton>`, `<Offers>`
+and `<OrderCheckout>`: the signed-in customer's order, read and paid with
+their own credential. Card data is tokenized in the PSP's own fields
+(Collect.js, Stripe Elements) and never enters the host application.
 
-See [Payment form contract](docs/payment-form-contract.md) for the exact-money
-session document, billing fields, browser-autofill behavior, and the checkout
-request schema.
+See [Payment form contract](docs/payment-form-contract.md) for exact money,
+billing fields, browser-autofill behavior and the payment request.
 
 The package lives in the OpenRails repository and shares its version: each
 OpenRails release `vX.Y.Z` publishes `@openrails/billing-ui@X.Y.Z` to npm, with
@@ -48,13 +46,13 @@ const billing = createBillingClient({ baseUrl: "/billing/v1", fetch: auth.authFe
 key (a course, its bundle and the membership that also unlocks it; the Go
 `Client.ListOffers` finds the products granting an entitlement): a
 `BuyButton` per price ("$4.99", "Rent for 3 days, $1.99",
-"$10.00 every 30 days"). The purchase is theirs from start to payment, so the
-app never handles a checkout session: today a button opens one in a checkout
-dialog; when orders take a new card it will create an order instead,
-and apps won't change. Signing in is the host's: with `signedIn={false}`, or
-when OpenRails answers 401, they call `onSignInRequired` instead. `onPaid`
-follows a successful payment only; it is a hint, so confirm access from your
-own API (your gate) before granting anything.
+"$10.00 every 30 days"). The purchase is theirs from start to payment: a
+button creates the customer's order and pays it in a dialog
+(`<OrderCheckout>`); a second click before it is paid opens the same order.
+Signing in is the host's: with `signedIn={false}`, or when OpenRails answers
+401, they call `onSignInRequired` instead. `onPaid` receives the completed
+order; it is a hint, so confirm access from your own API (your gate) before
+granting anything.
 
 ```tsx
 <BuyButton
@@ -73,9 +71,8 @@ own API (your gate) before granting anything.
 />
 ```
 
-`successUrl` returns the buyer from a redirect step (Stripe's hosted page); it
-must be on one of your app's return origins. `autoRenew={false}` buys a
-recurring price's first term only.
+`returnUrl` returns the buyer from a redirect step (Stripe's hosted page); it
+must be on one of your app's return origins.
 
 For prepaid credits, a fixed pack is another product/price. A
 `customer_amount` price takes the buyer's `amount`: collect it on your product
@@ -98,44 +95,22 @@ payment. Fixed prices reject `amount`; their pack benefit can be greater than
 the purchase price for a bulk discount. Customer-selected deposits currently
 use NMI or Stripe.
 
-A rail's own step is the pay result's `next_action`: `redirect_to_url` (an
-https page, opened in the top window) or `solana_pay` (a `solana:` link shown
-as a QR code). A card challenge is its `operation`, authenticated in the page.
+A rail's own step is the order's `payment.next_action`: `redirect_to_url` (an
+https page, opened in the top window), `solana_pay` (a `solana:` link shown
+as a QR code) or `authenticate` (the bank's challenge, run in the page).
 
-### A shared payment page
+### An order your server creates
 
-Several sites selling for one merchant can share one payment page
-(`Config.Checkout.PageURL`). A server mints the session with the Go
-`Client.CreateCheckoutSession` and hands the browser its `url`, which the site
-frames:
+A server that decides what its customer buys creates the order with the Go
+`Client.CreateOrder` (`POST /v1/app/orders`) and hands its id to the
+customer's browser, which pays it signed in:
 
 ```tsx
-<CheckoutFrame url={session.url} theme="dark" onComplete={() => refetchAccess()} />
+<OrderCheckout orderId={orderId} returnUrl={returnUrl} onSettled={(order) => refetchAccess(order)} />
 ```
 
-Stripe Elements needs the buyer's own client, so the shared page offers token
-rails only.
-
-The payment host serves `<CheckoutPage>` from one HTML entry at `PageURL`,
-behind its adapter's `CheckoutFramePolicy` (only the sites in
-`Config.Checkout.EmbedOrigins` may frame it). No customer signs in there, so
-its `BillingProvider` has no client:
-
-```tsx
-import { BillingProvider, CheckoutPage } from "@openrails/billing-ui"
-
-createRoot(root).render(
-  <BillingProvider>
-    <CheckoutPage appearance={{ variables: brand }} />
-  </BillingProvider>
-)
-```
-
-The page reads the session id from its URL fragment and talks to its frame
-with `postMessage`, origin-checked both ways: page to app `ready`,
-`resize {height}`, `complete {status}` and `redirect {url}` (a nested frame
-cannot navigate the top window, so the app does); app to page
-`init {theme}`. The page messages only the app origin recorded on its session.
+`onSettled` follows a complete order, or one processing on an asynchronous
+rail. A subscription line names its subscription once paid.
 
 ## Account billing
 
@@ -175,8 +150,8 @@ for host components.
 ## Catalog and plan changes
 
 The client also reads the public catalog and changes a subscription's plan.
-The catalog and Solana reads are public routes, served only when the host
-mounts OpenRails' checkout routes; `GET /config` is always served.
+The catalog read is a public route, served only when the host mounts
+OpenRails' checkout routes; `GET /config` is always served.
 
 | Call                                                                                                | Route                                                           |
 | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
@@ -184,7 +159,6 @@ mounts OpenRails' checkout routes; `GET /config` is always served.
 | `getConfig()` (capabilities, `currencies`, `payment` with PSPs, `solana.network` and tokens; `client.currencies` is the pinned registry) | `GET /config` |
 | `previewSubscriptionChange(id, { priceId?, quantity? })`                                            | `POST /me/subscriptions/{id}/change/preview`                    |
 | `changeSubscription(id, { priceId?, quantity?, idempotencyKey, signature? })`                       | `POST /me/subscriptions/{id}/change`                            |
-| `listSolanaTokens({ priceId, wallet })`                                                             | `GET /solana/tokens`                                            |
 
 ```ts
 const preview = await billing.previewSubscriptionChange(sub.id, { quantity: 5 }) // amount_due_now, effective
@@ -219,19 +193,15 @@ browser flow from each PSP's `flow` and public `config`
 (Collect.js, native card inputs, Stripe Elements, redirect, wallet). Hosts never branch on a
 provider:
 
-- A session's `options` are exactly the armed PSPs whose rail can make this
-  sale (Solana when it is configured, never CCBill),
-  each with its `driver` and `public_config`; `saved_methods` are the buyer's
-  cards on them, newest first (paying sends the chosen card's id explicitly).
-  Card rails (`collect_js`, `card`, `stripe_elements`) render one panel: saved cards,
-  an inline new card and one Pay/Subscribe button, which is the customer's
-  confirmation of the displayed terms. No provider chooser with one rail.
-- Inside a `BillingProvider` with a client, a new card is always saved to the
-  account first and the session is paid with `payment_method_id` on the
-  customer surface; `requires_action` results
-  carrying an `operation` run 3-D Secure in the page. A `failed` result stays
-  on the panel with `failure.message` next to its `field`, so the buyer can
-  pick another card; the host gives each new attempt a new idempotency key.
+- An order's `payment_options` are exactly the armed PSPs whose rail can make
+  this sale (Solana for one-time lines when it is configured, never CCBill),
+  each with what it `accepts`. `OrderCheckout` renders one panel: the
+  customer's saved cards on them, newest first, an inline new card and one Pay
+  button. No provider chooser with one rail.
+- A new card is charged and saved in one pay; an `authenticate` next action
+  runs 3-D Secure in the page, then `confirm`. A decline stays on the panel
+  with its message, so the buyer can pick another card under a new
+  idempotency key.
 - Only PSPs with `checkout !== false` (`checkoutPsps`) take new cards; others
   stay listed so existing cards and subscriptions keep working.
 - `<SavePaymentMethod psp={psp} onSaved={(id) => ...} />` saves a card in the
@@ -240,7 +210,7 @@ provider:
   `returnURL(setupId)`; confirm with `client.confirmCardSetup(id)`.
 - `authenticatePayment(client, operationId, psp)` completes a pending
   payment's 3-D Secure challenge when `canAuthenticatePayment(psp)`.
-- `defaultCountry` (CheckoutPage, SavePaymentMethod, AccountBilling)
+- `defaultCountry` (SavePaymentMethod, AccountBilling)
   preselects the billing country, else the browser locale's region.
 
 - Panels: `SubscriptionsPanel` (cancel, resume, change card),

package/dist/account/account-billing.d.ts

@@ -4,7 +4,7 @@ import { SubscriptionsPanelProps } from './subscriptions-panel';
 export interface AccountBillingProps {
     /**
      * Offers to make a card the default for this currency: it pays the
-     * currency's invoices and every subscription in it without its own card.
+     * currency's usage orders and every subscription in it without its own card.
      */
     defaultCurrency?: string;
     /** Billing country to preselect when adding a card. */

package/dist/account/payment-methods-panel.d.ts

@@ -3,7 +3,7 @@ import * as React from "react";
 export interface PaymentMethodsPanelProps {
     /**
      * Offers to make a card the default for this currency: it pays the
-     * currency's invoices and every subscription in it without its own card.
+     * currency's usage orders and every subscription in it without its own card.
      */
     defaultCurrency?: string;
     /** Billing country to preselect when adding a card. */

package/dist/buy-button.d.ts

@@ -1,5 +1,5 @@
 import { CheckoutAppearance } from './appearance';
-import { PayResult } from './types';
+import { Order } from './client/types';
 import * as React from "react";
 export interface BuyButtonProps {
     /** The product's catalog key. */
@@ -10,18 +10,16 @@ export interface BuyButtonProps {
     label?: string;
     /**
      * A customer-chosen deposit, in the price currency's native units, for a
-     * price with `customer_amount`; the checkout charges exactly this.
+     * price with `customer_amount`; the order charges exactly this.
      */
     amount?: string;
-    /** false buys a recurring price's first term only; default: renews. */
-    autoRenew?: boolean;
-    /** Where a redirect rail (Stripe's hosted page) returns the buyer: one of the app's return origins. */
-    successUrl?: string;
+    /** Where a redirect PSP (Stripe's hosted page) returns the buyer: one of the app's return origins. */
+    returnUrl?: string;
     /**
-     * The purchase succeeded. A hint: the host's own gate decides access, so
-     * send the buyer to the content it guards.
+     * The order is paid. A hint: the host's own gate decides access, so send
+     * the buyer to the content it guards.
      */
-    onPaid: (result: PayResult) => void;
+    onPaid: (order: Order) => void;
     /**
      * Buying needs a signed-in customer: called instead of the checkout when
      * `signedIn` is false or OpenRails answers 401.
@@ -33,3 +31,10 @@ export interface BuyButtonProps {
     className?: string;
 }
 export declare function BuyButton(props: BuyButtonProps): React.JSX.Element;
+export type PurchaseProps = Omit<BuyButtonProps, "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;

package/dist/client/client.d.ts

@@ -1,5 +1,5 @@
 import { BillingError } from './errors';
-import { Account, PublicConfig, PaymentAuthentication, CurrencyScales, Invoice, ListPage, NewCard, NextAction, Cart, Order, OrderPaymentInput, Page, Payment, PaymentMethod, Product, SolanaToken, Subscription, SubscriptionChange, SubscriptionChangePreview } from './types';
+import { Account, CustomerLink, NetworkLinkChallenge, PublicConfig, PaymentAuthentication, CurrencyScales, ListPage, NewCard, NextAction, Cart, Order, OrderPaymentInput, Page, Payment, PaymentMethod, Product, Subscription, SubscriptionChange, SubscriptionChangePreview } from './types';
 export interface BillingClientOptions {
     /** OpenRails embedded mount. Default "/billing/v1". */
     baseUrl?: string;
@@ -149,6 +149,16 @@ export declare function createBillingClient(options?: BillingClientOptions): {
         reusable?: boolean;
         idempotencyKey: string;
     }): Promise<OrderResult>;
+    /**
+     * The customer's orders, newest first: `origin: "usage"` their usage
+     * orders, `overdue` those still owed past their due date.
+     */
+    listOrders(opts?: CursorOptions & {
+        origin?: string;
+        status?: string;
+        subscriptionId?: string;
+        overdue?: boolean;
+    }): Promise<ListPage<Order>>;
     /** One of the customer's orders: the resumable handle of a purchase. */
     getOrder(orderId: string, signal?: AbortSignal): Promise<Order>;
     /**
@@ -177,7 +187,7 @@ export declare function createBillingClient(options?: BillingClientOptions): {
     removePaymentMethod(paymentMethodId: string): Promise<"removed" | "pending">;
     /**
      * Makes the card the default for one currency: it pays the currency's
-     * invoices and every subscription in it without its own card.
+     * usage orders and every subscription in it without its own card.
      */
     setDefaultPaymentMethod(input: {
         currency: string;
@@ -187,33 +197,35 @@ export declare function createBillingClient(options?: BillingClientOptions): {
     listPayments(opts?: CursorOptions & {
         rail?: string;
     }): Promise<ListPage<Payment>>;
-    listInvoices(opts?: CursorOptions): Promise<ListPage<Invoice>>;
     /**
      * The customer's summary: balance and amount owed per currency, the card
      * that pays each currency, and unread notices.
      */
     getAccount(signal?: AbortSignal): Promise<Account>;
-    getInvoice(invoiceId: string, signal?: AbortSignal): Promise<Invoice>;
     /**
      * The products on sale named by `keys`, each with its current prices.
      * 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.
+     */
+    createNetworkLinkChallenge(): Promise<NetworkLinkChallenge>;
+    /**
+     * Links the customer to the openrails.dev account whose fresh sign-in
+     * answered the challenge (its ID token).
+     */
+    createNetworkLink(params: {
+        challengeId: string;
+        idToken: string;
+    }): Promise<CustomerLink>;
     /**
      * The deployment's public configuration: what the mount serves, the
      * currency registry and the merchant's payment setup. React components
      * share one copy through `useConfig()`.
      */
     getConfig(signal?: AbortSignal): Promise<PublicConfig>;
-    /**
-     * Accepted tokens with live prices. `priceId` adds each token's `quote`;
-     * `wallet` adds its `balance`.
-     */
-    listSolanaTokens(opts?: {
-        priceId?: string;
-        wallet?: string;
-        signal?: AbortSignal;
-    }): Promise<SolanaToken[]>;
     /** Currency code (upper case) to native-unit decimals. */
     currencies: Readonly<Record<string, number>>;
 };

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

@@ -1,4 +1,4 @@
-export type OpenRailsErrorCode = "admission_captured" | "admission_not_found" | "allowance_meter_not_found" | "allowance_source_in_use" | "allowance_source_invalid" | "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_expired" | "checkout_not_found" | "checkout_offer_unavailable" | "checkout_payment_in_progress" | "checkout_request_invalid" | "checkout_session_expired" | "checkout_session_not_found" | "checkout_session_unavailable" | "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_not_found" | "customer_payment_unsupported" | "customer_proof_required" | "customer_session_required" | "dashboard_invalid" | "database_busy" | "default_payment_method_invalid" | "default_payment_method_required" | "default_rate_card_not_found" | "default_rate_card_required" | "finding_action_failed" | "finding_not_actionable" | "hold_not_found" | "host_event_not_found" | "host_principal_invalid" | "hosted_checkout_unavailable" | "idempotency_key_in_progress" | "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" | "invoice_action_not_allowed" | "invoice_not_retryable" | "invoice_retry_idempotency_conflict" | "invoice_retry_in_progress" | "invoice_retry_outcome_unknown" | "invoker_scoped_principal" | "merchant_binding_mismatch" | "merchant_config_read_only" | "merchant_directory_unavailable" | "merchant_not_found" | "merchant_selector_invalid" | "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_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_retry_required" | "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_not_found" | "product_tier_group_conflict" | "product_tier_group_in_use" | "provider_billing_observation_conflict" | "provider_cancel_held" | "provider_operation_conflict" | "provider_operation_has_billing_evidence" | "provider_operation_not_found" | "provider_operation_not_open" | "provider_operation_not_refused" | "provider_operation_refused" | "provider_outcome_unknown" | "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_currency_mismatch" | "rate_card_has_overrides" | "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" | "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_rate_card_invalid" | "webhook_account_mismatch" | "webhook_invalid" | "widget_generation_invalid";
+export type OpenRailsErrorCode = "admission_captured" | "admission_not_found" | "allowance_meter_not_found" | "allowance_source_in_use" | "allowance_source_invalid" | "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_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" | "default_rate_card_required" | "finding_action_failed" | "finding_not_actionable" | "hold_not_found" | "host_event_not_found" | "host_principal_invalid" | "hosted_checkout_unavailable" | "idempotency_key_in_progress" | "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_binding_mismatch" | "merchant_config_read_only" | "merchant_directory_unavailable" | "merchant_not_found" | "merchant_selector_invalid" | "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_not_found" | "product_tier_group_conflict" | "product_tier_group_in_use" | "provider_billing_observation_conflict" | "provider_cancel_held" | "provider_operation_conflict" | "provider_operation_has_billing_evidence" | "provider_operation_not_found" | "provider_operation_not_open" | "provider_operation_not_refused" | "provider_operation_refused" | "provider_outcome_unknown" | "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_currency_mismatch" | "rate_card_has_overrides" | "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_rate_card_invalid" | "webhook_account_mismatch" | "webhook_invalid" | "widget_generation_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

@@ -53,146 +53,6 @@ export declare const OPENRAILS_ROUTES: readonly [{
     };
     readonly errors: readonly [];
     readonly errorSets: readonly ["tier:public"];
-}, {
-    readonly method: "GET";
-    readonly path: "/v1/solana/tokens";
-    readonly group: "checkout";
-    readonly auth: "public";
-    readonly permission: null;
-    readonly sensitive: false;
-    readonly mountedWhen: "solana";
-    readonly request: null;
-    readonly responses: {
-        readonly 200: "SupportedTokensResponse";
-    };
-    readonly errors: readonly ["resource_conflict"];
-    readonly errorSets: readonly ["tier:public", "request"];
-}, {
-    readonly method: "GET";
-    readonly path: "/v1/checkout-sessions/{id}";
-    readonly group: "checkout";
-    readonly auth: "checkout_session";
-    readonly permission: null;
-    readonly sensitive: false;
-    readonly mountedWhen: null;
-    readonly request: null;
-    readonly responses: {
-        readonly 200: "CheckoutSession";
-    };
-    readonly errors: readonly ["card_attempts_blocked", "card_declined", "card_not_saved", "checkout_session_not_found", "checkout_session_unavailable", "idempotency_key_reused", "insufficient_funds", "invalid_param", "payment_method_required", "payment_method_stale", "payment_provider_rejected", "resource_access_denied", "resource_conflict", "resource_not_found", "service_unavailable", "subscription_paid_through", "subscription_resumable"];
-    readonly errorSets: readonly ["tier:checkout_session"];
-}, {
-    readonly method: "POST";
-    readonly path: "/v1/checkout-sessions/{id}/pay";
-    readonly group: "checkout";
-    readonly auth: "checkout_session";
-    readonly permission: null;
-    readonly sensitive: false;
-    readonly mountedWhen: null;
-    readonly request: "PayCheckoutSessionParams";
-    readonly responses: {
-        readonly 200: "CheckoutSessionPayResult";
-    };
-    readonly errors: readonly ["card_attempts_blocked", "card_declined", "card_not_saved", "card_requires_https", "checkout_offer_unavailable", "checkout_payment_in_progress", "checkout_request_invalid", "checkout_session_expired", "checkout_session_not_found", "checkout_session_unavailable", "customer_proof_required", "idempotency_key_reused", "insufficient_funds", "invalid_param", "payment_method_required", "payment_method_stale", "payment_provider_rejected", "resource_access_denied", "resource_conflict", "resource_not_found", "service_unavailable", "subscription_paid_through", "subscription_resumable"];
-    readonly errorSets: readonly ["tier:checkout_session", "request"];
-}, {
-    readonly method: "GET";
-    readonly path: "/v1/checkout-attempts/{id}/solana-pay";
-    readonly group: "checkout";
-    readonly auth: "session_id";
-    readonly permission: null;
-    readonly sensitive: false;
-    readonly mountedWhen: "solana";
-    readonly request: null;
-    readonly responses: {
-        readonly 200: "SolanaPayGetResponse";
-    };
-    readonly errors: readonly ["checkout_attempt_expired", "invalid_param", "resource_conflict", "resource_not_found"];
-    readonly errorSets: readonly ["tier:session_id"];
-}, {
-    readonly method: "POST";
-    readonly path: "/v1/checkout-attempts/{id}/solana-pay";
-    readonly group: "checkout";
-    readonly auth: "session_id";
-    readonly permission: null;
-    readonly sensitive: false;
-    readonly mountedWhen: "solana";
-    readonly request: "SolanaPayPostRequest";
-    readonly responses: {
-        readonly 200: "SolanaPayPostResponse";
-    };
-    readonly errors: readonly ["checkout_attempt_expired", "invalid_param", "resource_conflict", "resource_not_found"];
-    readonly errorSets: readonly ["tier:session_id", "request"];
-}, {
-    readonly method: "POST";
-    readonly path: "/v1/me/checkout-sessions";
-    readonly group: "customer";
-    readonly auth: "customer";
-    readonly permission: null;
-    readonly sensitive: false;
-    readonly mountedWhen: null;
-    readonly request: "MintCheckoutSessionParams";
-    readonly responses: {
-        readonly 201: "CheckoutSessionLink";
-    };
-    readonly errors: readonly ["authentication_required", "checkout_offer_unavailable", "checkout_session_unavailable", "customer_action_required", "invalid_param", "resource_conflict", "resource_not_found", "service_unavailable"];
-    readonly errorSets: readonly ["tier:customer", "request"];
-}, {
-    readonly method: "GET";
-    readonly path: "/v1/me/checkout-sessions/{id}";
-    readonly group: "customer";
-    readonly auth: "customer";
-    readonly permission: null;
-    readonly sensitive: false;
-    readonly mountedWhen: null;
-    readonly request: null;
-    readonly responses: {
-        readonly 200: "CheckoutSession";
-    };
-    readonly errors: readonly ["card_attempts_blocked", "card_declined", "card_not_saved", "checkout_session_not_found", "checkout_session_unavailable", "idempotency_key_reused", "insufficient_funds", "invalid_param", "payment_method_required", "payment_method_stale", "payment_provider_rejected", "resource_access_denied", "resource_conflict", "resource_not_found", "service_unavailable", "subscription_paid_through", "subscription_resumable"];
-    readonly errorSets: readonly ["tier:customer"];
-}, {
-    readonly method: "POST";
-    readonly path: "/v1/me/checkout-sessions/{id}/pay";
-    readonly group: "customer";
-    readonly auth: "customer";
-    readonly permission: null;
-    readonly sensitive: false;
-    readonly mountedWhen: null;
-    readonly request: "PayCheckoutSessionParams";
-    readonly responses: {
-        readonly 200: "CheckoutSessionPayResult";
-    };
-    readonly errors: readonly ["card_attempts_blocked", "card_declined", "card_not_saved", "card_requires_https", "checkout_offer_unavailable", "checkout_payment_in_progress", "checkout_request_invalid", "checkout_session_expired", "checkout_session_not_found", "checkout_session_unavailable", "customer_action_required", "customer_proof_required", "idempotency_key_reused", "insufficient_funds", "invalid_param", "payment_method_required", "payment_method_stale", "payment_provider_rejected", "resource_access_denied", "resource_conflict", "resource_not_found", "service_unavailable", "subscription_paid_through", "subscription_resumable"];
-    readonly errorSets: readonly ["tier:customer", "request"];
-}, {
-    readonly method: "GET";
-    readonly path: "/v1/captcha/status";
-    readonly group: "checkout";
-    readonly auth: "public";
-    readonly permission: null;
-    readonly sensitive: false;
-    readonly mountedWhen: null;
-    readonly request: null;
-    readonly responses: {
-        readonly 200: "CaptchaStatus";
-    };
-    readonly errors: readonly [];
-    readonly errorSets: readonly ["tier:public"];
-}, {
-    readonly method: "GET";
-    readonly path: "/v1/captcha/client.js";
-    readonly group: "checkout";
-    readonly auth: "public";
-    readonly permission: null;
-    readonly sensitive: false;
-    readonly mountedWhen: null;
-    readonly request: null;
-    readonly responses: {
-        readonly 200: "application/javascript";
-    };
-    readonly errors: readonly [];
-    readonly errorSets: readonly ["tier:public"];
 }, {
     readonly method: "POST";
     readonly path: "/v1/me/orders/preview";
@@ -276,7 +136,7 @@ export declare const OPENRAILS_ROUTES: readonly [{
     readonly responses: {
         readonly 200: "Order";
     };
-    readonly errors: readonly ["card_declined", "customer_action_required", "customer_session_required", "payment_failed", "resource_conflict", "resource_not_found", "service_unavailable"];
+    readonly errors: readonly ["card_declined", "customer_action_required", "customer_session_required", "invalid_param", "payment_failed", "resource_conflict", "resource_not_found", "service_unavailable"];
     readonly errorSets: readonly ["tier:customer"];
 }, {
     readonly method: "POST";
@@ -546,49 +406,6 @@ export declare const OPENRAILS_ROUTES: readonly [{
     };
     readonly errors: readonly ["currency_unsupported"];
     readonly errorSets: readonly ["tier:customer", "request"];
-}, {
-    readonly method: "GET";
-    readonly path: "/v1/me/invoices";
-    readonly group: "customer";
-    readonly auth: "customer";
-    readonly permission: null;
-    readonly sensitive: false;
-    readonly mountedWhen: null;
-    readonly request: null;
-    readonly responses: {
-        readonly 200: "ListPage<Invoice>";
-    };
-    readonly errors: readonly ["invalid_cursor"];
-    readonly errorSets: readonly ["tier:customer", "request"];
-}, {
-    readonly method: "GET";
-    readonly path: "/v1/me/invoices/{id}";
-    readonly group: "customer";
-    readonly auth: "customer";
-    readonly permission: null;
-    readonly sensitive: false;
-    readonly mountedWhen: null;
-    readonly request: null;
-    readonly responses: {
-        readonly 200: "Invoice";
-    };
-    readonly errors: readonly ["invalid_param", "resource_not_found"];
-    readonly errorSets: readonly ["tier:customer"];
-}, {
-    readonly method: "POST";
-    readonly path: "/v1/me/invoices/{id}/pay-now";
-    readonly group: "customer";
-    readonly auth: "customer";
-    readonly permission: null;
-    readonly sensitive: false;
-    readonly mountedWhen: null;
-    readonly request: "PayInvoiceParams";
-    readonly responses: {
-        readonly 200: "InvoicePayNow";
-        readonly 202: "InvoicePayNow";
-    };
-    readonly errors: readonly ["card_declined", "customer_action_required", "customer_payment_unsupported", "invalid_param", "invalid_payment_method", "payment_idempotency_conflict", "payment_in_progress", "payment_method_required", "payment_not_retryable", "payment_provider_rejected", "rebill_terms_committed", "resource_conflict", "resource_not_found", "service_unavailable"];
-    readonly errorSets: readonly ["tier:customer", "request"];
 }, {
     readonly method: "GET";
     readonly path: "/v1/me/payment-operations/{id}/authentication";
@@ -673,21 +490,6 @@ export declare const OPENRAILS_ROUTES: readonly [{
     };
     readonly errors: readonly ["card_attempts_blocked", "card_declined", "card_not_saved", "card_requires_https", "invalid_param", "payment_duplicate_refused", "payment_method_stale", "payment_provider_rejected", "provider_outcome_unknown", "service_unavailable"];
     readonly errorSets: readonly ["tier:customer", "request"];
-}, {
-    readonly method: "PUT";
-    readonly path: "/v1/me/payment-methods/{id}";
-    readonly group: "customer";
-    readonly auth: "customer";
-    readonly permission: null;
-    readonly sensitive: false;
-    readonly mountedWhen: null;
-    readonly request: "ReplacePaymentMethodCardParams";
-    readonly responses: {
-        readonly 200: "PaymentMethod";
-        readonly 202: null;
-    };
-    readonly errors: readonly ["card_declined", "card_not_saved", "card_requires_https", "invalid_param", "payment_method_update_failed", "payment_method_update_retry_required", "payment_method_update_unsupported", "payment_provider_rejected", "resource_conflict", "resource_not_found", "service_unavailable"];
-    readonly errorSets: readonly ["tier:customer", "request"];
 }, {
     readonly method: "PATCH";
     readonly path: "/v1/me/payment-methods/{id}";