> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Moneda de liquidación preferida

> Convierte cada nueva venta a USD, EUR, GBP, CAD o AUD. Descubre qué ventas se convierten y cómo se liquidan los reembolsos, las disputas y las comisiones de plataforma.

Configura una moneda de liquidación preferida para reunir todos los ingresos nuevos en un único saldo. Whop convierte cada nueva venta a esa moneda cuando el comprador paga, así que no tienes que convertir saldos pequeños antes de un pago saliente.

| | Moneda original (predeterminada) | Moneda de liquidación preferida |
| - | - | - |
| **Dónde se liquida una venta** | Un saldo en la moneda del plan | Un saldo en la moneda que elijas |
| **Saldos que gestionar** | Uno por cada moneda de plan | Uno |
| **Comisión adicional** | Ninguna | 0,5 % en cada venta convertida |

## Elegir una moneda

> [tab] Panel
>
> 1. En la configuración de tu panel, selecciona **Payments**.
> 2. En **Preferred settlement currency**, selecciona una moneda en **Settle every new sale in**.
> 3. Selecciona **Save changes**.

> [tab] API
>
> Envía un código de moneda en minúsculas a [Update Account Preferences](https://docs.whop.com/es/api-reference/accounts/update-account-preferences.md). Envía `null` para desactivar la opción.
>
> ```typescript TypeScript theme={null}
> import { WhopClient } from "@whop/sdk";
>
> const client = new WhopClient({ token: process.env.WHOP_API_KEY });
>
> const preferences = await client.accounts.preferences.update({
> 	account_id: "biz_xxxxxxxxxxxxx",
> 	preferred_settlement_currency: "usd",
> });
>
> console.log(preferences.preferred_settlement_currency_changeable_at);
> ```
>
> ```python Python theme={null}
> import os
>
> from whop_sdk import Whop
>
> client = Whop(token=os.environ["WHOP_API_KEY"])
>
> preferences = client.accounts.preferences.update(
>     account_id="biz_xxxxxxxxxxxxx",
>     preferred_settlement_currency="usd",
> )
>
> print(preferences.preferred_settlement_currency_changeable_at)
> ```
>
> ```ruby Ruby theme={null}
> require "whop_sdk"
>
> client = Whop_sdk::Client.new(token: ENV.fetch("WHOP_API_KEY"))
>
> preferences = client.accounts.preferences.update(
>   account_id: "biz_xxxxxxxxxxxxx",
>   preferred_settlement_currency: "usd"
> )
>
> puts preferences.preferred_settlement_currency_changeable_at
> ```
>
> ```bash cURL theme={null}
> curl -X PATCH "https://api.whop.com/api/v1/accounts/biz_xxxxxxxxxxxxx/preferences" \
>   -H "Authorization: Bearer $WHOP_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "preferred_settlement_currency": "usd" }'
> ```
>
> La respuesta devuelve las preferencias de la cuenta:
>
> ```json theme={null}
> {
> 	"preferred_settlement_currency": "usd",
> 	"preferred_settlement_currency_changeable_at": "2026-10-22T14:03:11.000Z"
> }
> ```

Un cambio solo se aplica a las ventas nuevas. El dinero que ya está en tus saldos se queda en su moneda.

## Saber qué ventas se convierten

Una venta se convierte cuando la moneda de su plan no es tu moneda preferida. La moneda en la que paga el comprador no cambia esto.

Estas ventas nunca se convierten:

* Las ventas de planes que ya están en tu moneda preferida.
* Las compras en la App Store. Apple las paga en USD.
* Las ventas que se liquidan fuera de tu saldo de Whop, como las ventas a través de una cuenta de Stripe que hayas conectado.

Whop fija el tipo de cambio cuando el comprador paga y lo almacena en el pago. La opción no afecta al comprador. El comprador paga el precio que se muestra en el checkout, y el recibo muestra ese importe.

## Estructura de comisiones

Cada venta convertida tiene una comisión del 0,5 %. También se aplican tus comisiones habituales. El pago muestra el 0,5 % en la línea **Currency conversion**.

Whop no cobra el 0,5 % cuando el comprador paga en una moneda distinta de la del plan. [Adaptive pricing](https://docs.whop.com/es/payments-and-billing/fees/adaptive-pricing.md) ya cobra por esa conversión en el checkout.

Estos ejemplos usan USD como moneda preferida:

| Moneda del plan | El comprador paga en | Se liquida en | Comisión del 0,5 % |
| - | - | - | - |
| USD | USD o EUR | USD | No. El plan ya está en USD. |
| GBP | GBP | USD | Sí |
| GBP | EUR o USD | USD | No. El comprador pagó en otra moneda. |
| MXN | MXN | USD | Sí |
| GBP, App Store | GBP | USD | No. Apple paga en USD. |

## Reembolsos y disputas

Un reembolso o una disputa se descuenta del saldo en el que se liquidó la venta.

* Los **reembolsos** usan el tipo de cambio almacenado en el pago. Un cambio del tipo después de la venta no cambia el importe.
* Las **disputas** usan el tipo de cambio del día en que se abre la disputa. El importe puede diferir del de la venta convertida.

## Plataformas y subcuentas

La opción solo se aplica a la cuenta que la configura. Una subcuenta no hereda la configuración de su plataforma, y una plataforma no hereda la configuración de sus subcuentas.

Tus comisiones de aplicación siguen tu configuración. Whop convierte cada comisión a tu moneda al tipo de cambio del día de la venta. La parte de la subcuenta sigue la configuración de la subcuenta.

Whop te cobra un 0,5 % sobre una comisión de aplicación convertida. Whop no cobra el 0,5 % cuando el plan de la venta ya está en tu moneda.

## Leer los importes de un pago

Un [pago](https://docs.whop.com/es/api-reference/payments/payment) indica los importes en dos monedas. Cada importe incluye su propia `currency`.

| Campos | Moneda | Uso |
| - | - | - |
| `total`, `subtotal`, `tax_amount`, `refunded_amount`, `amount_after_fees` | La moneda de liquidación | Saldos, pagos salientes y conciliación del libro mayor |
| `presentment_total`, `presentment_tax_amount`, `presentment_refunded_amount` | La moneda en la que pagó el comprador | Totales de pedidos, recibos y correos a clientes |

Para hacer coincidir un pago con un pedido de tu sistema, compara `presentment_total`. La opción no lo cambia. `presentment_total` no incluye las comisiones del comprador. Los [webhooks de pagos](https://docs.whop.com/es/developer/guides/webhooks.md) envían los mismos campos.

## Próximos pasos

> [card] [Referencia de Account Preferences](https://docs.whop.com/es/api-reference/accounts/update-account-preferences.md)
>
> Todos los campos de preferencias y el scope que necesita cada uno.

> [card] [Adaptive pricing](https://docs.whop.com/es/payments-and-billing/fees/adaptive-pricing.md)
>
> Muestra a los compradores los precios en su moneda local en el checkout.


## Related topics

- [SettlementElement](https://docs.whop.com/es/elements/latest/wallet/balances-settlement.md)
- [ActivityDetailElement](https://docs.whop.com/es/elements/latest/wallet/activityDetail.md)
- [API de actividad financiera](https://docs.whop.com/es/api-reference/ledgers/ledger-activity.md)
