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

> Un Transfer mueve dinero entre saldos de Whop: de una cuenta o usuario a otro, de la billetera de una cuenta a una persona o dirección, o a un enlace de reclamo que cualquiera con la URL puede canjear.

Usa la API de Transfers para enviar dinero, encontrar destinatarios a los que puedes pagar, listar y obtener transferencias al conciliar movimientos de dinero, y previsualizar o canjear enlaces de reclamo.

Suscríbete a `transfer.completed` y `transfer.failed` para conocer los resultados en lugar de consultar periódicamente. Cada cuenta participante puede suscribirse a estos eventos. `transfer.created` también se emite cuando se completa correctamente, no cuando empieza el procesamiento. Una transferencia fallida puede reintentarse con el mismo ID y completarse más tarde; obtén la transferencia para conciliar su estado actual.

Una transferencia de saldo completada acredita el saldo disponible del destinatario, a menos que se aplique una fecha de liberación. Las transferencias financiadas con saldo pendiente conservan una fecha de liberación y acreditan el saldo pendiente; las reservas del destinatario o las retenciones por fraude aplicables pueden mantener los fondos no disponibles. `succeeded` confirma que la transferencia se completó, no que todos los fondos se puedan retirar.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Obtener enlace de reclamo](https://docs.whop.com/es/api-reference/transfers/retrieve-claim-link.md) | GET `/claim_links/{id}` |
| [Listar Transfers](https://docs.whop.com/es/api-reference/transfers/list-transfers.md) | GET `/transfers` |
| [Obtener Transfer](https://docs.whop.com/es/api-reference/transfers/retrieve-transfer.md) | GET `/transfers/{id}` |
| [Listar destinatarios de transferencias](https://docs.whop.com/es/api-reference/transfers/list-transfer-recipients.md) | GET `/transfers/recipients` |
| [Reclamar](https://docs.whop.com/es/api-reference/transfers/claim.md) | POST `/claim_links/{id}/claim` |
| [Crear Transfer](https://docs.whop.com/es/api-reference/transfers/create-transfer.md) | POST `/transfers` |

## Atributos

**id** `string` *required*

ID de la transferencia.

**amount** `object | null` *required*

Importe acreditado al destinatario. Es null mientras la transferencia no se haya completado correctamente.

> [accordion] Propiedades
>
> **amount** `string` *required*
>
> El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"`
> son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
>
> **currency** `string` *required*
>
> Código de divisa ISO 4217 de tres letras, en minúsculas.
>
> **decimals** `integer` *required*
>
> Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta
> el propio cargo.
>
> **display\_decimals** `integer` *required*
>
> Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.

**created\_at** `string` *required*

Cuándo se creó la transferencia.

**destination** `object | null` *required*

Cuenta de negocio o usuario que recibe la transferencia.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la cuenta o del usuario.
>
> **logo\_url** `string | null` *required*
>
> URL del logo del negocio o del avatar del usuario. Es null cuando no hay ninguna imagen disponible.
>
> **name** `string | null` *required*
>
> Nombre visible del negocio o del usuario.
>
> **object** `string` *required*
>
> Si el perfil es una cuenta de negocio o un usuario.
>
> Opciones disponibles: `account`, `user`

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

Hora de fallo registrada. Es null a menos que la transferencia haya fallado.

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

Código de fallo legible por máquina. Es null a menos que la transferencia haya fallado.

**failure\_reason** `string | null` *required*

Explicación del fallo. Es null a menos que la transferencia haya fallado.

**fee** `object | null` *required*

Todas las comisiones de transferencia aplicables, incluido el recargo de la plataforma. Es null cuando el total autoritativo no está disponible.

> [accordion] Propiedades
>
> **amount** `string` *required*
>
> El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"`
> son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
>
> **currency** `string` *required*
>
> Código de divisa ISO 4217 de tres letras, en minúsculas.
>
> **decimals** `integer` *required*
>
> Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta
> el propio cargo.
>
> **display\_decimals** `integer` *required*
>
> Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.

**metadata** `object` *required*

Metadatos personalizados adjuntos a la transferencia.

**notes** `string | null` *required*

Nota de la transferencia.

**object** `string` *required*

El tipo de objeto.

**origin** `object | null` *required*

Cuenta de negocio o usuario que envía la transferencia.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la cuenta o del usuario.
>
> **logo\_url** `string | null` *required*
>
> URL del logo del negocio o del avatar del usuario. Es null cuando no hay ninguna imagen disponible.
>
> **name** `string | null` *required*
>
> Nombre visible del negocio o del usuario.
>
> **object** `string` *required*
>
> Si el perfil es una cuenta de negocio o un usuario.
>
> Opciones disponibles: `account`, `user`

**status** `string` *required*

Estado actual de la transferencia. Una transferencia puede crearse en `processing` y liquidarse unos segundos después; consulta periódicamente Retrieve Transfer o escucha los webhooks `transfer.completed` y `transfer.failed` en lugar de tratar la respuesta de creación como definitiva. `succeeded` y `failed` son estados finales.

Opciones disponibles: `processing`, `succeeded`, `failed`

**status\_changed\_at** `string | null` *required*

Hora registrada de la transición actual. Es null cuando se desconoce la hora de la
transición histórica.

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

Hora registrada en que se completó correctamente. Es null cuando se desconoce.

**tracking\_url** `string` *required*

Página de seguimiento de la transferencia. Para verla es necesario iniciar sesión y tener acceso a la
transferencia.

```json Transfer theme={null}
{
	"id": "ctt_xxxxxxxxxxxxxx",
	"object": "transfer",
	"status": "succeeded",
	"origin": {
		"id": "biz_xxxxxxxxxxxxxx",
		"object": "account",
		"name": "Pickaxe",
		"logo_url": null
	},
	"destination": {
		"id": "user_xxxxxxxxxxxxx",
		"object": "user",
		"name": "Alex Rivera",
		"logo_url": null
	},
	"amount": {
		"amount": "50.00",
		"currency": "usd",
		"decimals": 2,
		"display_decimals": 2
	},
	"fee": {
		"amount": "1.00",
		"currency": "usd",
		"decimals": 2,
		"display_decimals": 2
	},
	"created_at": "2026-06-01T12:00:00.000Z",
	"status_changed_at": null,
	"succeeded_at": null,
	"failed_at": null,
	"failure_code": null,
	"failure_reason": null,
	"notes": "Creator bonus",
	"metadata": {
		"external_transfer_id": "transfer_123"
	},
	"tracking_url": "https://whop.com/ctt_xxxxxxxxxxxxxx/"
}
```


## Related topics

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