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

# API de Cards

> Las Cards representan tarjetas de pago virtuales que gastan del saldo de una cuenta o de un usuario.

Las tarjetas se pueden asignar a titulares y configurar con límites de gasto para un gasto controlado.

Usa la API de Cards para emitir tarjetas, listar las tarjetas de una cuenta o un usuario, recuperar los datos de una tarjeta activa, como el número de tarjeta y el CVC, y listar las transacciones realizadas con ellas.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar transacciones de tarjeta](https://docs.whop.com/es/api-reference/cards/list-card-transactions.md) | GET `/card_transactions` |
| [Recuperar transacción de tarjeta](https://docs.whop.com/es/api-reference/cards/retrieve-card-transaction.md) | GET `/card_transactions/{id}` |
| [Listar Cards](https://docs.whop.com/es/api-reference/cards/list-cards.md) | GET `/cards` |
| [Recuperar Card](https://docs.whop.com/es/api-reference/cards/retrieve-card.md) | GET `/cards/{id}` |
| [Crear Card](https://docs.whop.com/es/api-reference/cards/create-card.md) | POST `/cards` |
| [Actualizar Card](https://docs.whop.com/es/api-reference/cards/update-card.md) | PATCH `/cards/{id}` |

## Atributos

**id** `string` *required*

ID de la tarjeta, con el prefijo `icrd_`.

**billing** `object | null` *required*

La dirección de facturación.

> [accordion] Propiedades
>
> **city** `string | null` *required*
>
> Ciudad de facturación.
>
> **country\_code** `string | null` *required*
>
> Código de país de facturación.
>
> **line1** `string | null` *required*
>
> Línea 1 de la dirección.
>
> **line2** `string | null` *required*
>
> Línea 2 de la dirección.
>
> **postal\_code** `string | null` *required*
>
> Código postal de facturación.
>
> **region** `string | null` *required*
>
> Región o estado de facturación.

**canceled\_at** `string | null` *required*

Cuándo se canceló la tarjeta.

**created\_at** `string | null` *required*

Cuándo se creó la tarjeta.

**digital\_wallets** `string[] | null` *required*

Las billeteras digitales a las que se ha añadido la tarjeta. List Cards, Update Card y los payloads de webhooks devuelven `null`, al igual que Retrieve Card cuando no se pueden recuperar las billeteras.

Opciones disponibles: `apple_pay`, `google_pay`

**expiration\_month** `string | null` *required*

Mes de vencimiento de la tarjeta.

**expiration\_year** `string | null` *required*

Año de vencimiento de la tarjeta.

**issued** `boolean` *required*

`true` una vez que el emisor ha emitido la tarjeta. `false` para una tarjeta invitada que aún espera la incorporación o revisión de su titular, o una que el emisor rechazó; no tiene número de tarjeta hasta que se emite.

**last4** `string | null` *required*

Últimos cuatro dígitos del número de tarjeta. `null` para tarjetas con invitación pendiente.

**limit** `object | null` *required*

La configuración del límite de gasto.

> [accordion] Propiedades
>
> **amount** `number` *required*
>
> El importe del límite en dólares.
>
> **frequency** `string` *required*
>
> El periodo al que se aplica el importe del límite. `per_transaction` limita cada autorización individual y es lo que informa un límite establecido con `transaction_limit`.
>
> Opciones disponibles: `daily`, `weekly`, `monthly`, `one_time`, `per_transaction`

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

Nombre para mostrar de la tarjeta.

**object** `string` *required*

**secrets** `object | null`

Datos confidenciales de la tarjeta. Presente solo en `GET /cards/:id` para tarjetas activas; `null` cuando la tarjeta está inactiva o no se pueden recuperar los datos.

> [accordion] Propiedades
>
> **card\_number** `string` *required*
>
> Número completo de la tarjeta.
>
> **cvc** `string` *required*
>
> Código de verificación de la tarjeta.
>
> **name\_on\_card** `string | null` *required*
>
> Nombre del titular impreso en la tarjeta.
>
> **pin** `string | null` *required*
>
> El PIN de la tarjeta. Solo se devuelve cuando la solicitud está autenticada como el usuario al que está asignada la tarjeta; `null` para todos los demás llamadores, incluidas las claves de API de cuenta.

**spent\_last\_month** `integer | null` *required*

Gasto total en los últimos 30 días, en centavos.

**status** `string | null` *required*

El estado de la tarjeta. `denied` significa que el emisor rechazó al titular, por lo que la tarjeta nunca se emitirá.

Opciones disponibles: `active`, `frozen`, `canceled`, `invited`, `denied`

**type** `string | null` *required*

El tipo de tarjeta.

Opciones disponibles: `virtual`, `physical`

**user\_id** `string | null` *required*

ID de usuario del titular, con el prefijo `user_`, cuando está asignada.

```json Card theme={null}
{
	"id": "icrd_xxxxxxxxxxxxx",
	"billing": {
		"city": "New York",
		"country_code": "US",
		"line1": "123 Spring Street",
		"line2": "Suite 4",
		"postal_code": "10012",
		"region": "NY"
	},
	"canceled_at": null,
	"created_at": "2026-06-01T12:00:00Z",
	"digital_wallets": ["apple_pay"],
	"expiration_month": "12",
	"expiration_year": "2029",
	"issued": true,
	"last4": "4242",
	"limit": {
		"amount": 500,
		"frequency": "daily"
	},
	"name": "Operations Card",
	"object": "card",
	"secrets": {
		"card_number": "4242424242424242",
		"cvc": "123",
		"name_on_card": "Pickaxe Operations",
		"pin": "1234"
	},
	"spent_last_month": 12500,
	"status": "active",
	"type": "virtual",
	"user_id": "user_xxxxxxxxxxxxx"
}
```


## Related topics

- [Versiones de la API](https://docs.whop.com/es/developer/api/versioning.md)
- [Estabilidad de la API](https://docs.whop.com/es/api-reference/stability.md)
- [API de actividad financiera](https://docs.whop.com/es/api-reference/ledgers/ledger-activity.md)
