> ## 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를 통해 결제 세션별로 재정의할 수 있습니다.

> [card] [결제 플레이그라운드 사용해 보기](https://whop.com/checkout-playground)
>
> 적용하기 전에 실제 결제 화면에서 배경 색상, 버튼 색상, 글꼴, 테두리 스타일을 미리 확인하세요.

## 사용자 지정할 수 있는 항목

| 설정 | 설명 |
| - | - |
| **배경 색상** | 결제 페이지의 주문 요약 패널에 적용되는 16진수 색상 코드(예: `#F4F4F5`) |
| **버튼 색상** | 버튼 색상에 사용할 16진수 색상 코드(예: `#FF5733`) |
| **글꼴** | `system`(기본값), `roboto` 또는 `open_sans` |
| **테두리 스타일** | `rounded`(기본값), `pill` 또는 `rectangular` |

## 전역 브랜딩

전역 브랜딩은 비즈니스의 모든 결제 링크에 적용됩니다. 개별 링크는 자체 재정의가 없는 한 이 설정을 상속합니다.

1. **Dashboard** > **Settings** > **Checkout Branding**으로 이동합니다
2. **배경 색상**, **버튼 색상**, **글꼴**, **테두리 스타일**을 선택합니다
3. 실시간 미리보기로 결제 페이지가 어떻게 보이는지 확인합니다
4. **Save**를 선택합니다

## 링크별 재정의

특정 결제 링크에서 전역 브랜딩을 재정의합니다. 특정 상품이나 캠페인에 다른 디자인이 필요할 때 유용합니다.

1. **Dashboard** > **Checkout Links**로 이동합니다
2. 사용자 지정할 결제 링크를 편집합니다
3. **Checkout branding** 섹션에서 원하는 설정을 조정합니다
4. 변경 사항을 저장합니다

**Global default**로 남겨 둔 설정은 계정 브랜딩을 상속합니다. 명시적으로 변경한 설정만 해당 링크에서 재정의됩니다.

> [!NOTE]
>
> 링크별 브랜딩은 전역 브랜딩보다 우선합니다. 나중에 전역 설정을 업데이트해도
> 자체 재정의가 있는 링크는 재정의된 설정에 대해 사용자 지정 값을
> 유지합니다.

## 개별 결제 세션 사용자 지정

결제 세션을 만들 때 `checkoutStyling` 매개변수를 사용하여 개별 결제 세션에 브랜딩을 설정합니다. 세션 수준 브랜딩이 가장 높은 우선순위를 가집니다.

적용 순서는 **결제 세션** > **결제 링크(플랜)** > **계정 기본값**입니다.

```graphql theme={null}
mutation {
	createCheckoutSession(
		input: {
			planId: "plan_XXXXXXXXX"
			checkoutStyling: {
				backgroundColor: "#F4F4F5"
				buttonColor: "#FF5733"
				fontFamily: roboto
				borderStyle: pill
			}
		}
	) {
		id
		purchaseUrl
		checkoutStyling {
			backgroundColor
			buttonColor
			fontFamily
			borderStyle
		}
	}
}
```

### 매개변수

| 필드 | 유형 | 설명 |
| - | - | - |
| `backgroundColor` | String | 16진수 색상 코드(예: `#F4F4F5`). 상속하려면 `null`. |
| `buttonColor` | String | 16진수 색상 코드(예: `#FF5733`). 상속하려면 `null`. |
| `fontFamily` | enum | `system`, `roboto` 또는 `open_sans`. 상속하려면 `null`. |
| `borderStyle` | enum | `rounded`, `pill` 또는 `rectangular`. 상속하려면 `null`. |

어떤 필드든 `null`을 전달하면 적용 순서상 다음 수준의 값을 상속합니다.

## 알고 있는 이메일 주소 추가

URL 매개변수를 사용하여 결제 페이지의 이메일 필드를 제어합니다. 랜딩 페이지나 고객 관계 관리(CRM) 시스템에서 이미 고객의 이메일을 알고 있을 때 유용합니다. 이메일 주소를 다시 수집하지 않아도 됩니다.

| 매개변수 | 효과 |
| - | - |
| `email` | 이메일 필드를 채웁니다 |
| `email.disabled=1` | 고객이 편집할 수 없도록 이메일 필드를 잠급니다 |
| `email.hidden=1` | 이메일 필드를 완전히 숨깁니다 |

### 예시

미리 채우고 잠그기:

```
https://whop.com/checkout/plan_XXXXXXXXX?email=customer@example.com&email.disabled=1
```

미리 채우고 숨기기:

```
https://whop.com/checkout/plan_XXXXXXXXX?email=customer@example.com&email.hidden=1
```

> [!NOTE]
>
> `email.hidden` 또는 `email.disabled`를 사용하려면 `email` 매개변수를 제공하세요. 두 옵션을
> 모두 사용하면 결제 페이지에서 필드가 숨겨집니다.

자체 사이트에 [Checkout 엘리먼트](https://docs.whop.com/ko/elements/latest/checkout/checkout.md)를 마운트하는 경우 `buyerEmail`을 전달하여 주소를 미리 채우고 `lockBuyerEmail`을 전달하여 구매자가 편집하지 못하게 할 수 있습니다.

## 알고 있는 전화번호 및 주소 추가

URL 매개변수로 고객의 전화번호, 청구 정보, 배송 주소를 채웁니다. 고객은 미리 채워진 모든 필드를 계속 편집할 수 있습니다.

| 매개변수 | 효과 |
| - | - |
| `phone` | 전화번호를 채웁니다. 청구 전화번호가 필요한 결제 수단의 경우 청구 전화번호도 포함됩니다 |
| `name` | 청구 이름을 채웁니다 |
| `address.line1`, `address.line2`, `address.city` | 청구 주소를 채웁니다 |
| `address.state`, `address.postal_code`, `address.country` | 청구 주소를 채웁니다 |
| `shipping.name` | 배송 수령인의 이름을 채웁니다 |
| `shipping.address.line1`, `shipping.address.city`, … | 청구 주소와 동일한 필드로 배송 주소를 채웁니다 |

`phone`에는 국가 코드를 포함하고 더하기 기호는 `%2B`로 인코딩하세요(예: `phone=%2B14155552671`). `country`에는 `US`와 같은 두 글자 국가 코드를 사용하세요.

### 예시

```
https://whop.com/checkout/plan_XXXXXXXXX?email=customer@example.com&phone=%2B14155552671&name=Ada+Lovelace&address.country=US&address.postal_code=94107
```

## 고객 이메일

Whop은 고객에게 구매 및 구독에 관한 이메일을 보냅니다. 발신자 이름은 비즈니스 이름 뒤에 **via Whop**이 붙은 형식입니다(예: **Acme via Whop**). 발신자 주소는 `no-reply@businesses.whop.com`입니다. 비즈니스 로고를 추가한 경우 각 이메일 상단에 표시됩니다.

플랫폼이 API를 통해 만든 하위 계정은 고객 이메일이 꺼진 상태로 시작합니다. 플랫폼은 `send_customer_emails` 필드로 이를 켤 수 있습니다.

| 이메일 | Whop이 보내는 시점 |
| - | - |
| **주문 확인** | 일회성 구매 또는 멤버십의 첫 결제 후. 무료 구매에는 발송되지 않습니다. |
| **갱신 영수증** | 무료 체험 후 첫 청구를 포함한 모든 갱신 청구 후, 그리고 플랜 변경에 따른 청구 후. 금액, Whop이 보유한 경우 카드 명세서 표시명, 카드 업데이트 또는 취소 링크가 표시됩니다. |
| **갱신 예정** | 구독이 갱신되기 전, 결제 주기마다 한 번. 7일보다 긴 무료 체험은 첫 청구 7일 전에 받습니다. 6개월 이상 간격으로 청구되는 플랜은 갱신 30일 전에 받습니다. 그 외에는 갱신 약 24시간 전에 받습니다. 멤버가 취소했거나 결제를 일시 중지한 경우 Whop은 이 이메일을 보내지 않습니다. |
| **결제 실패** | 구독 결제가 실패하고 [Whop이 재시도할 때](https://docs.whop.com/ko/payments/payment-declines.md). 멤버십을 취소시키는 마지막 실패 시도에는 보내지 않습니다. PayPal 같은 일부 결제 수단에는 이 이메일이 발송되지 않습니다. |
| **멤버십 취소** | 결제 주기가 끝날 때까지 액세스가 유지되더라도, 판매자 또는 멤버가 멤버십을 취소할 때. |
| **환불** | 결제를 환불할 때. |

무료 체험의 경우 갱신 예정 이메일이 체험 종료 알림입니다. Whop은 별도의 환영 이메일을 보내지 않습니다. 새 멤버에게 이메일로 환영 인사를 보내려면 [**User joins** 메시지](https://docs.whop.com/ko/manage-your-business/growth-marketing/automated-messaging.md)를 설정하고 **Send email to user when triggered**를 선택하세요.

### 고객 이메일 끄기

1. **Dashboard** > **Settings** > **Checkout**으로 이동합니다
2. **Send transactional emails to your members**를 끕니다

> [!WARNING]
>
> 고객 이메일을 끄면 고객은 Whop으로부터 주문 확인, 갱신 영수증, 갱신 또는 체험 알림, 결제 실패 알림을 받지 못합니다. 이러한 이메일은 고객이 청구 내역을 알아보는 데 도움이 되어 환불 요청과 분쟁을 예방할 수 있습니다.

이 설정은 위 표의 이메일을 중지합니다. 인보이스 이메일과 청구 일정 변경 알림은 계속 발송되며, 자동 메시지도 계속 발송됩니다.

Whop 이메일의 문구는 편집할 수 없습니다. 직접 이메일을 보내려면 [웹훅](https://docs.whop.com/ko/developer/guides/webhooks.md)에서 트리거하세요.


## Related topics

- [Whop 파트너 프로그램 가이드](https://docs.whop.com/ko/partners.md)
- [할부 결제 신청](https://docs.whop.com/ko/payments-and-billing/financing/apply.md)
- [할부 결제](https://docs.whop.com/ko/payments/financing.md)
