> ## 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.

# Factura heredada

> Una factura representa una cuenta detallada enviada por una empresa a un cliente por un producto y plan específicos, que registra el importe adeudado, la fecha de vencimiento y el estado del pago.

> [!NOTE]
>
> Este recurso tiene un sucesor en la [API de Whop](https://docs.whop.com/es/api-reference/legacy/invoices/list-invoices.md): las solicitudes a `/invoices` con `Api-Version-Date: 2026-10-24` o posterior llegan a las facturas nativas, que se explican en la [guía de facturas](https://docs.whop.com/es/developer/guides/invoices.md). Esta página sigue teniendo soporte completo.

```json Example theme={null}
{
	"automatically_finalizes_at": "2023-12-01T05:00:00.401Z",
	"charge_buyer_fee": true,
	"collection_method": "send_invoice",
	"company": {
		"id": "biz_xxxxxxxxxxxxxx",
		"logo": {
			"url": "https://media.whop.com/abc123/optimized.jpg"
		},
		"title": "Pickaxe"
	},
	"created_at": "2023-12-01T05:00:00.401Z",
	"current_plan": {
		"billing_period": 42,
		"currency": "usd",
		"description": "Monthly access to all premium analytics dashboards and data exports.",
		"formatted_price": "$10.00",
		"id": "plan_xxxxxxxxxxxxx",
		"initial_price": 6.9,
		"plan_type": "renewal",
		"renewal_price": 6.9,
		"trial_period_days": 42
	},
	"customer_name": "Jane Doe",
	"due_date": "2023-12-01T05:00:00.401Z",
	"email_address": "customer@example.com",
	"fetch_invoice_token": "eyJhbGciOiJIUzI1NiJ9...",
	"id": "inv_xxxxxxxxxxxxxx",
	"line_items": [
		{
			"label": "Platform subscription",
			"position": 42,
			"quantity": 6.9,
			"total": 6.9,
			"unit_price": 6.9
		}
	],
	"mailing_address": {
		"city": "<string>",
		"country": "<string>",
		"line1": "<string>",
		"line2": "<string>",
		"name": "<string>",
		"phone": "<string>",
		"postal_code": "<string>",
		"state": "<string>"
	},
	"member": {
		"id": "<string>"
	},
	"number": "#0001",
	"pay_online_url": "<string>",
	"payment": {
		"id": "pay_xxxxxxxxxxxxxx"
	},
	"payment_processing": true,
	"product": {
		"id": "prod_xxxxxxxxxxxxx",
		"title": "Pickaxe Analytics"
	},
	"status": "draft",
	"subscription_billing_anchor_at": "2023-12-01T05:00:00.401Z",
	"updated_at": "2023-12-01T05:00:00.401Z",
	"user": {
		"email": "john.doe@example.com",
		"id": "user_xxxxxxxxxxxxx",
		"name": "John Doe",
		"username": "johndoe42"
	}
}
```

**automatically\_finalizes\_at** `string\<date-time\> | null` *required*

La fecha y hora en que la factura se finalizará automáticamente. Para charge\_automatically, activa un cargo automático. Para send\_invoice, envía el correo electrónico de la factura a la hora especificada.

Ejemplo: `2023-12-01T05:00:00.401Z`

**charge\_buyer\_fee** `boolean` *required*

Indica si la factura incluye una comisión de procesamiento para el comprador además del precio del plan.

**collection\_method** `InvoiceCollectionMethods` *required*

El método utilizado para cobrar el pago de esta factura, como el cargo automático o el pago manual.

Opciones disponibles: `send_invoice`, `charge_automatically`

**company** `object` *required*

La empresa que emitió esta factura.

**atributos secundarios**

**id** `string` *required*

El identificador único de la empresa.

Ejemplo: `biz_xxxxxxxxxxxxxx`

**logo** `object | null` *required*

El logotipo de la empresa.

**atributos secundarios**

**url** `string | null` *required*

Una URL preoptimizada para renderizar este adjunto en el cliente. Debe usarse para mostrar adjuntos en las apps.

Ejemplo: `https://media.whop.com/abc123/optimized.jpg`

**title** `string` *required*

El nombre visible de la empresa que se muestra a los clientes.

Ejemplo: `Pickaxe`

**created\_at** `string\<date-time\>` *required*

La fecha y hora en que se creó la factura.

Ejemplo: `2023-12-01T05:00:00.401Z`

**current\_plan** `object` *required*

El plan que cobra esta factura.

**atributos secundarios**

**billing\_period** `integer | null` *required*

Número de días entre cargos recurrentes, como 30 para mensual o 365 para anual. `null` para planes de pago único.

Ejemplo: `42`

**currency** `Currencies` *required*

La moneda utilizada para todos los precios de este plan (p. ej., 'usd', 'eur'). Todos los importes monetarios del plan se expresan en esta moneda.

Opciones disponibles: `usd`, `sgd`, `inr`, `aud`, `brl`, `cad`, `dkk`, `eur`, `nok`, `gbp`, `sek`, `chf`, `hkd`, `huf`, `jpy`, `mxn`, `myr`, `pln`, `czk`, `nzd`, `aed`, `eth`, `ape`, `cop`, `ron`, `thb`, `bgn`, `idr`, `dop`, `php`, `try`, `krw`, `twd`, `vnd`, `pkr`, `clp`, `uyu`, `ars`, `zar`, `dzd`, `tnd`, `mad`, `kes`, `kwd`, `jod`, `all`, `xcd`, `amd`, `bsd`, `bhd`, `bob`, `bam`, `khr`, `crc`, `xof`, `egp`, `etb`, `gmd`, `ghs`, `gtq`, `gyd`, `ils`, `jmd`, `mop`, `mga`, `mur`, `mdl`, `mnt`, `nad`, `ngn`, `mkd`, `omr`, `pyg`, `pen`, `qar`, `rwf`, `sar`, `rsd`, `lkr`, `tzs`, `ttd`, `uzs`, `rub`, `btc`, `cny`, `usdt`, `kzt`, `awg`, `whop_usd`, `xau`, `hnl`

**description** `string | null` *required*

Una descripción en texto del plan visible para los clientes. Máximo 1000 caracteres. Null si no hay descripción.

Ejemplo: `Monthly access to all premium analytics dashboards and da…`

**formatted\_price** `string` *required*

El precio formateado (incluida la moneda) del plan.

Ejemplo: `$10.00`

**id** `string` *required*

El identificador único del plan.

Ejemplo: `plan_xxxxxxxxxxxxx`

**initial\_price** `number` *required*

El precio de compra inicial en la base\_currency del plan (p. ej., 49.99 para \$49.99). Para planes de pago único, es el precio completo. Para planes de renovación, se cobra además del primer renewal\_price.

Ejemplo: `6.9`

**plan\_type** `PlanTypes` *required*

El modelo de facturación de este plan: 'renewal' para suscripciones recurrentes o 'one\_time' para pagos únicos.

Opciones disponibles: `renewal`, `one_time`

**renewal\_price** `number` *required*

El precio recurrente que se cobra en cada billing\_period en la base\_currency del plan (p. ej., 9.99 para \$9.99/periodo). Cero para planes de pago único.

Ejemplo: `6.9`

**trial\_period\_days** `integer | null` *required*

Días de prueba gratuita antes del primer cargo de renovación. `null` si no hay ninguna prueba configurada o si el usuario ya ha usado una prueba para este plan.

Ejemplo: `42`

**customer\_name** `string | null` *required*

El nombre completo del cliente al que va dirigida esta factura. Null si no hay ningún nombre registrado.

Ejemplo: `Jane Doe`

**due\_date** `string\<date-time\> | null` *required*

La fecha límite en la que se espera el pago. Null si la factura se cobra automáticamente.

Ejemplo: `2023-12-01T05:00:00.401Z`

**email\_address** `string | null` *required*

La dirección de correo electrónico del cliente al que va dirigida esta factura. Null si no hay ningún correo electrónico registrado.

Ejemplo: `customer@example.com`

**fetch\_invoice\_token** `string` *required*

Un token firmado que permite obtener los datos de la factura públicamente sin autenticación.

Ejemplo: `eyJhbGciOiJIUzI1NiJ9...`

**id** `string` *required*

El identificador único de la factura.

Ejemplo: `inv_xxxxxxxxxxxxxx`

**line\_items** `array\<object\>` *required*

Líneas de concepto opcionales que desglosan el total de la factura en cargos individuales.

**atributos secundarios**

**label** `string` *required*

La etiqueta o descripción de esta línea de concepto.

Ejemplo: `Platform subscription`

**position** `integer` *required*

El orden de visualización de esta línea de concepto dentro de la factura.

Ejemplo: `42`

**quantity** `number` *required*

La cantidad de esta línea de concepto.

Ejemplo: `6.9`

**total** `number` *required*

El total calculado de esta línea de concepto (quantity \* unit\_price).

Ejemplo: `6.9`

**unit\_price** `number` *required*

El precio unitario de esta línea de concepto. Negativo para un crédito o una deducción.

Ejemplo: `6.9`

**mailing\_address** `object | null` *required*

La dirección de facturación/postal asociada a esta factura, si se proporcionó en el momento de la creación.

**atributos secundarios**

**city** `string | null` *required*

La ciudad de la dirección.

**country** `string | null` *required*

El país de la dirección.

**line1** `string | null` *required*

La línea 1 de la dirección.

**line2** `string | null` *required*

La línea 2 de la dirección.

**name** `string | null` *required*

El nombre del cliente.

**phone** `string | null` *required*

El número de teléfono del cliente.

**postal\_code** `string | null` *required*

El código postal de la dirección.

**state** `string | null` *required*

El estado o provincia de la dirección.

**member** `object | null` *required*

El miembro para el que se creó la factura. Null cuando la factura va dirigida a una dirección de correo electrónico sin un registro de miembro asociado.

**atributos secundarios**

**id** `string` *required*

El identificador único del miembro de la empresa.

**number** `string` *required*

El número secuencial de la factura a efectos de visualización.

Ejemplo: `#0001`

**pay\_online\_url** `string | null` *required*

La URL de checkout donde el cliente puede pagar esta factura en línea, con su dirección de correo electrónico prerrellenada y bloqueada.

**payment** `object | null` *required*

El pago que liquidó esta factura. Null mientras la factura no está pagada, cuando la factura se marcó como pagada manualmente y en una factura de renovación de suscripción, donde aún no se puede identificar el pago que la liquida.

**atributos secundarios**

**id** `string` *required*

El identificador único del pago.

Ejemplo: `pay_xxxxxxxxxxxxxx`

**payment\_processing** `boolean` *required*

Indica si un pago de esta factura aún se está compensando. Es true mientras se liquida un método de pago diferido como ACH o SEPA, periodo durante el cual la factura permanece abierta y no se marca como vencida.

**product** `object` *required*

El producto para el que se generó esta factura.

**atributos secundarios**

**id** `string` *required*

El identificador único del producto.

Ejemplo: `prod_xxxxxxxxxxxxx`

**title** `string` *required*

El nombre visible del producto que se muestra a los clientes en la página del producto y en los resultados de búsqueda.

Ejemplo: `Pickaxe Analytics`

**status** `InvoiceStatuses` *required*

El estado de pago actual de la factura, como draft, open, paid o void.

Opciones disponibles: `draft`, `open`, `paid`, `past_due`, `uncollectible`, `void`

**subscription\_billing\_anchor\_at** `string\<date-time\> | null` *required*

La fecha que define cuándo comienza el ciclo de facturación de la suscripción. Cuando se establece en una factura de un plan de renovación, todos los periodos de facturación futuros se anclan a esta fecha.

Ejemplo: `2023-12-01T05:00:00.401Z`

**updated\_at** `string\<date-time\>` *required*

La fecha y hora en que se actualizó por última vez la factura.

Ejemplo: `2023-12-01T05:00:00.401Z`

**user** `object | null` *required*

El usuario al que va dirigida esta factura. Null si la cuenta de usuario se ha eliminado.

**atributos secundarios**

**email** `string | null` *required*

La dirección de correo electrónico del usuario. Requiere el permiso member:email:read para acceder. Null si no está autorizado.

Ejemplo: `john.doe@example.com`

**id** `string` *required*

El identificador único del usuario.

Ejemplo: `user_xxxxxxxxxxxxx`

**name** `string | null` *required*

El nombre visible del usuario que se muestra en su perfil público.

Ejemplo: `John Doe`

**username** `string` *required*

El nombre de usuario único que se muestra en su perfil público.

Ejemplo: `johndoe42`


## Related topics

- [Facturas](https://docs.whop.com/es/developer/guides/invoices.md)
- [Migra desde las facturas heredadas](https://docs.whop.com/es/developer/guides/migrate-from-legacy-invoices.md)
- [Versiones de la API](https://docs.whop.com/es/developer/api/versioning.md)
