whop_sdk 2.3.0 → 2.4.0

data/reference.md

@@ -4369,6 +4369,391 @@ client.ad_groups.unpause(id: "id")
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+## Ad Pixels
+<details><summary><code>client.ad_pixels.<a href="/lib/whop_sdk/ad_pixels/client.rb">list</a>() -> Whop_sdk::AdPixels::Types::ListAdPixelsResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+List the pixels you added for businesses whose campaigns you claimed.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.ad_pixels.list
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**account_id:** `String` — Only return the pixel for this business, prefixed `biz_`.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**first:** `Integer` — Number of results to return from the start of the range.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**after:** `String` — Return results after this cursor. Use `page_info.end_cursor` from the previous response to fetch the next page.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**last:** `Integer` — Number of results to return from the end of the range.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**before:** `String` — Return results before this cursor. Use `page_info.start_cursor` from the previous response to fetch the previous page.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**order:** `Whop_sdk::AdPixels::Types::ListAdPixelsRequestOrder` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**direction:** `Whop_sdk::AdPixels::Types::ListAdPixelsRequestDirection` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `Whop_sdk::AdPixels::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.ad_pixels.<a href="/lib/whop_sdk/ad_pixels/client.rb">create</a>(request) -> Whop_sdk::Types::AdPixel</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Add your pixel for a business whose campaigns you claimed. Whop checks the access token with the ad platform, then sends the pixel the conversions credited to your claimed campaigns for that business. Each business takes one pixel, and each pixel can serve one business.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.ad_pixels.create(
+  access_token: "new-token",
+  account_id: "biz_xxxxxxxxxxxxxx",
+  external_id: "998877665544",
+  platform: "meta"
+)
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**access_token:** `String` — An access token that can send events to the pixel on the ad platform. Whop never returns it.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**account_id:** `String` — The business whose claimed campaigns send conversions to this pixel, prefixed `biz_`. You must have claimed at least one of its campaigns.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**external_id:** `String` — The pixel's ID on the ad platform.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**platform:** `Whop_sdk::AdPixels::Types::CreateAdPixelsRequestPlatform` — The ad platform the pixel belongs to.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `Whop_sdk::AdPixels::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.ad_pixels.<a href="/lib/whop_sdk/ad_pixels/client.rb">retrieve</a>(id:) -> Whop_sdk::Types::AdPixel</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.ad_pixels.retrieve(id: "id")
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `String` — Ad pixel ID, prefixed `adpx_`.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `Whop_sdk::AdPixels::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.ad_pixels.<a href="/lib/whop_sdk/ad_pixels/client.rb">delete</a>(id:) -> Whop_sdk::AdPixels::Types::DeleteAdPixelsResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Remove the pixel and its access token. Whop stops sending it conversions.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.ad_pixels.delete(id: "id")
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `String` — Ad pixel ID, prefixed `adpx_`.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `Whop_sdk::AdPixels::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.ad_pixels.<a href="/lib/whop_sdk/ad_pixels/client.rb">update</a>(id:, request) -> Whop_sdk::Types::AdPixel</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Replace the pixel's access token. Whop checks the new token with the ad platform and resumes deliveries to an `errored` pixel.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.ad_pixels.update(
+  id: "id",
+  access_token: "new-token"
+)
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `String` — Ad pixel ID, prefixed `adpx_`.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**access_token:** `String` — An access token that can send events to the pixel on the ad platform. Whop never returns it.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `Whop_sdk::AdPixels::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -7403,7 +7788,7 @@ client.apps.list
 <dl>
 <dd>
 
-**order:** `Whop_sdk::Apps::Types::ListAppsRequestOrder` — The field to sort apps by. Defaults to discoverable_at, showing the most recently published apps first. `template_usage` ranks Whop-verified apps first, then by how many businesses created apps from each app as a template.
+**order:** `Whop_sdk::Apps::Types::ListAppsRequestOrder` — The field to sort apps by. Defaults to discoverable_at, showing the most recently published apps first. `template_usage` ranks Whop-verified apps first, then by how many businesses created apps from each app as a template. `template_recent_sales` ranks them by how many of those businesses processed a payment in the last 24 hours, recounted hourly, breaking ties by `template_usage`.
     
 </dd>
 </dl>
@@ -7529,6 +7914,14 @@ client.apps.create(name: "Shine Time Booking")
 <dl>
 <dd>
 
+**domain_id:** `String` — A domain on the account (`dom_` tag) to serve the app at, such as a whop.site address claimed with `POST /domains`. Required with `template_id`.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **icon:** `Whop_sdk::Apps::Types::CreateAppsRequestIcon` — The icon image for the app in PNG, JPEG, or GIF format, referencing an uploaded file: `{ id }` for an existing attachment or `{ direct_upload_id }` for a new direct upload.
     
 </dd>
@@ -7561,7 +7954,7 @@ client.apps.create(name: "Shine Time Booking")
 <dl>
 <dd>
 
-**route:** `String` — The subdomain route where the app's hosted web builds are served, such as `myapp` for myapp.whop.site.
+**route:** `String` — Deprecated: claim an address with `POST /domains` and pass `domain_id`. The subdomain route where the app's hosted web builds are served, such as `myapp` for myapp.whop.site.
     
 </dd>
 </dl>
@@ -10111,7 +10504,7 @@ client.bounty_submissions.submit(id: "id")
 <dl>
 <dd>
 
-Lists an account's card transactions, newest first. Defaults to the account the credential belongs to. Covers every card the owner has ever had, including canceled cards and spend that predates a re-application, and team members only see transactions on the cards assigned to them. Pass `transaction_ids` to fetch specific transactions instead of paging for them.
+Lists the card transactions of an account or a user, newest first. Defaults to the account the credential belongs to. Covers every card the owner has ever had, including canceled cards and spend that predates a re-application, and team members only see transactions on the cards assigned to them. Pass `transaction_ids` to fetch specific transactions instead of paging for them.
 </dd>
 </dl>
 </dd>
@@ -10145,7 +10538,15 @@ client.card_transactions.list(
 <dl>
 <dd>
 
-**account_id:** `String` — The account whose card transactions to list, prefixed `biz_`. Defaults to the credential's account.
+**account_id:** `String` — The account whose card transactions to list, prefixed `biz_`. Provide this or `user_id`. Defaults to the credential's account.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**user_id:** `String` — The user whose personal card transactions to list, prefixed `user_`. Provide this or `account_id`. Only that user can read them.
     
 </dd>
 </dl>
@@ -10311,7 +10712,15 @@ client.card_transactions.retrieve(id: "id")
 <dl>
 <dd>
 
-**account_id:** `String` — The account that owns the transaction, prefixed `biz_`. Defaults to the credential's account.
+**account_id:** `String` — The account that owns the transaction, prefixed `biz_`. Provide this or `user_id`. Defaults to the credential's account.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**user_id:** `String` — The user that owns the transaction, prefixed `user_`. Provide this or `account_id`. Only that user can read it.
     
 </dd>
 </dl>
@@ -15985,7 +16394,15 @@ client.domains.list(tlds: ["com"])
 <dl>
 <dd>
 
-**verification:** `String` — Only domains with verification in this state, such as `ready`, or `any` for every domain that has verification.
+**verification:** `Whop_sdk::Domains::Types::ListDomainsRequestVerification` — Only domains with verification in this state, such as `ready`, or `any` for every domain that has verification.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**registration:** `Whop_sdk::Domains::Types::ListDomainsRequestRegistration` — Only domains with registration in this state, such as `ready`, or `any` for every domain that has registration.
     
 </dd>
 </dl>
@@ -15993,7 +16410,7 @@ client.domains.list(tlds: ["com"])
 <dl>
 <dd>
 
-**registration:** `String` — Only domains with registration in this state, such as `ready`, or `any` for every domain that has registration.
+**platform:** `Whop_sdk::Domains::Types::ListDomainsRequestPlatform` — Only domains with platform in this state, such as `ready`, or `any` for every domain that has platform.
     
 </dd>
 </dl>
@@ -16001,7 +16418,7 @@ client.domains.list(tlds: ["com"])
 <dl>
 <dd>
 
-**website:** `String` — Only domains with website in this state, such as `ready`, or `any` for every domain that has website.
+**website:** `Whop_sdk::Domains::Types::ListDomainsRequestWebsite` — Only domains with website in this state, such as `ready`, or `any` for every domain that has website.
     
 </dd>
 </dl>
@@ -16424,7 +16841,7 @@ client.domains.check(id: "id")
 <dl>
 <dd>
 
-Lists an account's recommendations and generation requests, newest first by default. Without an account, signed-out visitors receive a business-setup template and eligible users receive their saved setup recommendation. With `has_run` and no account, users receive the recommendations run on every account they can read that has Economic Intelligence. An account's executed recommendations and runs stay listed after Economic Intelligence turns off. New recommendations are offered only while it is on. Visitor countries, page views, ad impressions and clicks, and payment volume for a time range come from `GET /stats/time_series/{metric}`.
+Lists an account's recommendations and generation requests, newest first by default. For callers with company:update permission, listing queues generation when no recommendations are ready or in progress, with a ten-minute cooldown after an unsuccessful request; unsuccessful requests are not listed. Without an account, signed-out visitors receive a business-setup template and eligible users receive their saved setup recommendation. With `has_run` and no account, users receive the recommendations run on every account they can read that has Economic Intelligence. An account's executed recommendations and runs stay listed after Economic Intelligence turns off. New recommendations are offered only while it is on. Visitor countries, page views, ad impressions and clicks, and payment volume for a time range come from `GET /stats/time_series/{metric}`.
 </dd>
 </dl>
 </dd>
@@ -17990,7 +18407,7 @@ client.experiences.duplicate(id: "exp_xxxxxxxxxxxxxx")
 <dl>
 <dd>
 
-Lists experiments for one account with experiment:read permission. Omit account_id or pass internal to list internal experiments, which requires Whop internal access.
+Lists experiments for one account with experiment:read permission.
 </dd>
 </dl>
 </dd>
@@ -18020,7 +18437,7 @@ client.experiments.list
 <dl>
 <dd>
 
-**account_id:** `String` — Owning account ID. Omit or pass internal for Whop internal experiments; internal access is required.
+**account_id:** `String` — Owning account ID.
     
 </dd>
 </dl>
@@ -18116,7 +18533,7 @@ client.experiments.list
 <dl>
 <dd>
 
-Creates a draft experiment for the specified account. Use internal for a Whop platform experiment.
+Creates a draft experiment for the specified account.
 </dd>
 </dl>
 </dd>
@@ -18132,7 +18549,7 @@ Creates a draft experiment for the specified account. Use internal for a Whop pl
 
 ```ruby
 client.experiments.create(
-  account_id: "internal",
+  account_id: "biz_xxxxxxxxxxxxxx",
   flag_key: "checkout_redesign_v2"
 )
 ```
@@ -18149,7 +18566,7 @@ client.experiments.create(
 <dl>
 <dd>
 
-**account_id:** `String` — Owning account tag or internal. Required; ownership cannot change.
+**account_id:** `String` — Owning account ID. Required; ownership cannot change.
     
 </dd>
 </dl>
@@ -18157,7 +18574,7 @@ client.experiments.create(
 <dl>
 <dd>
 
-**bucket_by:** `Whop_sdk::Experiments::Types::CreateExperimentsRequestBucketBy` — Randomization unit, and the only identity the assignment is keyed on — evaluation fails rather than falling back to another. `user` (default) uses `subject[user_id]` for account experiments and the signed-in user for internal experiments; `account` uses `subject[account_id]`, so every user of an account gets the same arm; `anonymous` uses the anonymous id and survives sign-in. Fixed after creation.
+**bucket_by:** `Whop_sdk::Experiments::Types::CreateExperimentsRequestBucketBy` — Randomization unit, and the only identity the assignment is keyed on — evaluation fails rather than falling back to another. `user` (default) uses `subject[user_id]`; `account` uses `subject[account_id]`, so every user of an account gets the same arm; `anonymous` uses the anonymous id and survives sign-in. Fixed after creation.
     
 </dd>
 </dl>
@@ -18205,7 +18622,7 @@ client.experiments.create(
 <dl>
 <dd>
 
-**related_resource:** `Whop_sdk::Types::ExperimentResourceReference` 
+**related_resource:** `Whop_sdk::Types::ExperimentResourceReference` — Resource owned by the account that this experiment is bound to, such as an app or product. `null` when unbound. Fixed once the experiment first activates.
     
 </dd>
 </dl>
@@ -18255,9 +18672,9 @@ client.experiments.create(
 
 Evaluates and records an exposure without requiring authentication. When credentials resolve, their authentication method, API key ID, and signed-in user ID are recorded on the exposure event. Pass subject for bucketing identity and account_id for experiment ownership.
 
-Pass `flag_key` to check a single flag, or omit it to fetch active flags in the account and related resource scope. Internal anonymous callers may use the `x-whop-anonymous-id` header or `ajs_anonymous_id` cookie; explicit `subject[anonymous_id]` takes precedence.
+Pass `flag_key` to check a single flag, or omit it to fetch active flags in the account and related resource scope.
 
-Assignments use exactly the configured `bucket_by`: `subject[user_id]`, `subject[account_id]`, or `subject[anonymous_id]`. Internal user experiments derive identity from the signed-in session. Missing the required identity fails single evaluation and omits the experiment from batch evaluation. Subjects outside all treatment ranges receive control.
+Assignments use exactly the configured `bucket_by`: `subject[user_id]`, `subject[account_id]`, or `subject[anonymous_id]`. Missing the required identity fails single evaluation and omits the experiment from batch evaluation. Subjects outside all treatment ranges receive control.
 
 Pass `subject[account_id]` to enable account-level targeting rules. Pass `properties` as a JSON object to supply the values that `property` targeting conditions match against.
 
@@ -18291,7 +18708,7 @@ client.experiments.exposures
 <dl>
 <dd>
 
-**subject:** `Whop_sdk::Types::ExposuresExperimentsRequestSubject` — Bucketing subject. Ownership is the top-level account_id. Account experiments accept caller-supplied subject IDs; internal experiments derive the user from the session.
+**subject:** `Whop_sdk::Types::ExposuresExperimentsRequestSubject` — Bucketing subject: the user, account, or anonymous ID the experiment's `bucket_by` assigns on. Ownership is the top-level account_id.
     
 </dd>
 </dl>
@@ -18315,7 +18732,7 @@ client.experiments.exposures
 <dl>
 <dd>
 
-**account_id:** `String` — Owning account ID or internal. Required when evaluating by flag_key or in a batch; optional for an expt_ ID.
+**account_id:** `String` — Owning account ID. Required when evaluating by flag_key or in a batch; optional for an expt_ ID.
     
 </dd>
 </dl>
@@ -18323,7 +18740,7 @@ client.experiments.exposures
 <dl>
 <dd>
 
-**properties:** `String` — JSON-encoded scalar values that property targeting conditions match against. Numeric and boolean strings are coerced. Nested query keys such as properties[variant]=pro remain accepted for existing callers. For internal experiments, is_internal_user is derived from the session and cannot be overridden.
+**properties:** `String` — JSON-encoded scalar values that property targeting conditions match against. Numeric and boolean strings are coerced. Nested query keys such as properties[variant]=pro remain accepted for existing callers.
     
 </dd>
 </dl>
@@ -18363,7 +18780,7 @@ client.experiments.exposures
 <dl>
 <dd>
 
-Retrieves a single experiment or feature flag by its `expt_` id or flag_key handle. Requires the corresponding experiment permission on the owning account, or Whop internal access for internal experiments.
+Retrieves a single experiment or feature flag by its `expt_` id or flag_key handle. Requires the corresponding experiment permission on the owning account.
 </dd>
 </dl>
 </dd>
@@ -18401,7 +18818,7 @@ client.experiments.retrieve(id: "id")
 <dl>
 <dd>
 
-**account_id:** `String` — Owning account or internal. Required when id is a flag key; optional for an expt_ ID.
+**account_id:** `String` — Owning account ID. Required when id is a flag key; optional for an expt_ ID.
     
 </dd>
 </dl>
@@ -18433,7 +18850,7 @@ client.experiments.retrieve(id: "id")
 <dl>
 <dd>
 
-Updates the targeting rules, treatment allocation, metrics, or hypothesis of an existing experiment or feature flag. Weights and metrics can only grow, so enrolled users never change arms and an existing metric is never dropped. Lifecycle moves through the transition endpoints (`activate`, `pause`, `end`), never through this update. Requires the corresponding experiment permission on the owning account, or Whop internal access for internal experiments.
+Updates the targeting rules, treatment allocation, metrics, or hypothesis of an existing experiment or feature flag. Weights and metrics can only grow, so enrolled users never change arms and an existing metric is never dropped. Lifecycle moves through the transition endpoints (`activate`, `pause`, `end`), never through this update. Requires the corresponding experiment permission on the owning account.
 </dd>
 </dl>
 </dd>
@@ -18471,7 +18888,7 @@ client.experiments.update(id: "id")
 <dl>
 <dd>
 
-**account_id:** `String` — Owning account or internal. Required when id is a flag key; optional for an expt_ ID.
+**account_id:** `String` — Owning account ID. Required when id is a flag key; optional for an expt_ ID.
     
 </dd>
 </dl>
@@ -18495,7 +18912,7 @@ client.experiments.update(id: "id")
 <dl>
 <dd>
 
-**related_resource:** `Whop_sdk::Types::ExperimentResourceReference` 
+**related_resource:** `Whop_sdk::Types::ExperimentResourceReference` — Resource owned by the account that this experiment is bound to, such as an app or product. `null` when unbound. Fixed once the experiment first activates.
     
 </dd>
 </dl>
@@ -18543,7 +18960,7 @@ client.experiments.update(id: "id")
 <dl>
 <dd>
 
-Starts (or resumes) an experiment or feature flag so evaluation begins serving it. Activating a draft stamps `started_at`; resuming a paused experiment keeps the original start. Only drafts and paused experiments can be activated. Requires the corresponding experiment permission on the owning account, or Whop internal access for internal experiments.
+Starts (or resumes) an experiment or feature flag so evaluation begins serving it. Activating a draft stamps `started_at`; resuming a paused experiment keeps the original start. Only drafts and paused experiments can be activated. Requires the corresponding experiment permission on the owning account.
 </dd>
 </dl>
 </dd>
@@ -18581,7 +18998,7 @@ client.experiments.activate(id: "id")
 <dl>
 <dd>
 
-**account_id:** `String` — Owning account or internal. Required when id is a flag key; optional for an expt_ ID.
+**account_id:** `String` — Owning account ID. Required when id is a flag key; optional for an expt_ ID.
     
 </dd>
 </dl>
@@ -18621,7 +19038,7 @@ client.experiments.activate(id: "id")
 <dl>
 <dd>
 
-Concludes the experiment and records required `findings`. Pass `winning_arm` to serve the winning treatment to everyone; omit it when control won. Ended experiments cannot restart, but may be ended again to correct the winner. Requires experiment:manage on the account, or internal access for platform experiments.
+Concludes the experiment and records required `findings`. Pass `winning_arm` to serve the winning treatment to everyone; omit it when control won. Ended experiments cannot restart, but may be ended again to correct the winner. Requires experiment:manage on the account.
 </dd>
 </dl>
 </dd>
@@ -18662,7 +19079,7 @@ client.experiments.end_(
 <dl>
 <dd>
 
-**account_id:** `String` — Owning account or internal. Required when id is a flag key; optional for an expt_ ID.
+**account_id:** `String` — Owning account ID. Required when id is a flag key; optional for an expt_ ID.
     
 </dd>
 </dl>
@@ -18710,7 +19127,7 @@ client.experiments.end_(
 <dl>
 <dd>
 
-Pauses an active experiment or feature flag: evaluation stops serving it and exposures stop flowing. Assignments are keyed on stable identity, so users return to their original arm when the experiment resumes. Requires the corresponding experiment permission on the owning account, or Whop internal access for internal experiments.
+Pauses an active experiment or feature flag: evaluation stops serving it and exposures stop flowing. Assignments are keyed on stable identity, so users return to their original arm when the experiment resumes. Requires the corresponding experiment permission on the owning account.
 </dd>
 </dl>
 </dd>
@@ -18748,7 +19165,7 @@ client.experiments.pause(id: "id")
 <dl>
 <dd>
 
-**account_id:** `String` — Owning account or internal. Required when id is a flag key; optional for an expt_ ID.
+**account_id:** `String` — Owning account ID. Required when id is a flag key; optional for an expt_ ID.
     
 </dd>
 </dl>
@@ -19781,7 +20198,7 @@ client.fee_markups.delete(id: "id")
 <dl>
 <dd>
 
-Submits an issue or an unanswered question to Whop for internal review, recorded under the authenticated user, account, or app. Returns a receipt once the submission is accepted; processing is asynchronous and no reply is sent. Accepts user, account, and app credentials.
+Submits an issue or an unanswered question to Whop for review, recorded under the authenticated user, account, or app. Returns a receipt once the submission is accepted; processing is asynchronous and no reply is sent. Accepts user, account, and app credentials.
 </dd>
 </dl>
 </dd>
@@ -26830,7 +27247,7 @@ client.payment_quotes.create(account_id: "biz_xxxxxxxxxxxxxx")
 <dl>
 <dd>
 
-**address:** `Whop_sdk::PaymentQuotes::Types::CreatePaymentQuotesRequestAddress` — The buyer's billing address. Where tax is calculated when no shipping address is given, and the address a tax registration belongs to. A seller that collects tax on this purchase needs the buyer located by a `country` here, on `shipping_address`, or an `ip_address`; without one the quote is refused with `quote_location_required`. Only the keys you supply are kept. The payment that consumes the quote must put the buyer in the same place, by country, state and postal code, through its own `shipping_address` or its confirmation token's billing address, or it is refused with `quote_mismatch`.
+**address:** `Whop_sdk::PaymentQuotes::Types::CreatePaymentQuotesRequestAddress` — The buyer's billing address. Where tax is calculated when no shipping address is given, and the address a tax registration belongs to. A seller that collects tax on this purchase needs the buyer located by a `country` here, on `shipping_address`, a `presentment_country`, or an `ip_address`; without one the quote is refused with `quote_location_required`. Only the keys you supply are kept. The payment that consumes the quote must put the buyer in the same place, by country, state and postal code, through its own `shipping_address` or its confirmation token's billing address, or it is refused with `quote_mismatch`.
     
 </dd>
 </dl>
@@ -26838,7 +27255,7 @@ client.payment_quotes.create(account_id: "biz_xxxxxxxxxxxxxx")
 <dl>
 <dd>
 
-**ip_address:** `String` — The buyer's IP address, when your server makes the call on their behalf. Locates the buyer when neither address carries a country. A quote located this way (`located_by` is `ip_address`) is a preview: a payment refuses it with `quote_preview_only`, so quote again with the buyer's address before paying. Also where `presentment_currency` `auto` and `recommended_currencies` find the buyer's local currency.
+**ip_address:** `String` — The buyer's IP address, when your server makes the call on their behalf. Locates the buyer when neither address carries a country and no `presentment_country` is sent. A quote located this way (`located_by` is `ip_address`) is a preview: a payment refuses it with `quote_preview_only`, so quote again with the buyer's address before paying. Also where `presentment_currency` `auto` and `recommended_currencies` find the buyer's local currency, and where a payment method must be able to collect it.
     
 </dd>
 </dl>
@@ -26846,7 +27263,15 @@ client.payment_quotes.create(account_id: "biz_xxxxxxxxxxxxxx")
 <dl>
 <dd>
 
-**presentment_currency:** `String` — The currency to price and charge the purchase in. Omit it, or send null, to price in the variants' own currency. `auto` prices in the currency of the country Whop places the buyer's `ip_address` in when the purchase can be converted into it and a payment method can collect it, and in the variants' own currency otherwise, including when no `ip_address` is sent or Whop cannot place it in a country. A three-letter ISO 4217 code, such as `eur`, prices in that currency or is refused: with `presentment_currency_unsupported` when the purchase cannot be converted into it (adaptive pricing is off for the variant, the variant is not a one-time purchase, or `plan` describes a variant that does not exist yet), and with `presentment_currency_not_payable` when no payment method can collect it. A converted quote states every amount in this currency at an `exchange_rate` fixed until `expires_at`, and the payment that consumes it is charged in this currency at that rate.
+**presentment_country:** `String` — The country to price the purchase for, as an ISO 3166-1 alpha-2 code such as `JP`, when the buyer chose one: a store's country picker. Prices in the currency `auto` would pick for a buyer in that country, so send it instead of `presentment_currency`, never with it. Whether a payment method can collect that currency is still judged where the buyer is: by `ip_address`, and by this country only without one. With no address that carries a country, tax is estimated for this country (`located_by` is `presentment_country`) at the country level, and a quote located this way is a preview a payment refuses with `quote_preview_only`. Send it only once the buyer has chosen a country: without it, an `ip_address` estimates more precisely, such as for a US state. For a country Whop has no currency for, the quote is priced as `auto` for the buyer's `ip_address`, and tax is still estimated for the country.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**presentment_currency:** `String` — The currency to price and charge the purchase in. Omit it, or send null, to price in the variants' own currency. `auto` prices in the currency of the country Whop places the buyer's `ip_address` in when the purchase can be converted into it and a payment method can collect it, and in the variants' own currency otherwise, including when no `ip_address` is sent or Whop cannot place it in a country. To choose that country instead, send `presentment_country` in place of this. A three-letter ISO 4217 code, such as `eur`, prices in that currency or is refused: with `presentment_currency_unsupported` when the purchase cannot be converted into it (adaptive pricing is off for the variant, the variant is not a one-time purchase, or `plan` describes a variant that does not exist yet), and with `presentment_currency_not_payable` when no payment method can collect it. A converted quote states every amount in this currency at an `exchange_rate` fixed until `expires_at`, and the payment that consumes it is charged in this currency at that rate.
     
 </dd>
 </dl>
@@ -27924,7 +28349,7 @@ client.payments.create(account_id: "biz_xxxxxxxxxxxxxx")
 <dl>
 <dd>
 
-**quote_id:** `String` — A payment quote from `POST /payment_quotes`, prefixed `pq_`. The payment charges exactly the quote: its purchase (its variants and quantities, or the `plan` it priced), which this body may then omit, its promo code, and its tax, the quote's `tax_amount` rather than a figure calculated now. Omit it, or send null, to have tax calculated when the payment is charged. The quote must belong to `account_id`. A purchase field you omit or send as null takes the quote's value; the buyer's email, the addresses and the payment method are this request's own, never the quote's. Whatever you do send must describe the quoted purchase: the same variants, quantities and promo code. A quote that priced `plan` takes only the same `plan` you sent to `POST /payment_quotes` (or omit the purchase to take the quoted one), never `plan_id` or `line_items`, and a quote that priced variants by id never takes `plan`. Unless the quote located no buyer (`located_by` is null), the address the payment carries (its shipping address, else its billing address) must put the buyer where the quote priced tax, by country, state and postal code; otherwise the payment is refused with 400 before the payment method is used. A quote located by IP address (`located_by` is `ip_address`) is a preview and cannot be paid. A quote is consumed by one payment: a declined payment keeps it and can be retried; a new payment needs a new quote. A quote cannot be charged through PayPal; such a payment is refused before the payment method is used. A quote priced in a `presentment_currency` is charged in that currency at the quote's `exchange_rate`. A payment refused over its quote carries an error `code`. `quote_expired`: the quote has expired; quote again. `quote_tax_unavailable`: the quote could not price tax; quote again, or omit `quote_id`. `quote_preview_only`: the quote was located by IP address; quote again with the buyer's address. `quote_in_use` (409): another payment holds the quote. `quote_mismatch`: the purchase or the buyer's address is not the one quoted. `quote_rate_expired`: the exchange rate the quote was priced at has moved too far to charge; quote again. `payment_method_currency_unsupported`: the payment method cannot pay in the quote's currency; use another method, or quote again in another currency. `quote_processor_unsupported`: the payment method cannot pay a quote, as with PayPal; use another method, or omit `quote_id` to have tax calculated when the payment is charged.
+**quote_id:** `String` — A payment quote from `POST /payment_quotes`, prefixed `pq_`. The payment charges exactly the quote: its purchase (its variants and quantities, or the `plan` it priced), which this body may then omit, its promo code, and its tax, the quote's `tax_amount` rather than a figure calculated now. Omit it, or send null, to have tax calculated when the payment is charged. The quote must belong to `account_id`. A purchase field you omit or send as null takes the quote's value; the buyer's email, the addresses and the payment method are this request's own, never the quote's. Whatever you do send must describe the quoted purchase: the same variants, quantities and promo code. A quote that priced `plan` takes only the same `plan` you sent to `POST /payment_quotes` (or omit the purchase to take the quoted one), never `plan_id` or `line_items`, and a quote that priced variants by id never takes `plan`. Unless the quote located no buyer (`located_by` is null), the address the payment carries (its shipping address, else its billing address) must put the buyer where the quote priced tax, by country, state and postal code; otherwise the payment is refused with 400 before the payment method is used. A quote located by IP address or by the country the buyer chose (`located_by` is `ip_address` or `presentment_country`) is a preview and cannot be paid. A quote is consumed by one payment: a declined payment keeps it and can be retried; a new payment needs a new quote. A quote cannot be charged through PayPal; such a payment is refused before the payment method is used. A quote priced in a `presentment_currency` is charged in that currency at the quote's `exchange_rate`. A payment refused over its quote carries an error `code`. `quote_expired`: the quote has expired; quote again. `quote_tax_unavailable`: the quote could not price tax; quote again, or omit `quote_id`. `quote_preview_only`: the quote was located by IP address or by the country the buyer chose; quote again with the buyer's address. `quote_in_use` (409): another payment holds the quote. `quote_mismatch`: the purchase or the buyer's address is not the one quoted. `quote_rate_expired`: the exchange rate the quote was priced at has moved too far to charge; quote again. `payment_method_currency_unsupported`: the payment method cannot pay in the quote's currency; use another method, or quote again in another currency. `quote_processor_unsupported`: the payment method cannot pay a quote, as with PayPal; use another method, or omit `quote_id` to have tax calculated when the payment is charged.
     
 </dd>
 </dl>
@@ -28228,6 +28653,68 @@ client.payments.list_fees(id: "id")
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.payments.<a href="/lib/whop_sdk/payments/client.rb">generate_pdf</a>(id:) -> Whop_sdk::Types::PaymentPdf</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Generates the payment's receipt (invoice) as a PDF and returns a short-lived link to download it. Each call generates a new file and link, so this endpoint does not replay `Idempotency-Key` responses.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.payments.generate_pdf(id: "id")
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `String` — The payment whose receipt to generate, prefixed `pay_`.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `Whop_sdk::Payments::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -32024,7 +32511,7 @@ client.promo_codes.list(
 <dl>
 <dd>
 
-Creates a promo code for an account. First-party sessions may attach an affiliate.
+Creates a promo code for an account.
 </dd>
 </dl>
 </dd>
@@ -38062,7 +38549,7 @@ client.trades.retrieve(id: "id")
 <dl>
 <dd>
 
-Lists an account's transfers.
+Lists transfers visible to the caller. Optional account filters narrow the results.
 </dd>
 </dl>
 </dd>
@@ -38092,7 +38579,7 @@ client.transfers.list
 <dl>
 <dd>
 
-**origin_id:** `String` — Filter to transfers sent from this account. Provide this or destination_id.
+**origin_id:** `String` — Filter to transfers sent from this account.
     
 </dd>
 </dl>
@@ -38100,7 +38587,7 @@ client.transfers.list
 <dl>
 <dd>
 
-**destination_id:** `String` — Filter to transfers received by this account. Provide this or origin_id.
+**destination_id:** `String` — Filter to transfers received by this account.
     
 </dd>
 </dl>
@@ -38211,10 +38698,7 @@ Moves money between accounts, or into a claim link anyone with the URL can redee
 <dd>
 
 ```ruby
-client.transfers.create(
-  amount: 25,
-  origin_id: "biz_xxxxxxxxxxxxxx"
-)
+client.transfers.create
 ```
 </dd>
 </dl>
@@ -38229,95 +38713,7 @@ client.transfers.create(
 <dl>
 <dd>
 
-**amount:** `Integer` — The amount to move, in the transfer currency. For example 25.00.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**currency:** `String` — Currency, such as `usd`. Required for ledger transfers.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**destination_id:** `String` — The recipient. Required for ledger and wallet_send (a user_/biz_/ldgr_ ID, or — for sends — an email). Omit for claim_link.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**expires_at:** `String` — claim_link only. Link expiry as an ISO 8601 timestamp. Defaults to 24 hours from creation.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**feed_id:** `String` — Ledger transfers only. The feed the transfer was initiated from. Given with `feed_type`, the payment receipt posts into that feed instead of a direct message.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**feed_type:** `Whop_sdk::Transfers::Types::CreateTransfersRequestFeedType` — Ledger transfers only. The type of the feed named by `feed_id`.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**idempotence_key:** `String` — Ledger transfers and wallet sends. A unique key that makes retries safe. Retrying with the same key returns the original transfer, or attaches to the original wallet send, instead of moving money twice.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**metadata:** `Internal::Types::Hash[String, Object]` — Ledger transfers only. Custom key-value pairs attached to the transfer. Max 50 keys, 100 chars per key, 500 chars per string value.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**notes:** `String` — Ledger transfers only. A short note describing the transfer.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**origin_id:** `String` — The account sending the funds. A user ID (user_xxx), account ID (biz_xxx), or ledger account ID (ldgr_xxx).
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**redeemable_count:** `Integer` — claim_link only. How many different users can claim the link. Defaults to 1.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**type:** `Whop_sdk::Transfers::Types::CreateTransfersRequestType` — The kind of money movement, which decides what comes back. Defaults to ledger. `ledger` moves credit between two Whop balances and returns a `transfer`; `wallet_send` sends USDT from the origin account's Ethereum wallet and returns a `send`; `claim_link` funds a shareable link anyone with the URL can redeem and returns a `claim_link`. A `ledger` transfer from a stablecoin-rails account settles on-chain when covered, and still returns a `transfer`.
+**request:** `Whop_sdk::Transfers::Types::CreateTransfersRequestBody` 
     
 </dd>
 </dl>
@@ -38592,7 +38988,7 @@ client.users.list
 <dl>
 <dd>
 
-Retrieves the authenticated user — the self view of the user object. Same shape as `GET /users/{id}`, with the self-only fields populated: `email` (email-read scope), `staff` (Whop staff only, staff-read scope), `balance` and `earnings_usd` (balance-read scope), the opt-in `balance_history`, and every linked social account.
+Retrieves the authenticated user — the self view of the user object. Same shape as `GET /users/{id}`, with the self-only fields populated: `email` (email-read scope), `staff` (Whop staff only, staff-read scope), `balance`, `cards` and `earnings_usd` (balance-read scope), the opt-in `balance_history`, and every linked social account.
 </dd>
 </dl>
 </dd>
@@ -39205,7 +39601,8 @@ client.variants.list(
   plan_types: ["renewal"],
   product_ids: ["prod_xxxxxxxxxxxxxx"],
   presentment_currency: "auto",
-  ip_address: "203.0.113.7"
+  ip_address: "203.0.113.7",
+  presentment_country: "JP"
 )
 ```
 </dd>
@@ -39293,7 +39690,7 @@ client.variants.list(
 <dl>
 <dd>
 
-**presentment_currency:** `String` — The currency to state each variant's prices in. Omit it, or send null, for each variant's own currency. `auto` states them in the currency of the country Whop places the buyer in: by `ip_address` when your server sends one, and by the request's own IP address otherwise. A three-letter ISO 4217 code, such as `eur`, states them in that currency. A variant converts only where a payment quote for it would be priced in that currency, and stays in its own currency otherwise: a renewing variant, one with adaptive pricing off, a currency no payment method can collect, or `auto` for a buyer Whop cannot place in a country. Converted prices are an estimate at the current exchange rate. Nothing is held: the payment quote the buyer pays from fixes the rate.
+**presentment_currency:** `String` — The currency to state each variant's prices in. Omit it, or send null, for each variant's own currency. `auto` states them in the currency of the country Whop places the buyer in: by `ip_address` when your server sends one, and by the request's own IP address otherwise. To choose that country instead, send `presentment_country` in place of this. A three-letter ISO 4217 code, such as `eur`, states them in that currency. A variant converts only where a payment quote for it would be priced in that currency, and stays in its own currency otherwise: a renewing variant, one with adaptive pricing off, a currency no payment method can collect, or `auto` for a buyer Whop cannot place in a country. Converted prices are an estimate at the current exchange rate. Nothing is held: the payment quote the buyer pays from fixes the rate.
     
 </dd>
 </dl>
@@ -39301,7 +39698,15 @@ client.variants.list(
 <dl>
 <dd>
 
-**ip_address:** `String` — The buyer's IP address, when your server reads on their behalf. Needs an API key; any other caller is placed by its own request. Where `presentment_currency` `auto` finds the buyer's local currency.
+**ip_address:** `String` — The buyer's IP address, when your server reads on their behalf. Needs an API key; any other caller is placed by its own request. Where `presentment_currency` `auto` finds the buyer's local currency, and where a payment method must be able to collect it.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**presentment_country:** `String` — The country to state each variant's prices for, as an ISO 3166-1 alpha-2 code such as `JP`, when the buyer chose one: a store's country picker. States them in the currency `auto` would for a buyer in that country, so send it instead of `presentment_currency`, never with it. Whether a payment method can collect that currency is still judged where the buyer is: by `ip_address`, else by the request's own IP address. A country Whop has no currency for is ignored, and the prices are stated as `auto` would state them.
     
 </dd>
 </dl>
@@ -39653,7 +40058,8 @@ Retrieves the details of an existing variant.
 client.variants.retrieve(
   id: "id",
   presentment_currency: "auto",
-  ip_address: "203.0.113.7"
+  ip_address: "203.0.113.7",
+  presentment_country: "JP"
 )
 ```
 </dd>
@@ -39677,7 +40083,15 @@ client.variants.retrieve(
 <dl>
 <dd>
 
-**presentment_currency:** `String` — The currency to state each variant's prices in. Omit it, or send null, for each variant's own currency. `auto` states them in the currency of the country Whop places the buyer in: by `ip_address` when your server sends one, and by the request's own IP address otherwise. A three-letter ISO 4217 code, such as `eur`, states them in that currency. A variant converts only where a payment quote for it would be priced in that currency, and stays in its own currency otherwise: a renewing variant, one with adaptive pricing off, a currency no payment method can collect, or `auto` for a buyer Whop cannot place in a country. Converted prices are an estimate at the current exchange rate. Nothing is held: the payment quote the buyer pays from fixes the rate.
+**presentment_currency:** `String` — The currency to state each variant's prices in. Omit it, or send null, for each variant's own currency. `auto` states them in the currency of the country Whop places the buyer in: by `ip_address` when your server sends one, and by the request's own IP address otherwise. To choose that country instead, send `presentment_country` in place of this. A three-letter ISO 4217 code, such as `eur`, states them in that currency. A variant converts only where a payment quote for it would be priced in that currency, and stays in its own currency otherwise: a renewing variant, one with adaptive pricing off, a currency no payment method can collect, or `auto` for a buyer Whop cannot place in a country. Converted prices are an estimate at the current exchange rate. Nothing is held: the payment quote the buyer pays from fixes the rate.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**ip_address:** `String` — The buyer's IP address, when your server reads on their behalf. Needs an API key; any other caller is placed by its own request. Where `presentment_currency` `auto` finds the buyer's local currency, and where a payment method must be able to collect it.
     
 </dd>
 </dl>
@@ -39685,7 +40099,7 @@ client.variants.retrieve(
 <dl>
 <dd>
 
-**ip_address:** `String` — The buyer's IP address, when your server reads on their behalf. Needs an API key; any other caller is placed by its own request. Where `presentment_currency` `auto` finds the buyer's local currency.
+**presentment_country:** `String` — The country to state each variant's prices for, as an ISO 3166-1 alpha-2 code such as `JP`, when the buyer chose one: a store's country picker. States them in the currency `auto` would for a buyer in that country, so send it instead of `presentment_currency`, never with it. Whether a payment method can collect that currency is still judged where the buyer is: by `ip_address`, else by the request's own IP address. A country Whop has no currency for is ignored, and the prices are stated as `auto` would state them.
     
 </dd>
 </dl>
@@ -44181,7 +44595,7 @@ client.members.logs.list(id: "id")
 <dl>
 <dd>
 
-Lists the platform's visible notification topics — the categories users can set notification preferences on. App-created topics are internal and not returned.
+Lists the platform's visible notification topics — the categories users can set notification preferences on. App-created topics are not returned.
 </dd>
 </dl>
 </dd>
@@ -44747,7 +45161,7 @@ client.payments.direct.create(
 <dl>
 <dd>
 
-**quote_id:** `String` — A payment quote from `POST /payment_quotes`, prefixed `pq_`. The payment charges exactly the quote: its purchase (its variants and quantities, or the `plan` it priced), which this body may then omit, its promo code, and its tax, the quote's `tax_amount` rather than a figure calculated now. Omit it, or send null, to have tax calculated when the payment is charged. The quote must belong to `account_id`. A purchase field you omit or send as null takes the quote's value; the buyer's email, the addresses and the payment method are this request's own, never the quote's. Whatever you do send must describe the quoted purchase: the same variants, quantities and promo code. A quote that priced `plan` takes only the same `plan` you sent to `POST /payment_quotes` (or omit the purchase to take the quoted one), never `plan_id` or `line_items`, and a quote that priced variants by id never takes `plan`. Unless the quote located no buyer (`located_by` is null), the address the payment carries (its shipping address, else its billing address) must put the buyer where the quote priced tax, by country, state and postal code; otherwise the payment is refused with 400 before the payment method is used. A quote located by IP address (`located_by` is `ip_address`) is a preview and cannot be paid. A quote is consumed by one payment: a declined payment keeps it and can be retried; a new payment needs a new quote. A quote cannot be charged through PayPal; such a payment is refused before the payment method is used. A quote priced in a `presentment_currency` is charged in that currency at the quote's `exchange_rate`. A payment refused over its quote carries an error `code`. `quote_expired`: the quote has expired; quote again. `quote_tax_unavailable`: the quote could not price tax; quote again, or omit `quote_id`. `quote_preview_only`: the quote was located by IP address; quote again with the buyer's address. `quote_in_use` (409): another payment holds the quote. `quote_mismatch`: the purchase or the buyer's address is not the one quoted. `quote_rate_expired`: the exchange rate the quote was priced at has moved too far to charge; quote again. `payment_method_currency_unsupported`: the payment method cannot pay in the quote's currency; use another method, or quote again in another currency. `quote_processor_unsupported`: the payment method cannot pay a quote, as with PayPal; use another method, or omit `quote_id` to have tax calculated when the payment is charged.
+**quote_id:** `String` — A payment quote from `POST /payment_quotes`, prefixed `pq_`. The payment charges exactly the quote: its purchase (its variants and quantities, or the `plan` it priced), which this body may then omit, its promo code, and its tax, the quote's `tax_amount` rather than a figure calculated now. Omit it, or send null, to have tax calculated when the payment is charged. The quote must belong to `account_id`. A purchase field you omit or send as null takes the quote's value; the buyer's email, the addresses and the payment method are this request's own, never the quote's. Whatever you do send must describe the quoted purchase: the same variants, quantities and promo code. A quote that priced `plan` takes only the same `plan` you sent to `POST /payment_quotes` (or omit the purchase to take the quoted one), never `plan_id` or `line_items`, and a quote that priced variants by id never takes `plan`. Unless the quote located no buyer (`located_by` is null), the address the payment carries (its shipping address, else its billing address) must put the buyer where the quote priced tax, by country, state and postal code; otherwise the payment is refused with 400 before the payment method is used. A quote located by IP address or by the country the buyer chose (`located_by` is `ip_address` or `presentment_country`) is a preview and cannot be paid. A quote is consumed by one payment: a declined payment keeps it and can be retried; a new payment needs a new quote. A quote cannot be charged through PayPal; such a payment is refused before the payment method is used. A quote priced in a `presentment_currency` is charged in that currency at the quote's `exchange_rate`. A payment refused over its quote carries an error `code`. `quote_expired`: the quote has expired; quote again. `quote_tax_unavailable`: the quote could not price tax; quote again, or omit `quote_id`. `quote_preview_only`: the quote was located by IP address or by the country the buyer chose; quote again with the buyer's address. `quote_in_use` (409): another payment holds the quote. `quote_mismatch`: the purchase or the buyer's address is not the one quoted. `quote_rate_expired`: the exchange rate the quote was priced at has moved too far to charge; quote again. `payment_method_currency_unsupported`: the payment method cannot pay in the quote's currency; use another method, or quote again in another currency. `quote_processor_unsupported`: the payment method cannot pay a quote, as with PayPal; use another method, or omit `quote_id` to have tax calculated when the payment is charged.
     
 </dd>
 </dl>
@@ -47073,6 +47487,14 @@ client.users.preferences.update
 <dl>
 <dd>
 
+**cards_auto_top_up:** `Internal::Types::Boolean` — Whether incoming funds, including pending balance, are automatically moved to the user's personal cards balance. Requires a cards balance and the `payout:account:update` permission.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **investigation_enabled:** `Internal::Types::Boolean` — Whether investigation mode is enabled for the user. Only meaningful for staff users with investigation access.
     
 </dd>