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

# Financing Applications API

> Financing Application은 선구매 후결제(BNPL)와 같은 결제 금융 수단을 받기 위한 계정의 신청입니다.

Whop은 계정이 이러한 수단을 제공하기 전에 해당 계정을 검토합니다. 이는 대출이나 사업 자금이 아닙니다.

Financing Applications API를 사용하여 신청서를 [생성](https://docs.whop.com/ko/api-reference/financing-applications/create-financing-application.md)하고, 요구 사항에 대한 [답변을 저장](https://docs.whop.com/ko/api-reference/financing-applications/update-financing-application.md)하고, 검토를 위해 [제출](https://docs.whop.com/ko/api-reference/financing-applications/submit-financing-application.md)할 수 있습니다. 본인 계정과 직속 하위 계정의 신청서를 관리할 수 있습니다.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [Financing Application 목록 조회](https://docs.whop.com/ko/api-reference/financing-applications/list-financing-applications.md) | GET `/financing_applications` |
| [Financing Application 조회](https://docs.whop.com/ko/api-reference/financing-applications/retrieve-financing-application.md) | GET `/financing_applications/{id}` |
| [Financing Application 생성](https://docs.whop.com/ko/api-reference/financing-applications/create-financing-application.md) | POST `/financing_applications` |
| [Financing Application 제출](https://docs.whop.com/ko/api-reference/financing-applications/submit-financing-application.md) | POST `/financing_applications/{id}/submit` |
| [Financing Application 업데이트](https://docs.whop.com/ko/api-reference/financing-applications/update-financing-application.md) | PATCH `/financing_applications/{id}` |

## 속성

**id** `string` *required*

inrq\_로 시작하는 금융 신청 ID입니다.

**account\_id** `string` *required*

결제 금융을 신청하는 판매자 계정의 ID이며, biz\_로 시작합니다.

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

신청서가 생성된 시각이며, ISO 8601 타임스탬프입니다.

**feedback** `string | null`

추가 정보가 요청되거나 신청이 거부된 경우의 공개 검토 피드백입니다. 내부 메모는 포함되지 않습니다.

**requirements** `object[]`

판매자 요구 사항과 저장된 답변입니다. 개별 신청서 응답에 포함되며, 목록에서는 생략됩니다. 동의는 제출 시 별도로 수집됩니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 이 신청서의 답변을 업데이트할 때 사용할 요구 사항 ID입니다.
>
> **accepted\_file\_formats** `string[]` *required*
>
> 허용되는 문서 형식입니다(예: pdf 또는 jpeg).
>
> **field** `string` *required*
>
> 요청되는 정보입니다(예: business\_description 또는 processing\_statements).
>
> **file\_collection\_type** `string` *required*
>
> 요구 사항이 파일을 받지 않는지, 하나의 파일을 받는지, 여러 파일을 받는지 여부입니다.
>
> 사용 가능한 옵션: `none`, `single`, `multi`
>
> **files** `object[]` *required*
>
> 이 요구 사항에 첨부된 파일이며, 만료되는 다운로드 URL을 포함합니다.
>
> > [accordion] 속성
> >
> > **id** `string` *required*
> >
> > 파일의 ID이며, `file_` 접두사로 시작합니다.
> >
> > **blurhash** `string | null` *required*
> >
> > 이미지 또는 동영상의 BlurHash 플레이스홀더입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
> >
> > **content\_type** `string | null` *required*
> >
> > 원본 파일의 MIME 유형입니다(예: `application/pdf`). 모더레이션으로 파일이 제거되어도 유지됩니다.
> >
> > **created\_at** `string` *required*
> >
> > 파일이 생성된 시각이며, ISO 8601 타임스탬프입니다.
> >
> > **duration\_seconds** `number | null` *required*
> >
> > 오디오 또는 동영상의 재생 시간(초)입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
> >
> > **filename** `string | null` *required*
> >
> > 확장자를 포함한 원본 파일 이름입니다.
> >
> > **height** `integer | null` *required*
> >
> > 이미지 또는 동영상의 높이(픽셀)입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
> >
> > **multipart\_chunk\_size** `integer | null`
> >
> > 각 파트(마지막 파트 제외)가 가져야 하는 바이트 크기입니다. 생성 시에만, 그리고 멀티파트 업로드에서만 포함됩니다.
> >
> > **multipart\_upload\_id** `string | null`
> >
> > 멀티파트 업로드의 ID이며, `complete`에 다시 전달합니다. 생성 시에만, 그리고 멀티파트 업로드에서만 포함됩니다.
> >
> > **multipart\_upload\_urls** `object[] | null`
> >
> > 각 파트의 미리 서명된 URL입니다. 생성 시에만, 그리고 멀티파트 업로드에서만 포함됩니다.
> >
> > > [accordion] 속성
> > >
> > > **part\_number** `integer` *required*
> > >
> > > 멀티파트 업로드 내에서 이 파트의 인덱스(1부터 시작)입니다.
> > >
> > > **url** `string` *required*
> > >
> > > 이 파트의 바이트를 PUT할 미리 서명된 URL입니다.
> >
> > **object** `string` *required*
> >
> > 이 객체의 유형이며, 항상 `file`입니다.
> >
> > **removed\_by\_moderation** `boolean` *required*
> >
> > 모더레이션으로 파일이 제거되었는지 여부입니다. `true`이면 `url`은 대체 이미지를 제공합니다. `filename`, `size`, `content_type`은 여전히 원본 파일을 설명합니다.
> >
> > **size** `integer | null` *required*
> >
> > 파일 크기(바이트)입니다. 업로드가 완료될 때까지 `null`입니다.
> >
> > **upload\_headers** `object`
> >
> > 업로드 PUT 요청과 함께 보낼 헤더입니다. 생성 시에만 포함됩니다.
> >
> > **upload\_status** `string` *required*
> >
> > 파일의 업로드 수명 주기상 현재 위치입니다.
> >
> > 사용 가능한 옵션: `pending`, `processing`, `ready`, `failed`
> >
> > **upload\_url** `string | null`
> >
> > 파일의 바이트를 PUT할 미리 서명된 URL입니다. 생성 시에만, 그리고 단일 파트 업로드에서만 포함됩니다.
> >
> > **url** `string | null` *required*
> >
> > 파일을 다운로드할 URL입니다. 공개 파일은 영구 CDN URL을, 비공개 파일은 만료되는 서명된 URL을 받습니다. 업로드가 완료될 때까지 `null`입니다. 모더레이션으로 파일이 제거된 경우 대체 이미지 URL입니다.
> >
> > **visibility** `string` *required*
> >
> > `public` 파일은 서명되지 않은 CDN URL에서 제공됩니다. `private` 파일은 만료되는 서명된 URL에서 제공됩니다.
> >
> > 사용 가능한 옵션: `public`, `private`
> >
> > **waveform\_url** `string | null` *required*
> >
> > 오디오 파형 URL입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
> >
> > **width** `integer | null` *required*
> >
> > 이미지 또는 동영상의 너비(픽셀)입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **max\_file\_size** `integer` *required*
>
> 업로드되는 각 문서의 최대 크기(바이트)입니다.
>
> **minimum\_length** `integer | null` *required*
>
> 지정된 경우, 텍스트 답변당 최소 글자 수입니다.
>
> **money** `object | null` *required*
>
> 원래 통화로 저장된 최대 상품 가격입니다. 답변하지 않았거나 저장된 레거시 답변이 유효하지 않은 경우 Null입니다.
>
> > [accordion] 속성
> >
> > **amount** `string` *required*
> >
> > 주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> >
> > **currency** `string` *required*
> >
> > 소문자로 된 세 글자 ISO 4217 통화 코드입니다.
> >
> > **decimals** `integer` *required*
> >
> > 금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
> >
> > **display\_decimals** `integer` *required*
> >
> > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
>
> **options** `string[]` *required*
>
> 허용되는 드롭다운 값입니다. 답변이 열거형이 아니면 비어 있습니다.
>
> **required** `boolean` *required*
>
> 제출 전에 이 요구 사항을 반드시 완료해야 하는지 여부입니다.
>
> **text\_collection\_type** `string` *required*
>
> 요구 사항이 텍스트를 받지 않는지, 하나의 값을 받는지, 여러 값을 받는지 여부입니다.
>
> 사용 가능한 옵션: `none`, `single`, `multi`
>
> **text\_format** `string` *required*
>
> 예상되는 텍스트 형식입니다. max\_product\_price는 values 대신 money를 사용합니다.
>
> 사용 가능한 옵션: `plain`, `url`, `email`, `phone`, `number`, `checkbox`, `dropdown`
>
> **values** `string[]` *required*
>
> 저장된 텍스트 답변입니다. 금액 요구 사항의 경우 비어 있으며, 이 경우 `money`를 읽으세요.

**status** `string` *required*

신청서의 검토 상태입니다. 승인 자체가 계정에서 금융 결제 수단이 활성화되었음을 의미하지는 않습니다.

사용 가능한 옵션: `requires_collection`, `awaiting_review`, `completed`, `approved`, `denied`

**terms** `object`

제출 전에 제시할 현재 약관입니다. 개별 신청서 응답에 포함됩니다.

> [accordion] 속성
>
> **content** `string` *required*
>
> 이 버전이 적용되는 정확한 일반 텍스트 계약 스냅샷입니다. 동의를 수집하기 전에 이 내용, 정책, 고지 사항을 제시하세요.
>
> **disclosure** `string` *required*
>
> 판매자에게 제시할 명시적 동의 문구입니다.
>
> **fees\_url** `string` *required*
>
> 추가 금융 수수료 정보입니다.
>
> **policies** `string[]` *required*
>
> 동의를 수집하기 전에 계약과 함께 제시할 금융 정책입니다.
>
> **url** `string` *required*
>
> Splitit 계약 스냅샷의 출처 URL입니다.
>
> **version** `string` *required*
>
> 제출 시 merchant\_acceptance.terms\_version으로 전달할 콘텐츠 지문입니다.

**updated\_at** `string` *required*

신청서가 마지막으로 업데이트된 시각이며, ISO 8601 타임스탬프입니다.

```json FinancingApplication theme={null}
{
	"id": "inrq_xxxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"status": "requires_collection",
	"feedback": null,
	"requirements": [
		{
			"id": "inrqi_yyyyyyyyyyyyyy",
			"field": "processing_statements",
			"required": true,
			"text_collection_type": "none",
			"file_collection_type": "multi",
			"text_format": "plain",
			"values": [],
			"money": null,
			"files": [
				{
					"id": "file_xxxxxxxxxxxxxx",
					"object": "file",
					"filename": "processing-statements-q3.pdf",
					"content_type": "application/pdf",
					"size": 482113,
					"url": "https://whop-assets-example.s3.amazonaws.com/uploads/processing-statements-q3.pdf",
					"removed_by_moderation": false,
					"upload_status": "ready",
					"visibility": "private",
					"created_at": "2026-10-21T08:29:00.000Z",
					"width": null,
					"height": null,
					"blurhash": null,
					"duration_seconds": null,
					"waveform_url": null
				}
			],
			"minimum_length": null,
			"options": [],
			"accepted_file_formats": ["pdf", "png", "jpg"],
			"max_file_size": 20971520
		}
	],
	"terms": {
		"version": "2026-09-01",
		"url": "https://whop.com/splitit-terms/",
		"fees_url": "https://docs.whop.com/fees",
		"disclosure": "I have read and agree to the Splitit Retail Installment Contract terms.",
		"policies": [
			"All Resolution Center cases for financed transactions will be decided by Whop."
		],
		"content": "We are a retailer that offers installment payments through Splitit."
	},
	"created_at": "2026-10-20T12:00:00.000Z",
	"updated_at": "2026-10-21T08:30:00.000Z"
}
```
