@whop/elements 1.7.0 → 1.8.0

package/checkout.d.cts

@@ -152,10 +152,12 @@ export interface CheckoutElementCreateOptions {
  */
 export interface ExpressCheckoutElementProps {
 	/**
-	 * Which wallets may render — a filter over what the buyer’s device and the seller actually offer. The element never shows a wallet the device, the served matrix, or the checkout’s payment method configuration cannot back, and the render order stays best-native-first, with PayPal last, whatever order this lists. An empty list renders nothing (warned in dev builds). Every wallet needs the page’s domain verified as a [payment method domain](/api-reference/beta/payment-method-domains/payment-method-domain) — first-party whop.com pages are pre-approved; on any other site, register and verify the domain or the buttons stay hidden. Offering Google Pay on your own site is subject to the [Google Pay API Terms of Service](https://payments.developers.google.com/terms/sellertos).
-	 * @default ["apple_pay","google_pay","paypal_express"]
+	 * Which wallets may render. Set `applePay`, `googlePay`, or `payPal` to `'never'` to leave that button out; each key defaults to `'auto'`, a filter over what the buyer’s device and the seller actually offer. The element never shows a wallet the device, the served matrix, or the checkout’s payment method configuration cannot back, and the render order stays best-native-first, with PayPal last. A list of wallet types (`['apple_pay', 'google_pay']`) is still accepted as an allowlist but is deprecated and will be removed in the next major version; an empty list renders nothing (warned in dev builds). Every wallet needs the page’s domain verified as a [payment method domain](/api-reference/beta/payment-method-domains/payment-method-domain) — first-party whop.com pages are pre-approved; on any other site, register and verify the domain or the buttons stay hidden. Offering Google Pay on your own site is subject to the [Google Pay API Terms of Service](https://payments.developers.google.com/terms/sellertos).
+	 * 
+	 * `wallets` as an array is deprecated and will be removed in the next major version. Pass `{ applePay, googlePay, payPal }` with `"auto"` or `"never"` instead.
+	 * @default {}
 	 */
-	wallets?: ("apple_pay" | "google_pay" | "paypal_express")[];
+	wallets?: { applePay?: "auto" | "never" | undefined; googlePay?: "auto" | "never" | undefined; payPal?: "auto" | "never" | undefined; } | ("apple_pay" | "google_pay" | "paypal_express")[];
 	/**
 	 * How the buttons stack. `auto` follows the element’s own container — stacked in narrow containers, side by side in wide ones; `horizontal` and `vertical` force one arrangement.
 	 * @default "auto"
@@ -193,10 +195,12 @@ export interface ExpressCheckoutElementHandle {
  */
 export interface ExpressCheckoutElementCreateOptions {
 	/**
-	 * Which wallets may render — a filter over what the buyer’s device and the seller actually offer. The element never shows a wallet the device, the served matrix, or the checkout’s payment method configuration cannot back, and the render order stays best-native-first, with PayPal last, whatever order this lists. An empty list renders nothing (warned in dev builds). Every wallet needs the page’s domain verified as a [payment method domain](/api-reference/beta/payment-method-domains/payment-method-domain) — first-party whop.com pages are pre-approved; on any other site, register and verify the domain or the buttons stay hidden. Offering Google Pay on your own site is subject to the [Google Pay API Terms of Service](https://payments.developers.google.com/terms/sellertos).
-	 * @default ["apple_pay","google_pay","paypal_express"]
+	 * Which wallets may render. Set `applePay`, `googlePay`, or `payPal` to `'never'` to leave that button out; each key defaults to `'auto'`, a filter over what the buyer’s device and the seller actually offer. The element never shows a wallet the device, the served matrix, or the checkout’s payment method configuration cannot back, and the render order stays best-native-first, with PayPal last. A list of wallet types (`['apple_pay', 'google_pay']`) is still accepted as an allowlist but is deprecated and will be removed in the next major version; an empty list renders nothing (warned in dev builds). Every wallet needs the page’s domain verified as a [payment method domain](/api-reference/beta/payment-method-domains/payment-method-domain) — first-party whop.com pages are pre-approved; on any other site, register and verify the domain or the buttons stay hidden. Offering Google Pay on your own site is subject to the [Google Pay API Terms of Service](https://payments.developers.google.com/terms/sellertos).
+	 * 
+	 * `wallets` as an array is deprecated and will be removed in the next major version. Pass `{ applePay, googlePay, payPal }` with `"auto"` or `"never"` instead.
+	 * @default {}
 	 */
-	wallets?: ("apple_pay" | "google_pay" | "paypal_express")[];
+	wallets?: { applePay?: "auto" | "never" | undefined; googlePay?: "auto" | "never" | undefined; payPal?: "auto" | "never" | undefined; } | ("apple_pay" | "google_pay" | "paypal_express")[];
 	/**
 	 * How the buttons stack. `auto` follows the element’s own container — stacked in narrow containers, side by side in wide ones; `horizontal` and `vertical` force one arrangement.
 	 * @default "auto"

package/checkout.d.ts

@@ -152,10 +152,12 @@ export interface CheckoutElementCreateOptions {
  */
 export interface ExpressCheckoutElementProps {
 	/**
-	 * Which wallets may render — a filter over what the buyer’s device and the seller actually offer. The element never shows a wallet the device, the served matrix, or the checkout’s payment method configuration cannot back, and the render order stays best-native-first, with PayPal last, whatever order this lists. An empty list renders nothing (warned in dev builds). Every wallet needs the page’s domain verified as a [payment method domain](/api-reference/beta/payment-method-domains/payment-method-domain) — first-party whop.com pages are pre-approved; on any other site, register and verify the domain or the buttons stay hidden. Offering Google Pay on your own site is subject to the [Google Pay API Terms of Service](https://payments.developers.google.com/terms/sellertos).
-	 * @default ["apple_pay","google_pay","paypal_express"]
+	 * Which wallets may render. Set `applePay`, `googlePay`, or `payPal` to `'never'` to leave that button out; each key defaults to `'auto'`, a filter over what the buyer’s device and the seller actually offer. The element never shows a wallet the device, the served matrix, or the checkout’s payment method configuration cannot back, and the render order stays best-native-first, with PayPal last. A list of wallet types (`['apple_pay', 'google_pay']`) is still accepted as an allowlist but is deprecated and will be removed in the next major version; an empty list renders nothing (warned in dev builds). Every wallet needs the page’s domain verified as a [payment method domain](/api-reference/beta/payment-method-domains/payment-method-domain) — first-party whop.com pages are pre-approved; on any other site, register and verify the domain or the buttons stay hidden. Offering Google Pay on your own site is subject to the [Google Pay API Terms of Service](https://payments.developers.google.com/terms/sellertos).
+	 * 
+	 * `wallets` as an array is deprecated and will be removed in the next major version. Pass `{ applePay, googlePay, payPal }` with `"auto"` or `"never"` instead.
+	 * @default {}
 	 */
-	wallets?: ("apple_pay" | "google_pay" | "paypal_express")[];
+	wallets?: { applePay?: "auto" | "never" | undefined; googlePay?: "auto" | "never" | undefined; payPal?: "auto" | "never" | undefined; } | ("apple_pay" | "google_pay" | "paypal_express")[];
 	/**
 	 * How the buttons stack. `auto` follows the element’s own container — stacked in narrow containers, side by side in wide ones; `horizontal` and `vertical` force one arrangement.
 	 * @default "auto"
@@ -193,10 +195,12 @@ export interface ExpressCheckoutElementHandle {
  */
 export interface ExpressCheckoutElementCreateOptions {
 	/**
-	 * Which wallets may render — a filter over what the buyer’s device and the seller actually offer. The element never shows a wallet the device, the served matrix, or the checkout’s payment method configuration cannot back, and the render order stays best-native-first, with PayPal last, whatever order this lists. An empty list renders nothing (warned in dev builds). Every wallet needs the page’s domain verified as a [payment method domain](/api-reference/beta/payment-method-domains/payment-method-domain) — first-party whop.com pages are pre-approved; on any other site, register and verify the domain or the buttons stay hidden. Offering Google Pay on your own site is subject to the [Google Pay API Terms of Service](https://payments.developers.google.com/terms/sellertos).
-	 * @default ["apple_pay","google_pay","paypal_express"]
+	 * Which wallets may render. Set `applePay`, `googlePay`, or `payPal` to `'never'` to leave that button out; each key defaults to `'auto'`, a filter over what the buyer’s device and the seller actually offer. The element never shows a wallet the device, the served matrix, or the checkout’s payment method configuration cannot back, and the render order stays best-native-first, with PayPal last. A list of wallet types (`['apple_pay', 'google_pay']`) is still accepted as an allowlist but is deprecated and will be removed in the next major version; an empty list renders nothing (warned in dev builds). Every wallet needs the page’s domain verified as a [payment method domain](/api-reference/beta/payment-method-domains/payment-method-domain) — first-party whop.com pages are pre-approved; on any other site, register and verify the domain or the buttons stay hidden. Offering Google Pay on your own site is subject to the [Google Pay API Terms of Service](https://payments.developers.google.com/terms/sellertos).
+	 * 
+	 * `wallets` as an array is deprecated and will be removed in the next major version. Pass `{ applePay, googlePay, payPal }` with `"auto"` or `"never"` instead.
+	 * @default {}
 	 */
-	wallets?: ("apple_pay" | "google_pay" | "paypal_express")[];
+	wallets?: { applePay?: "auto" | "never" | undefined; googlePay?: "auto" | "never" | undefined; payPal?: "auto" | "never" | undefined; } | ("apple_pay" | "google_pay" | "paypal_express")[];
 	/**
 	 * How the buttons stack. `auto` follows the element’s own container — stacked in narrow containers, side by side in wide ones; `horizontal` and `vertical` force one arrangement.
 	 * @default "auto"

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@whop/elements",
-	"version": "1.7.0",
+	"version": "1.8.0",
 	"description": "Whop Elements — vanilla-js loader + types. Loads the hosted SDK and exposes the typed WhopElements factory.",
 	"keywords": [
 		"checkout",
@@ -97,5 +97,5 @@
 			}
 		}
 	},
-	"whopElementsApiHash": "f11e64fefcafa5eff8df4bbd6a2afbf830f2e718599e49ab8b4a16b111de7565"
+	"whopElementsApiHash": "48049f21f5565b8cedeaa5c1cd09feb3a52012767b9b7dfbf0a5378257fe7f67"
 }

package/payments.d.cts

@@ -215,6 +215,11 @@ export interface PaymentElementProps {
 	 * @default []
 	 */
 	order?: string[];
+	/**
+	 * Controls which wallets the element offers. Each key defaults to `'auto'`, which offers the wallet wherever the account, the buyer's device, and the charge support it. `'never'` removes that wallet from the method list. Use it when your page draws its own Apple Pay, Google Pay, or PayPal buttons with `paymentRequest`, so buyers see each wallet once. `payPal: 'never'` removes the PayPal method. Saved payment methods are unaffected.
+	 * @default {}
+	 */
+	wallets?: { applePay?: "never" | "auto" | undefined; googlePay?: "never" | "auto" | undefined; payPal?: "never" | "auto" | undefined; };
 	/**
 	 * Controls billing-details collection. `billingDetails: 'minimal'` (default) follows each method's matrix. Methods collect name and the complete country format by default. An override may collect only the declared minimum or nothing. For cards, the minimum is name on card, country, and postal code. `'full'` requires name and the complete country format for every fresh method. `'never'` hides the block. `phone: 'never'` hides only the billing phone input when your form already collects it; pass `billingDetails.phone` to `createConfirmationToken` for methods that require it. Pass the address to `createConfirmationToken` instead. The country selector includes only countries supported by the method and payment currency. With an installment plan selected, it narrows to the countries the plan serves — the billing country is the transaction country the charge processes under. It locks when only one is available.
 	 * @default {"billingDetails":"minimal"}
@@ -279,6 +284,11 @@ export interface PaymentElementCreateOptions {
 	 * @default []
 	 */
 	order?: string[];
+	/**
+	 * Controls which wallets the element offers. Each key defaults to `'auto'`, which offers the wallet wherever the account, the buyer's device, and the charge support it. `'never'` removes that wallet from the method list. Use it when your page draws its own Apple Pay, Google Pay, or PayPal buttons with `paymentRequest`, so buyers see each wallet once. `payPal: 'never'` removes the PayPal method. Saved payment methods are unaffected.
+	 * @default {}
+	 */
+	wallets?: { applePay?: "never" | "auto" | undefined; googlePay?: "never" | "auto" | undefined; payPal?: "never" | "auto" | undefined; };
 	/**
 	 * Controls billing-details collection. `billingDetails: 'minimal'` (default) follows each method's matrix. Methods collect name and the complete country format by default. An override may collect only the declared minimum or nothing. For cards, the minimum is name on card, country, and postal code. `'full'` requires name and the complete country format for every fresh method. `'never'` hides the block. `phone: 'never'` hides only the billing phone input when your form already collects it; pass `billingDetails.phone` to `createConfirmationToken` for methods that require it. Pass the address to `createConfirmationToken` instead. The country selector includes only countries supported by the method and payment currency. With an installment plan selected, it narrows to the countries the plan serves — the billing country is the transaction country the charge processes under. It locks when only one is available.
 	 * @default {"billingDetails":"minimal"}
@@ -339,7 +349,7 @@ export interface AddressElementProps {
 	 * The name row: one full-name field (default), split first/last fields, or none.
 	 * @default "combined"
 	 */
-	name?: "split" | "combined" | "none";
+	name?: "split" | "none" | "combined";
 	/**
 	 * Address line 2: always visible (default), revealed by a text button (`toggle`), or never collected.
 	 * @default "always"
@@ -368,7 +378,7 @@ export interface AddressElementProps {
 	 * Organization fields: none (default), name only, or name with a business/individual selector.
 	 * @default "none"
 	 */
-	organization?: "name" | "none" | "name_with_type";
+	organization?: "none" | "name" | "name_with_type";
 	/**
 	 * Default the country from the buyer's IP (resolved before first paint). Falls back to the controller's `countryHint`, then US.
 	 * @default true
@@ -445,7 +455,7 @@ export interface AddressElementCreateOptions {
 	 * The name row: one full-name field (default), split first/last fields, or none.
 	 * @default "combined"
 	 */
-	name?: "split" | "combined" | "none";
+	name?: "split" | "none" | "combined";
 	/**
 	 * Address line 2: always visible (default), revealed by a text button (`toggle`), or never collected.
 	 * @default "always"
@@ -474,7 +484,7 @@ export interface AddressElementCreateOptions {
 	 * Organization fields: none (default), name only, or name with a business/individual selector.
 	 * @default "none"
 	 */
-	organization?: "name" | "none" | "name_with_type";
+	organization?: "none" | "name" | "name_with_type";
 	/**
 	 * Default the country from the buyer's IP (resolved before first paint). Falls back to the controller's `countryHint`, then US.
 	 * @default true
@@ -595,6 +605,11 @@ export interface EmailElementProps {
 	 * @default true
 	 */
 	label?: boolean;
+	/**
+	 * Placeholder text for the email input. Empty (default) renders `you@example.com`. With floating labels the label text is the placeholder instead.
+	 * @default ""
+	 */
+	placeholder?: string;
 	/**
 	 * `above` (default) shows the label above the input. `floating` uses the label text as the placeholder, then shows a small label above the typed text once the input has a value. Ignored when `label` is `false`.
 	 * @default "above"
@@ -605,11 +620,6 @@ export interface EmailElementProps {
 	 * @default ""
 	 */
 	defaultValue?: string;
-	/**
-	 * Placeholder text for the email input. Empty (default) renders `you@example.com`. With floating labels the label text is the placeholder instead.
-	 * @default ""
-	 */
-	placeholder?: string;
 }
 
 /**
@@ -646,6 +656,11 @@ export interface EmailElementCreateOptions {
 	 * @default true
 	 */
 	label?: boolean;
+	/**
+	 * Placeholder text for the email input. Empty (default) renders `you@example.com`. With floating labels the label text is the placeholder instead.
+	 * @default ""
+	 */
+	placeholder?: string;
 	/**
 	 * `above` (default) shows the label above the input. `floating` uses the label text as the placeholder, then shows a small label above the typed text once the input has a value. Ignored when `label` is `false`.
 	 * @default "above"
@@ -656,11 +671,6 @@ export interface EmailElementCreateOptions {
 	 * @default ""
 	 */
 	defaultValue?: string;
-	/**
-	 * Placeholder text for the email input. Empty (default) renders `you@example.com`. With floating labels the label text is the placeholder instead.
-	 * @default ""
-	 */
-	placeholder?: string;
 	/**
 	 * Fires when the email changes. `complete` is true when plausible. Sign-in fires it with the signed-in email, which also feeds `createConfirmationToken()`.
 	 */
@@ -825,6 +835,10 @@ export interface BrandingElementCreateOptions {
  * @see https://docs.whop.com/elements/latest/payments/overview
  */
 export interface CardFieldsSubOptions {
+	/**
+	 * The seller's accepted card networks in display order — the matrix card entry's `networks` objects, whose API-served icons drive the number field's brand art. Omit it to fetch alongside the key.
+	 */
+	networks?: CardNetworkArt[];
 	/**
 	 * `stacked` (default) shapes composed fields as a number row above expiration and security code. `compact` shapes one row. Separately mounted fields ignore this layout and render with full borders and rounded corners.
 	 * @default "stacked"
@@ -834,10 +848,6 @@ export interface CardFieldsSubOptions {
 	 * Advanced Basis Theory publishable key. Omit it to fetch the key automatically.
 	 */
 	publicKey?: string;
-	/**
-	 * The seller's accepted card networks in display order — the matrix card entry's `networks` objects, whose API-served icons drive the number field's brand art. Omit it to fetch alongside the key.
-	 */
-	networks?: CardNetworkArt[];
 	/**
 	 * Fires when completeness changes. `complete` becomes true after the buyer fills all three fields. Use it to enable confirmation. `brand` is the detected card network. `funding` is the detected funding type (`credit`, `debit`, or `prepaid`), `null` until the number identifies one. `issuingCountry` is the lowercase two-letter code of the country the card was issued in, `null` until the number identifies one.
 	 */
@@ -1161,7 +1171,7 @@ export interface PaymentsHandle {
 	 */
 	create(name: "taxId", options?: TaxIdElementCreateOptions): TaxIdElementHandle;
 	/**
-	 * Whop's merchant-of-record notice: the Whop wordmark with links to the buyer terms and privacy policy. Mount it alongside every payment collection surface.
+	 * Whop's merchant-of-record notice: the Whop wordmark with links to the buyer terms and privacy policy. Required — the payment, card and card fields elements stay in their loading state until it is mounted, and payments cannot be confirmed without it.
 	 */
 	create(name: "branding", options?: BrandingElementCreateOptions): BrandingElementHandle;
 	/**
@@ -1306,12 +1316,12 @@ export interface PaymentRequestResult {
  * Declared from the app's `PaymentRequestError`, referenced by a host-capability surface.
  */
 export interface PaymentRequestError {
-	code?: "shipping_address_invalid" | "shipping_address_unserviceable" | "shipping_option_invalid" | "other" | undefined;
+	code?: "other" | "shipping_address_invalid" | "shipping_address_unserviceable" | "shipping_option_invalid" | undefined;
 	message: string;
 	/**
 	 * The address field the error is about: one of the fields the redacted address carries. Apple Pay marks that field with the message, whatever the `code`; Google Pay shows the message alone. Omit it for an error about the whole address.
 	 */
-	field?: "state" | "city" | "postal_code" | "country" | undefined;
+	field?: "state" | "country" | "city" | "postal_code" | undefined;
 }
 
 /**
@@ -1375,6 +1385,10 @@ export interface PromoCodeUpdate {
 	 * The sheet's line items under the code, such as the discount and the tax it changes.
 	 */
 	lineItems?: PaymentRequestLineItem[] | undefined;
+	/**
+	 * Replaces the sheet's shipping options under the code, such as a free-shipping code that drops a rate to zero. An option stays selected while its `id` is still in the list. Send `amount` as well when the selected option's price changes, since the total doesn't follow on its own.
+	 */
+	shippingOptions?: PaymentRequestShippingOption[] | undefined;
 	/**
 	 * A caption for the applied code, where the sheet captions codes (Google Pay).
 	 */
@@ -1394,7 +1408,7 @@ export interface PromoCodeChangeEvent {
 	 */
 	code: string | null;
 	/**
-	 * Answer exactly once: `error` refuses the code and keeps the totals, and any other answer applies it. `amount` and `lineItems` reprice the sheet under the code, and `appliedDescription` captions the applied code where the sheet shows one (Google Pay). `updateWith({})` applies the code at the current total.
+	 * Answer exactly once: `error` refuses the code and keeps the totals, and any other answer applies it. `amount` and `lineItems` reprice the sheet under the code, `shippingOptions` replaces its shipping options (a free-shipping code), and `appliedDescription` captions the applied code where the sheet shows one (Google Pay). `updateWith({})` applies the code at the current total.
 	 */
 	updateWith: (update: PromoCodeUpdate) => void;
 }

package/payments.d.ts

@@ -215,6 +215,11 @@ export interface PaymentElementProps {
 	 * @default []
 	 */
 	order?: string[];
+	/**
+	 * Controls which wallets the element offers. Each key defaults to `'auto'`, which offers the wallet wherever the account, the buyer's device, and the charge support it. `'never'` removes that wallet from the method list. Use it when your page draws its own Apple Pay, Google Pay, or PayPal buttons with `paymentRequest`, so buyers see each wallet once. `payPal: 'never'` removes the PayPal method. Saved payment methods are unaffected.
+	 * @default {}
+	 */
+	wallets?: { applePay?: "never" | "auto" | undefined; googlePay?: "never" | "auto" | undefined; payPal?: "never" | "auto" | undefined; };
 	/**
 	 * Controls billing-details collection. `billingDetails: 'minimal'` (default) follows each method's matrix. Methods collect name and the complete country format by default. An override may collect only the declared minimum or nothing. For cards, the minimum is name on card, country, and postal code. `'full'` requires name and the complete country format for every fresh method. `'never'` hides the block. `phone: 'never'` hides only the billing phone input when your form already collects it; pass `billingDetails.phone` to `createConfirmationToken` for methods that require it. Pass the address to `createConfirmationToken` instead. The country selector includes only countries supported by the method and payment currency. With an installment plan selected, it narrows to the countries the plan serves — the billing country is the transaction country the charge processes under. It locks when only one is available.
 	 * @default {"billingDetails":"minimal"}
@@ -279,6 +284,11 @@ export interface PaymentElementCreateOptions {
 	 * @default []
 	 */
 	order?: string[];
+	/**
+	 * Controls which wallets the element offers. Each key defaults to `'auto'`, which offers the wallet wherever the account, the buyer's device, and the charge support it. `'never'` removes that wallet from the method list. Use it when your page draws its own Apple Pay, Google Pay, or PayPal buttons with `paymentRequest`, so buyers see each wallet once. `payPal: 'never'` removes the PayPal method. Saved payment methods are unaffected.
+	 * @default {}
+	 */
+	wallets?: { applePay?: "never" | "auto" | undefined; googlePay?: "never" | "auto" | undefined; payPal?: "never" | "auto" | undefined; };
 	/**
 	 * Controls billing-details collection. `billingDetails: 'minimal'` (default) follows each method's matrix. Methods collect name and the complete country format by default. An override may collect only the declared minimum or nothing. For cards, the minimum is name on card, country, and postal code. `'full'` requires name and the complete country format for every fresh method. `'never'` hides the block. `phone: 'never'` hides only the billing phone input when your form already collects it; pass `billingDetails.phone` to `createConfirmationToken` for methods that require it. Pass the address to `createConfirmationToken` instead. The country selector includes only countries supported by the method and payment currency. With an installment plan selected, it narrows to the countries the plan serves — the billing country is the transaction country the charge processes under. It locks when only one is available.
 	 * @default {"billingDetails":"minimal"}
@@ -339,7 +349,7 @@ export interface AddressElementProps {
 	 * The name row: one full-name field (default), split first/last fields, or none.
 	 * @default "combined"
 	 */
-	name?: "split" | "combined" | "none";
+	name?: "split" | "none" | "combined";
 	/**
 	 * Address line 2: always visible (default), revealed by a text button (`toggle`), or never collected.
 	 * @default "always"
@@ -368,7 +378,7 @@ export interface AddressElementProps {
 	 * Organization fields: none (default), name only, or name with a business/individual selector.
 	 * @default "none"
 	 */
-	organization?: "name" | "none" | "name_with_type";
+	organization?: "none" | "name" | "name_with_type";
 	/**
 	 * Default the country from the buyer's IP (resolved before first paint). Falls back to the controller's `countryHint`, then US.
 	 * @default true
@@ -445,7 +455,7 @@ export interface AddressElementCreateOptions {
 	 * The name row: one full-name field (default), split first/last fields, or none.
 	 * @default "combined"
 	 */
-	name?: "split" | "combined" | "none";
+	name?: "split" | "none" | "combined";
 	/**
 	 * Address line 2: always visible (default), revealed by a text button (`toggle`), or never collected.
 	 * @default "always"
@@ -474,7 +484,7 @@ export interface AddressElementCreateOptions {
 	 * Organization fields: none (default), name only, or name with a business/individual selector.
 	 * @default "none"
 	 */
-	organization?: "name" | "none" | "name_with_type";
+	organization?: "none" | "name" | "name_with_type";
 	/**
 	 * Default the country from the buyer's IP (resolved before first paint). Falls back to the controller's `countryHint`, then US.
 	 * @default true
@@ -595,6 +605,11 @@ export interface EmailElementProps {
 	 * @default true
 	 */
 	label?: boolean;
+	/**
+	 * Placeholder text for the email input. Empty (default) renders `you@example.com`. With floating labels the label text is the placeholder instead.
+	 * @default ""
+	 */
+	placeholder?: string;
 	/**
 	 * `above` (default) shows the label above the input. `floating` uses the label text as the placeholder, then shows a small label above the typed text once the input has a value. Ignored when `label` is `false`.
 	 * @default "above"
@@ -605,11 +620,6 @@ export interface EmailElementProps {
 	 * @default ""
 	 */
 	defaultValue?: string;
-	/**
-	 * Placeholder text for the email input. Empty (default) renders `you@example.com`. With floating labels the label text is the placeholder instead.
-	 * @default ""
-	 */
-	placeholder?: string;
 }
 
 /**
@@ -646,6 +656,11 @@ export interface EmailElementCreateOptions {
 	 * @default true
 	 */
 	label?: boolean;
+	/**
+	 * Placeholder text for the email input. Empty (default) renders `you@example.com`. With floating labels the label text is the placeholder instead.
+	 * @default ""
+	 */
+	placeholder?: string;
 	/**
 	 * `above` (default) shows the label above the input. `floating` uses the label text as the placeholder, then shows a small label above the typed text once the input has a value. Ignored when `label` is `false`.
 	 * @default "above"
@@ -656,11 +671,6 @@ export interface EmailElementCreateOptions {
 	 * @default ""
 	 */
 	defaultValue?: string;
-	/**
-	 * Placeholder text for the email input. Empty (default) renders `you@example.com`. With floating labels the label text is the placeholder instead.
-	 * @default ""
-	 */
-	placeholder?: string;
 	/**
 	 * Fires when the email changes. `complete` is true when plausible. Sign-in fires it with the signed-in email, which also feeds `createConfirmationToken()`.
 	 */
@@ -825,6 +835,10 @@ export interface BrandingElementCreateOptions {
  * @see https://docs.whop.com/elements/latest/payments/overview
  */
 export interface CardFieldsSubOptions {
+	/**
+	 * The seller's accepted card networks in display order — the matrix card entry's `networks` objects, whose API-served icons drive the number field's brand art. Omit it to fetch alongside the key.
+	 */
+	networks?: CardNetworkArt[];
 	/**
 	 * `stacked` (default) shapes composed fields as a number row above expiration and security code. `compact` shapes one row. Separately mounted fields ignore this layout and render with full borders and rounded corners.
 	 * @default "stacked"
@@ -834,10 +848,6 @@ export interface CardFieldsSubOptions {
 	 * Advanced Basis Theory publishable key. Omit it to fetch the key automatically.
 	 */
 	publicKey?: string;
-	/**
-	 * The seller's accepted card networks in display order — the matrix card entry's `networks` objects, whose API-served icons drive the number field's brand art. Omit it to fetch alongside the key.
-	 */
-	networks?: CardNetworkArt[];
 	/**
 	 * Fires when completeness changes. `complete` becomes true after the buyer fills all three fields. Use it to enable confirmation. `brand` is the detected card network. `funding` is the detected funding type (`credit`, `debit`, or `prepaid`), `null` until the number identifies one. `issuingCountry` is the lowercase two-letter code of the country the card was issued in, `null` until the number identifies one.
 	 */
@@ -1161,7 +1171,7 @@ export interface PaymentsHandle {
 	 */
 	create(name: "taxId", options?: TaxIdElementCreateOptions): TaxIdElementHandle;
 	/**
-	 * Whop's merchant-of-record notice: the Whop wordmark with links to the buyer terms and privacy policy. Mount it alongside every payment collection surface.
+	 * Whop's merchant-of-record notice: the Whop wordmark with links to the buyer terms and privacy policy. Required — the payment, card and card fields elements stay in their loading state until it is mounted, and payments cannot be confirmed without it.
 	 */
 	create(name: "branding", options?: BrandingElementCreateOptions): BrandingElementHandle;
 	/**
@@ -1306,12 +1316,12 @@ export interface PaymentRequestResult {
  * Declared from the app's `PaymentRequestError`, referenced by a host-capability surface.
  */
 export interface PaymentRequestError {
-	code?: "shipping_address_invalid" | "shipping_address_unserviceable" | "shipping_option_invalid" | "other" | undefined;
+	code?: "other" | "shipping_address_invalid" | "shipping_address_unserviceable" | "shipping_option_invalid" | undefined;
 	message: string;
 	/**
 	 * The address field the error is about: one of the fields the redacted address carries. Apple Pay marks that field with the message, whatever the `code`; Google Pay shows the message alone. Omit it for an error about the whole address.
 	 */
-	field?: "state" | "city" | "postal_code" | "country" | undefined;
+	field?: "state" | "country" | "city" | "postal_code" | undefined;
 }
 
 /**
@@ -1375,6 +1385,10 @@ export interface PromoCodeUpdate {
 	 * The sheet's line items under the code, such as the discount and the tax it changes.
 	 */
 	lineItems?: PaymentRequestLineItem[] | undefined;
+	/**
+	 * Replaces the sheet's shipping options under the code, such as a free-shipping code that drops a rate to zero. An option stays selected while its `id` is still in the list. Send `amount` as well when the selected option's price changes, since the total doesn't follow on its own.
+	 */
+	shippingOptions?: PaymentRequestShippingOption[] | undefined;
 	/**
 	 * A caption for the applied code, where the sheet captions codes (Google Pay).
 	 */
@@ -1394,7 +1408,7 @@ export interface PromoCodeChangeEvent {
 	 */
 	code: string | null;
 	/**
-	 * Answer exactly once: `error` refuses the code and keeps the totals, and any other answer applies it. `amount` and `lineItems` reprice the sheet under the code, and `appliedDescription` captions the applied code where the sheet shows one (Google Pay). `updateWith({})` applies the code at the current total.
+	 * Answer exactly once: `error` refuses the code and keeps the totals, and any other answer applies it. `amount` and `lineItems` reprice the sheet under the code, `shippingOptions` replaces its shipping options (a free-shipping code), and `appliedDescription` captions the applied code where the sheet shows one (Google Pay). `updateWith({})` applies the code at the current total.
 	 */
 	updateWith: (update: PromoCodeUpdate) => void;
 }