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

# Deposits API

> 입금(Deposit)은 계정 또는 사용자 잔액에 자금을 추가하는 방법을 설명합니다. 호스팅된 입금 페이지, 은행 송금 안내, 암호화폐 지갑 주소가 포함됩니다.

Deposits API를 사용하여 계정 또는 사용자의 입금 안내를 받을 수 있습니다. 예를 들어 자금을 보낼 암호화폐 주소나 송금을 위한 은행 정보를 확인할 수 있습니다.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [입금 생성](https://docs.whop.com/ko/api-reference/deposits/create-deposit.md) | POST `/deposits` |
| [입금 취소](https://docs.whop.com/ko/api-reference/deposits/reverse-deposit.md) | POST `/deposits/{id}/reverse` |

## 속성

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

대상 소유자의 계정 ID입니다.

**amount** `string`

요청된 입금 금액입니다.

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

호스팅된 입금 페이지의 URL입니다. 비즈니스 대상에만 존재합니다.

**methods** `object` *required*

대상에 사용 가능한 입금 수단입니다.

> [accordion] 속성
>
> **bank** `object | null` *required*
>
> 은행 입금 세부 정보입니다. 대상 계정에 은행 입금이 활성화된 경우에만 존재합니다.
>
> > [accordion] 속성
> >
> > **currencies** `object[]` *required*
> >
> > 이 입금에 사용 가능한 은행 송금 통화입니다.
> >
> > > [accordion] 속성
> > >
> > > **account\_number** `string | null` *required*
> > >
> > > 이 통화로 입금할 은행 계좌 번호입니다.
> > >
> > > **currency** `string` *required*
> > >
> > > 이 은행 안내에서 지원하는 통화입니다.
> > >
> > > **deposit\_bank\_address** `string | null` *required*
> > >
> > > 수취 은행 주소입니다.
> > >
> > > **deposit\_bank\_name** `string | null` *required*
> > >
> > > 수취 은행 이름입니다.
> > >
> > > **deposit\_beneficiary\_name** `string | null` *required*
> > >
> > > 송금 시 사용할 수취인 이름입니다.
> > >
> > > **deposit\_reference** `string | null` *required*
> > >
> > > 은행 송금 시 포함할 참조 번호입니다.
> > >
> > > **rails** `string[]` *required*
> > >
> > > 이 통화의 활성 입금 레일입니다.
> > >
> > > 사용 가능한 옵션: `ach`, `wire`, `sepa`, `fps`, `chaps`
> > >
> > > **routing\_number** `string | null` *required*
> > >
> > > 이 통화로 입금할 은행 라우팅 번호입니다.
> > >
> > > **swift\_bic** `string | null` *required*
> > >
> > > 송금 은행이 국제 송금을 중계할 때 거치는 중개 은행의 SWIFT/BIC입니다. `origin_bic`이 제공되고 해당 은행과 통화에 대한 중개 은행이 공개된 경우가 아니면 null입니다.
>
> **card** `object | null` *required*
>
> 저장된 결제 수단에 대한 청구입니다. `payment_method_id`가 전달되지 않은 경우 null입니다.
>
> > [accordion] 속성
> >
> > **metadata** `object | null` *required*
> >
> > 청구로 생성된 결제에 첨부된 사용자 지정 메타데이터입니다. 전달되지 않은 경우 null입니다.
> >
> > **payment\_id** `string` *required*
> >
> > 청구로 생성된 결제로, 접두사는 `pay_`입니다. 자금이 입금되었는지 확인하려면 결제를 조회하거나 `payment.succeeded`를 수신하세요.
> >
> > **payment\_method\_id** `string` *required*
> >
> > 청구된 저장된 결제 수단으로, 접두사는 `payt_`입니다.
>
> **crypto** `object[]` *required*
>
> 이 입금에 사용 가능한 암호화폐 네트워크로, 각각 온체인 입금 주소와 해당 네트워크에서 허용되는 토큰을 포함합니다. 암호화폐 입금은 최소 \$10이 필요합니다.
>
> > [accordion] 속성
> >
> > **deposit\_address** `string | null` *required*
> >
> > 이 네트워크에서 자금을 보낼 주소입니다. 제공업체가 아직 발급하지 않은 경우 null입니다.
> >
> > **icon\_url** `string | null` *required*
> >
> > 네트워크 아이콘 URL입니다.
> >
> > **name** `string` *required*
> >
> > 네트워크 표시 이름입니다.
> >
> > 사용 가능한 옵션: `Ethereum`, `Solana`, `Bitcoin`, `Tron`, `Base`, `BNB Smart Chain`, `Hyperliquid`, `Hypercore`, `MegaETH`, `Polygon`, `Plasma`, `Arbitrum`
> >
> > **supported\_currencies** `object[]` *required*
> >
> > 이 네트워크에서 입금이 허용되는 토큰입니다.
> >
> > > [accordion] 속성
> > >
> > > **icon\_url** `string | null` *required*
> > >
> > > 토큰 아이콘 URL입니다. 사용 가능한 아이콘이 없으면 null입니다.
> > >
> > > **name** `string` *required*
> > >
> > > 토큰 심볼입니다.
> > >
> > > 사용 가능한 옵션: `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"
}
```
