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

> Los Deposits describen las formas de añadir fondos al saldo de una cuenta o de un usuario: una página de depósito alojada, instrucciones de transferencia bancaria y direcciones de billeteras cripto.

Usa la API de Deposits para obtener instrucciones de depósito para una cuenta o un usuario, como una dirección cripto a la que enviar fondos o los datos bancarios para una transferencia.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Crear Deposit](https://docs.whop.com/es/api-reference/deposits/create-deposit.md) | POST `/deposits` |
| [Revertir Deposit](https://docs.whop.com/es/api-reference/deposits/reverse-deposit.md) | POST `/deposits/{id}/reverse` |

## Atributos

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

ID de la cuenta del propietario de destino.

**amount** `string`

Importe de depósito solicitado.

**hosted\_url** `string | null` *required*

URL de la página de depósito alojada. Solo presente para destinos de empresa.

**methods** `object` *required*

Métodos de depósito disponibles para el destino.

> [accordion] Propiedades
>
> **bank** `object | null` *required*
>
> Datos de depósito bancario. Solo presentes cuando los depósitos bancarios están activos para la cuenta de destino.
>
> > [accordion] Propiedades
> >
> > **currencies** `object[]` *required*
> >
> > Monedas de transferencia bancaria disponibles para este depósito.
> >
> > > [accordion] Propiedades
> > >
> > > **account\_number** `string | null` *required*
> > >
> > > Número de cuenta bancaria para depósitos en esta moneda.
> > >
> > > **currency** `string` *required*
> > >
> > > Moneda admitida por estas instrucciones bancarias.
> > >
> > > **deposit\_bank\_address** `string | null` *required*
> > >
> > > Dirección del banco receptor.
> > >
> > > **deposit\_bank\_name** `string | null` *required*
> > >
> > > Nombre del banco receptor.
> > >
> > > **deposit\_beneficiary\_name** `string | null` *required*
> > >
> > > Nombre del beneficiario que se debe usar para la transferencia.
> > >
> > > **deposit\_reference** `string | null` *required*
> > >
> > > Referencia que se debe incluir con la transferencia bancaria.
> > >
> > > **rails** `string[]` *required*
> > >
> > > Rieles de depósito activos para esta moneda.
> > >
> > > Opciones disponibles: `ach`, `wire`, `sepa`, `fps`, `chaps`
> > >
> > > **routing\_number** `string | null` *required*
> > >
> > > Número de ruta bancaria para depósitos en esta moneda.
> > >
> > > **swift\_bic** `string | null` *required*
> > >
> > > SWIFT/BIC del banco intermediario a través del cual el banco emisor enruta una transferencia internacional. Null a menos que se proporcione `origin_bic` y haya un intermediario publicado para ese banco y esa moneda.
>
> **card** `object | null` *required*
>
> El cargo a un método de pago guardado. Null a menos que se haya pasado `payment_method_id`.
>
> > [accordion] Propiedades
> >
> > **metadata** `object | null` *required*
> >
> > Los metadatos personalizados adjuntos al pago que creó el cargo. Null si no se pasó ninguno.
> >
> > **payment\_id** `string` *required*
> >
> > El pago que creó el cargo, con el prefijo `pay_`. Recupéralo, o escucha `payment.succeeded`, para confirmar que llegaron los fondos.
> >
> > **payment\_method\_id** `string` *required*
> >
> > El método de pago guardado al que se cobró, con el prefijo `payt_`.
>
> **crypto** `object[]` *required*
>
> Redes cripto disponibles para este depósito, cada una con su dirección de depósito on-chain y los tokens aceptados en esa red. Los depósitos en cripto requieren un mínimo de \$10.
>
> > [accordion] Propiedades
> >
> > **deposit\_address** `string | null` *required*
> >
> > Dirección a la que enviar fondos en esta red. Null cuando el proveedor aún no ha emitido una.
> >
> > **icon\_url** `string | null` *required*
> >
> > URL del icono de la red.
> >
> > **name** `string` *required*
> >
> > Nombre para mostrar de la red.
> >
> > Opciones disponibles: `Ethereum`, `Solana`, `Bitcoin`, `Tron`, `Base`, `BNB Smart Chain`, `Hyperliquid`, `Hypercore`, `MegaETH`, `Polygon`, `Plasma`, `Arbitrum`
> >
> > **supported\_currencies** `object[]` *required*
> >
> > Tokens aceptados para depósito en esta red.
> >
> > > [accordion] Propiedades
> > >
> > > **icon\_url** `string | null` *required*
> > >
> > > URL del icono del token. Null cuando no hay icono disponible.
> > >
> > > **name** `string` *required*
> > >
> > > Símbolo del token.
> > >
> > > Opciones disponibles: `ARB`, `BNB`, `BTC`, `ETH`, `EURC`, `HYPE`, `PYUSD`, `SOL`, `TRX`, `USD1`, `USDC`, `USDC.e`, `USDG`, `USDT`, `USDT0`, `USDe`, `USDm`, `XO`, `XPL`, `pUSD`, `wETH`

**object** `string` *required*

```json Deposit theme={null}
{
	"account_id": "biz_xxxxxxxxxxxxxx",
	"amount": "250.00",
	"hosted_url": "https://whop.com/deposit/example/?amount=250.00",
	"methods": {
		"bank": {
			"currencies": [
				{
					"account_number": "123456789012",
					"currency": "usd",
					"deposit_bank_address": "885 Example Road, Teaneck, NJ 07666",
					"deposit_bank_name": "Example Bank",
					"deposit_beneficiary_name": "Example Business Inc.",
					"deposit_reference": "WHOPDEP123",
					"rails": ["ach", "wire"],
					"routing_number": "021000021",
					"swift_bic": "EXAMUS33XXX"
				}
			]
		},
		"card": null,
		"crypto": [
			{
				"deposit_address": "0x1234abcd5678ef901234abcd5678ef901234abcd",
				"icon_url": "https://whop.com/_static/images/crypto/ethereum.svg",
				"name": "Ethereum",
				"supported_currencies": [
					{
						"icon_url": "https://whop.com/_static/images/crypto/usdc.svg",
						"name": "USDC"
					}
				]
			}
		]
	},
	"object": "deposit"
}
```
