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

# ExpressCheckoutElement

> 체크아웃을 위한 원터치 Apple Pay, Google Pay, PayPal 버튼입니다. 지갑이 세션에 아직 필요한 항목(구매자 이메일, 실물 상품의 배송 주소, Apple Pay와 Google Pay에서 판매자가 수집하는 경우 전화번호, Apple Pay에서 판매자가 입력을 허용하는 경우 프로모션 코드)을 수집하며, 한 번의 탭으로 구매가 완료됩니다. 전체 체크아웃 엘리먼트와 체크아웃의 진입 슬롯을 공유하므로 하나의 핸들은 둘 중 정확히 하나만 마운트합니다. 시트로 마무리할 수 있을 만큼 구매가 단순하면 이 버튼만, 그 외에는 전체 체크아웃 화면을 사용합니다. 구매자의 기기에서 실제로 결제할 수 있고 체크아웃의 결제 수단 구성에서 허용하는 지갑만 제공된 버튼 이미지로 렌더링하며, 사용 가능한 지갑이 없으면 아무것도 렌더링하지 않습니다. PayPal은 판매자가 허용하는 경우 표시되고, 별도 창에서 열리며, 구매와 함께 구매자의 PayPal 계정을 저장하므로 갱신, 무료 체험, 이후 판매자의 청구가 저장된 카드처럼 작동합니다. 세 지갑 모두 페이지 도메인에 Apple Pay가 필요합니다. 퍼스트 파티 whop.com 페이지는 사전 승인되어 있으며, 그 외 사이트는 버튼이 렌더링되기 전에 [Domains API](/ko/api-reference/beta/domains/domain)를 통해 도메인에 Apple Pay를 추가해야 합니다. 자체 사이트에서 Google Pay를 제공하는 경우 Google Pay API 서비스 약관이 적용됩니다. 대기자 명단 가입, 이전, 페이지에서만 물을 수 있는 양식 질문 등 시트로 제대로 마무리할 수 없는 체크아웃은 실패할 버튼을 렌더링하는 대신 명확하게 거부합니다.

> [!NOTE]
>
> 이 페이지는 `@whop/elements@1.10.0` 및 `@whop/elements-react@1.10.0`을 다룹니다.

*`v1.0.0`부터 지원.*

[`Checkout`](https://docs.whop.com/ko/elements/latest/checkout/overview) 안에 마운트됩니다. props와 콜백은 생성 옵션 또는 React props로 전달합니다.

> [!NOTE]
>
> **배타적.**`ExpressCheckoutElement`는 이 Checkout 핸들에서 `CheckoutElement`의 대안입니다. 한 번에 하나만 마운트하세요. 다른 엘리먼트를 마운트하기 전에 제거하세요.

`<Checkout>` 안에 마운트합니다. `<Checkout>`은 `plan`, `items` 또는 `checkoutConfiguration`으로 체크아웃 세션을 열고 자격 증명을 내부에만 보관합니다. `<Checkout>` 자체는 `<WhopElements>` 안에 마운트됩니다. 버튼을 한 번 누르는 것으로 구매가 완료되며, 서버에 전달할 확인 토큰은 없습니다.

```tsx React theme={null}
import { WhopElements, Checkout, ExpressCheckoutElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Checkout /* options */>
        <ExpressCheckoutElement />
      </Checkout>
    </WhopElements>
  );
}
```

```tsx React Native theme={null}
import { Checkout, ExpressCheckoutElement } from '@whop/elements-react-native';

export function BuyNow({ onPurchased }: { onPurchased: (receiptId: string) => void }) {
  return (
    <Checkout
      plan="plan_xxxxxxxx"
      returnUrl="https://example.com/checkout/return"
      onComplete={({ receiptId }) => onPurchased(receiptId)}
    >
      <ExpressCheckoutElement onError={(e) => console.log(e.code, e.message)} />
    </Checkout>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const checkout = window.WhopElements().checkout.create({ /* options */ });
  checkout.create('expressCheckout').mount('#checkout-expressCheckout');
</script>
```

예시 데이터입니다. [Playground 열기](https://docs.whop.com/ko/elements/latest/checkout/overview#playground).

[React Native 예제 앱의 Android에서 실행 중인 ExpressCheckoutElement](https://app.revyl.ai/embed/e16407ed-1c20-4475-ad16-f78b4669374f?controls=0)

## Props

**wallets** `object | ("apple_pay" | "google_pay" | "paypal_express")[]`

> [!WARNING]
>
> 배열 형식의 `wallets`는 더 이상 권장되지 않으며 다음 메이저 버전에서 제거됩니다. 대신 `"auto"` 또는 `"never"` 값과 함께 `{ applePay, googlePay, payPal }`을 전달하세요.

렌더링할 수 있는 지갑입니다. 해당 버튼을 제외하려면 `applePay`, `googlePay`, 또는 `payPal`을 `'never'`로 설정하세요. 각 키의 기본값은 `'auto'`로, 구매자의 기기와 판매자가 실제로 제공하는 항목을 기준으로 필터링합니다. 엘리먼트는 기기, 제공된 매트릭스 또는 체크아웃의 결제 수단 구성이 지원하지 않는 지갑을 절대 표시하지 않으며, 렌더링 순서는 가장 적합한 네이티브 지갑이 먼저이고 PayPal이 마지막입니다. 지갑 유형 목록(`['apple_pay', 'google_pay']`)도 허용 목록으로 계속 받지만 더 이상 권장되지 않으며 다음 메이저 버전에서 제거됩니다. 빈 목록은 아무것도 렌더링하지 않습니다(개발 빌드에서 경고). 모든 지갑은 [Domains API](https://docs.whop.com/ko/api-reference/beta/domains/domain)를 통해 페이지 도메인에 Apple Pay가 준비되어 있어야 합니다. 퍼스트 파티 whop.com 페이지는 사전 승인되어 있으며, 그 외 사이트에서는 도메인에 Apple Pay를 추가하지 않으면 버튼이 숨겨진 상태로 유지됩니다. 자체 사이트에서 Google Pay를 제공하는 경우 [Google Pay API 서비스 약관](https://payments.developers.google.com/terms/sellertos)이 적용됩니다. 기본값은 `{}`입니다.

**속성**

**applePay** `"auto" | "never"`

**googlePay** `"auto" | "never"`

**payPal** `"auto" | "never"`

**layout** `"auto" | "horizontal" | "vertical"`

버튼을 배치하는 방식입니다. `auto`는 엘리먼트 자체 컨테이너를 따라 좁은 컨테이너에서는 세로로 쌓고, 넓은 컨테이너에서는 가로로 나란히 배치합니다. `horizontal`과 `vertical`은 한 가지 배치를 강제합니다. 기본값은 `"auto"`입니다.

## 이벤트

생성 옵션 또는 React props로 콜백을 전달합니다.

### `onLoaderStart`

로딩 스켈레톤이 처음 그려진 후, `onReady` 전에 실행됩니다.

### `onReady`

엘리먼트가 처음으로 완전히 그려진 후 실행됩니다.

### `onError`

엘리먼트가 로드에 실패하거나 충돌할 때 실행됩니다. 대체 화면은 계속 표시됩니다. 프로그래밍 방식으로 처리하려면 `code`를 사용하세요. `sourceKey`는 실패한 호스트 상태 소스를 식별합니다.

**e** `object`

**속성**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## 메서드

`create`가 반환한 핸들에서, 또는 React `ref`를 통해 호출합니다.

### `mount`

`target`에 엘리먼트를 마운트하고 로딩을 시작합니다. React 컴포넌트는 자동으로 마운트됩니다.

**매개변수**

**target** `string | HTMLElement` *required*

### `destroy`

엘리먼트를 제거하고 프레임과 구독을 해제합니다. 여러 번 호출해도 됩니다. React는 엘리먼트를 자동으로 제거합니다.

### `update`

마운트된 엘리먼트에 새 props를 병합합니다. React에서는 대신 컴포넌트 props를 변경하세요.

**매개변수**

**options** `Partial\<ExpressCheckoutElementProps\>` *required*

## 스타일링

`appearance.classes`를 통해 다음 부분의 스타일을 지정합니다. 속성 이름은 카멜 케이스 또는 케밥 케이스를 사용하고 단위를 포함하세요. 페이지 스타일시트는 엘리먼트의 프레임에 적용되지 않습니다. 프레임워크는 각 선언을 삽입하기 전에 유효성을 검사합니다.

| 클래스 | 대상 |
| - | - |
| `.whop-Address` | 주소 양식 루트 |
| `.whop-AddressErrorSummary` | 유효성 검사에서 누락되거나 잘못된 필드가 드러날 때 표시되는 요약 줄 |
| `.whop-AddressField` | 주소 양식의 필드 셀 하나 |
| `.whop-AddressFieldError` | 주소 필드의 오류 줄: 전체 레이아웃에서는 필드 아래, 컴팩트 레이아웃에서는 작성기 메시지용으로 그룹 아래에 표시 |
| `.whop-AddressFieldInput` | 주소 양식의 텍스트 입력 |
| `.whop-AddressFieldInputInvalid` | 주소 입력이 유효성 검사에 실패하는 동안 추가됨 |
| `.whop-AddressFieldInvalid` | 컴팩트 필드 셀이 유효성 검사에 실패하는 동안 추가됨 |
| `.whop-AddressFieldLabel` | 주소 필드 레이블: 필드 위, 또는 플로팅 레이블 사용 시 필드 안 |
| `.whop-AddressFieldSelect` | 주소 양식의 선택 항목(국가, 주, 조직 유형) |
| `.whop-AddressGroup` | 컴팩트 레이아웃에서 모든 필드를 담는 테두리 그룹 |
| `.whop-AddressLine2Toggle` | 접힌 주소 2행 토글 |
| `.whop-AddressManualEntry` | 접힌 양식 아래의 "Enter address manually" 텍스트 버튼 — 국가별 전체 형식을 펼침 |
| `.whop-AddressSearchButton` | 휴대폰에서 거리 필드 끝에 있는 검색 버튼 |
| `.whop-AddressSearchCancel` | 주소 검색 필드 옆의 Cancel 버튼 |
| `.whop-AddressSearchInput` | 전체 화면 주소 검색 상단의 검색 필드 |
| `.whop-AddressSuggestion` | 자동 완성 오버레이의 제안 행 하나 |
| `.whop-AddressSuggestionActive` | 키보드/포인터로 활성화된 제안 행에 추가됨 |
| `.whop-AddressSuggestionManual` | 제안 목록을 마무리하는 "Enter address manually" 행 |
| `.whop-AddressSuggestions` | 주소 1행 필드에 고정된 자동 완성 제안 오버레이 |
| `.whop-AddressSuggestionsEmpty` | 검색어 입력이 끝났지만 일치하는 주소가 없을 때 표시되는 조용한 안내 줄 |
| `.whop-Card` | 카드 엘리먼트 루트 |
| `.whop-CardError` | 카드 구성 오류 패널 |
| `.whop-CardField` | 카드 번호, 만료일 또는 보안 코드 필드 |
| `.whop-CardFieldError` | 카드 유효성 검사 메시지 |
| `.whop-CardFieldGroup` | 그룹화된 카드 필드 — 위에는 번호, 아래에는 만료일과 보안 코드 |
| `.whop-CardFieldInput` | 테두리가 있는 PCI 입력 컨테이너 |
| `.whop-CardFieldInputFocused` | 포커스된 PCI 입력 컨테이너 |
| `.whop-CardFieldInputInvalid` | 잘못되었거나 불완전한 PCI 입력 컨테이너 |
| `.whop-CardFieldRow` | 컴팩트한 카드 번호, 만료일, 보안 코드 행 |
| `.whop-CardLabel` | 카드 정보 레이블 |
| `.whop-CheckoutExpress` | 익스프레스 체크아웃 행 — 양식 위의 원터치 지갑 결제 |
| `.whop-CheckoutExpressApplePay` | Apple Pay 익스프레스 버튼 |
| `.whop-CheckoutExpressButtons` | 지갑 버튼 스택 — 좁은 컨테이너에서는 세로, 넓은 컨테이너에서는 가로로 나란히 배치 |
| `.whop-CheckoutExpressComplete` | 독립형 익스프레스 버튼의 최종 결과 줄 |
| `.whop-CheckoutExpressContinue` | 익스프레스 행의 차단된 이동 버튼 — 결제의 외부 단계로의 이동을 마저 진행함 |
| `.whop-CheckoutExpressDivider` | 익스프레스 체크아웃과 양식 사이의 구분선 |
| `.whop-CheckoutExpressError` | 익스프레스 버튼 아래의 재시도 가능한 오류 줄 |
| `.whop-CheckoutExpressFinishPayment` | 구매자가 닫은 단계가 결제에 아직 필요한 동안 표시되는 결제 마무리 줄 |
| `.whop-CheckoutExpressFinishPaymentButton` | 결제의 대기 중인 단계를 다시 실행하는 재진입 버튼 |
| `.whop-CheckoutExpressGooglePay` | Google Pay 익스프레스 버튼 |
| `.whop-CheckoutExpressPayPal` | PayPal 익스프레스 버튼 |
| `.whop-CheckoutExpressPhoneError` | 지갑에서 수집한 전화번호로 서버가 문자를 보낼 수 없을 때의 거부 안내 줄 |
| `.whop-CheckoutExpressRetry` | 실패 상태의 버튼 — 다시 열린 세션을 다시 읽어 구매자가 다시 결제할 수 있게 함 |
| `.whop-CheckoutExpressUnavailable` | 익스프레스 버튼이 이 체크아웃을 처리할 수 없을 때 표시되는 화면 |
| `.whop-CompletePayment` | 완료 영역 루트 |
| `.whop-CompletePaymentAmount` | 구매자가 결제해야 하는 금액 |
| `.whop-CompletePaymentBarcode` | 스캔 가능한 바코드 카드 |
| `.whop-CompletePaymentDocumentLink` | 호스팅된 안내 페이지 버튼 |
| `.whop-CompletePaymentError` | 오류 패널 |
| `.whop-CompletePaymentFrame` | 프레임 안의 PSP 단계 |
| `.whop-CompletePaymentHint` | 자동 업데이트 힌트 |
| `.whop-CompletePaymentInstructions` | 결제 안내 패널 |
| `.whop-CompletePaymentProviderMark` | 바우처 네트워크 로고 |
| `.whop-CompletePaymentQr` | 스캔 가능한 QR 카드 |
| `.whop-CompletePaymentReference` | 복사 가능한 코드 블록(참조 번호, 결제 키) |
| `.whop-CompletePaymentSettled` | 닫히기 전에 표시되는 최종 상태 패널 |
| `.whop-CompletePaymentSettledFailed` | 닫히기 전에 표시되는 실패 최종 상태 패널 |
| `.whop-CompletePaymentSpinner` | 대기 스피너 |
| `.whop-CompletePaymentTitle` | 대화 상자 제목 |
| `.whop-CompletePaymentTransferDetails` | 은행 송금 세부 정보 행 |
| `.whop-Email` | 이메일 엘리먼트 루트 |
| `.whop-EmailChecking` | 이메일을 확인하거나 로그인 코드를 보내는 동안 표시되는 진행 윤곽선 |
| `.whop-EmailCodeHint` | 로그인 코드를 요청하는 줄 |
| `.whop-EmailError` | 잘못된 이메일 메시지 |
| `.whop-EmailInput` | 이메일 입력 |
| `.whop-EmailInputInvalid` | 타당하지 않은 값이 입력된 이메일 입력 |
| `.whop-EmailLabel` | 이메일 필드 레이블 |
| `.whop-EmailPasskey` | 이메일 입력 안의 패스키 로그인 버튼 |
| `.whop-EmailSignedIn` | 로그인한 구매자 행 |
| `.whop-EmailSignIn` | 재방문 환영 로그인 컨트롤 |
| `.whop-EmailSignInError` | 로그인 오류 메시지 |
| `.whop-EmailSignOut` | 다른 이메일 선택 컨트롤 |
| `.whop-EmailWelcome` | 계정 이메일 위에 표시되는 환영 화면 인사말 |
| `.whop-Payment` | 결제 엘리먼트 루트 |
| `.whop-PaymentBalance` | 잔액 타일의 지갑 하나 |
| `.whop-PaymentBalanceHint` | 청구 통화 기준 지갑의 사용 가능 금액 |
| `.whop-PaymentBalanceList` | 잔액 타일에서 구매자의 지갑을 스크롤할 수 있는 목록 |
| `.whop-PaymentBalanceMore` | 화면에 스크롤되어 들어오면 잔액을 더 불러오는 감시용 행 |
| `.whop-PaymentBalanceRow` | 클릭 가능한 잔액 행 |
| `.whop-PaymentBalanceRowSelected` | 선택된 잔액 행 |
| `.whop-PaymentBalanceRowUnavailable` | 현재 결제할 수 없는 지갑 — 차단되었거나 비어 있음 — 회색으로 비활성화됨 |
| `.whop-PaymentBillingBlock` | 결제 엘리먼트 내부의 청구지 주소 블록 |
| `.whop-PaymentCardFields` | 인라인 카드 필드 패널 |
| `.whop-PaymentCompactBalance` | 컴팩트 직접 체크아웃에서 선택된 잔액 |
| `.whop-PaymentCompactSavedMethod` | 컴팩트 직접 체크아웃에서 선택된 저장된 결제 수단 |
| `.whop-PaymentCurrencyFallback` | 제공되는 통화가 없을 때 대체 통화로 전환하는 컨트롤 |
| `.whop-PaymentDetailIcon` | 세부 영역 설명 옆의 템플릿 아이콘 |
| `.whop-PaymentDetailRegion` | 선택된 결제 수단의 펼쳐진 세부 영역 — 수집 영역(인라인 카드 필드, 선언된 입력)이 먼저 오고, 설명과 공시 줄이 하단 블록으로 표시 |
| `.whop-PaymentDetailSubtext` | 지갑 결제 수단에서 설명 아래에 표시되는 동의 보조 문구 |
| `.whop-PaymentDetailText` | 세부 영역의 설명 줄 |
| `.whop-PaymentError` | 사용 가능한 결제 수단 없음 오류 패널 |
| `.whop-PaymentFieldError` | 선언된 입력 아래의 Invalid 메시지 |
| `.whop-PaymentFieldInput` | 세부 영역의 선언된 결제 수단 입력 |
| `.whop-PaymentFieldInputInvalid` | 선언된 입력의 값이 선언된 형식에 맞지 않는 동안 추가됨 |
| `.whop-PaymentFieldLabel` | 선언된 결제 필드 레이블 |
| `.whop-PaymentInstallmentDetail` | 할부 옵션 행의 회차별 금액 |
| `.whop-PaymentInstallmentLabel` | 할부 옵션 행의 레이블 |
| `.whop-PaymentInstallmentList` | 할부 선택기의 옵션 목록 |
| `.whop-PaymentInstallmentRadio` | 할부 옵션 행의 라디오 표시기 |
| `.whop-PaymentInstallmentRow` | 할부 옵션 행 하나 |
| `.whop-PaymentInstallmentRowSelected` | 선택된 할부 옵션 행 |
| `.whop-PaymentInstallments` | 결제 수단 할부 선택기 |
| `.whop-PaymentInstallmentsLabel` | 할부 선택기의 제목 |
| `.whop-PaymentInstallmentsNotice` | 수수료가 선언되지 않은 선택 단계 아래의 발급사 수수료 고지 |
| `.whop-PaymentMandateLink` | 위임(mandate) 안내 안의 위임 약관 링크 |
| `.whop-PaymentMandateNotice` | 매트릭스 구성에서 위임을 선언한 결제 수단의 위임 승인 안내 |
| `.whop-PaymentMethod` | 선택된 결제 수단 타일 |
| `.whop-PaymentMethodDetail` | 결제 수단 하나 — 행과 펼쳐지는 세부 영역 |
| `.whop-PaymentMethodIcon` | 선택된 결제 수단의 세부 정보를 보여주는 펼침 영역 — 인라인 카드 필드, 설명 또는 선언된 입력 |
| `.whop-PaymentMethodLabel` | 행의 결제 수단 아이콘 |
| `.whop-PaymentMethodMoreSelect` | 행의 결제 수단 표시 이름 |
| `.whop-PaymentMethodMoreTile` | More 타일 위에 펼쳐진 보이지 않는 네이티브 선택 항목 |
| `.whop-PaymentMethodPanel` | 결제 수단 아이콘과 네이티브 선택기가 있는 초과 항목 타일 |
| `.whop-PaymentMethodRadio` | 선택된 결제 수단 라디오 |
| `.whop-PaymentMethodRadioSelected` | 타일 행 아래에 있는 선택된 결제 수단의 세부 패널(가로 레이아웃) |
| `.whop-PaymentMethodRow` | 선택된 결제 수단 행 |
| `.whop-PaymentMethodRowSelected` | 결제 수단 행의 라디오 표시기 |
| `.whop-PaymentMethods` | 결제 수단 목록 |
| `.whop-PaymentMethodSelected` | 클릭 가능한 결제 수단 행 |
| `.whop-PaymentMethodSeparated` | 선택된 결제 수단에 추가됨 — 해당 행과 펼쳐진 세부 영역 |
| `.whop-PaymentMethodsSeparated` | 가로 타일 행의 결제 수단 타일 하나 |
| `.whop-PaymentMethodTile` | 마지막 More 타일에 초과 결제 수단이 들어가는 가로 결제 수단 타일 행 |
| `.whop-PaymentMethodTileRow` | 결제 수단 항목 또는 추가 결제 수단 확장 행이 별도 카드로 렌더링되는 동안 추가됨 |
| `.whop-PaymentMethodTileSelected` | 분리된 아코디언 결제 수단 목록 |
| `.whop-PaymentMoreRow` | "N more payment methods" 확장 행 |
| `.whop-PaymentPayerDocument` | 구매자 신원 문서 유형 선택기 |
| `.whop-PaymentPayerDocumentError` | 통화별 구매자 신원 문서 필드 |
| `.whop-PaymentPayerDocumentLabel` | 구매자 신원 문서 오류 |
| `.whop-PaymentPayerDocumentType` | 구매자 신원 문서 레이블 |
| `.whop-PaymentSavedMethod` | 저장된 결제 수단 하나 전용 — PaymentMethod도 함께 가짐 |
| `.whop-PaymentSavedMethodHint` | 저장된 결제 수단의 후행 세부 정보 — 카드 만료일 |
| `.whop-PaymentSavedMethodRow` | 저장된 결제 수단 전용의 클릭 가능한 행 — PaymentMethodRow도 함께 가짐 |
| `.whop-PaymentSavedMethodRowSelected` | 선택된 저장된 결제 수단 행 |
| `.whop-PaymentSavedMethods` | 저장된 결제 수단 목록 전용 — PaymentMethods도 함께 가지므로 하나의 규칙으로 두 목록을 모두 스타일링 |
| `.whop-PaymentSavedMethodSeparated` | 저장된 결제 수단 전용의 분리 표시 |
| `.whop-PaymentSavedMore` | 저장된 결제 수단의 다음 페이지를 가져오는 컨트롤 |
| `.whop-PaymentSavedMoreSpinner` | 저장된 결제 수단의 다음 페이지를 불러오는 동안 표시되는 스피너 |
| `.whop-PaymentSettlementNotice` | 매트릭스 구성에서 정산 기간을 선언한 결제 수단의 정산 기간 힌트 |
| `.whop-TaxId` | 세금 등록 루트 |
| `.whop-TaxIdError` | API 유효성 검사 오류 |
| `.whop-TaxIdInput` | 등록 값 입력 |
| `.whop-TaxIdLabel` | 등록 값 레이블 |
| `.whop-TaxIdTypeLabel` | 등록 유형 레이블 |
| `.whop-TaxIdTypeSelect` | 등록 유형 선택기 |
| `.whop-Verification` | 인증 코드 대화 상자 본문 |
| `.whop-VerificationDismiss` | 로그인을 사용할 수 없을 때 게스트로 계속하는 컨트롤 |
| `.whop-VerificationError` | 대화 상자의 실패 메시지 |
| `.whop-VerificationExpired` | 만료된 로그인 패널 |
| `.whop-VerificationHeading` | 코드 대화 상자 제목과 설명 |
| `.whop-VerificationHint` | 코드 전송 설명 |
| `.whop-VerificationInput` | 일회용 코드 입력 |
| `.whop-VerificationInputInvalid` | 시도 실패 후 코드 입력에 추가됨 |
| `.whop-VerificationInputSlot` | 일회용 코드 입력의 숫자 칸 하나 |
| `.whop-VerificationInputSlotActive` | 구매자가 입력 중인 코드 슬롯에 추가됨 |
| `.whop-VerificationPasskey` | 패스키 대신 사용 컨트롤 |
| `.whop-VerificationPending` | 제출이 진행되는 동안 표시되는 확인 중… 줄 |
| `.whop-VerificationResend` | 카운트다운이 있는 코드 재전송 컨트롤 |
| `.whop-VerificationRestart` | 만료 패널의 처음부터 다시 시작 컨트롤 |
| `.whop-VerificationTitle` | 대화 상자 헤더 워드마크 |

```ts theme={null}
const checkout = whop.checkout.create({
  appearance: {
    classes: {
      'whop-Address': { borderRadius: '8px', fontWeight: '600' },
      'whop-AddressErrorSummary': { borderRadius: '8px', fontWeight: '600' },
      'whop-AddressField': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

// 159 classes use this shape
checkout.update({
  appearance: { classes: { 'whop-Address': { fontWeight: '700' } } }
});
```

React에서는 `appearance`를 `<Checkout>`에 전달합니다. 전역으로 설정하려면 `WhopElements({ appearance })`를 사용하세요.

## Props

**wallets** `('apple_pay' | 'google_pay')[]`

렌더링할 수 있는 지갑으로, 기기가 제공하는 항목을 기준으로 필터링합니다. 엘리먼트는 기기, 계정 또는 체크아웃의 결제 수단 구성이 지원하지 않는 지갑을 절대 표시하지 않습니다. 빈 목록은 아무것도 렌더링하지 않습니다. 기본값은 둘 다입니다.

**style** `StyleProp\<ViewStyle\>`

엘리먼트의 외부 `View`에 적용됩니다. 테마 지정에는 이 화면의 모든 엘리먼트에 적용되는 프로바이더의 `appearance.parts`를 사용하는 것이 좋습니다. 현재 React Native 파트 이름은 웹의 `whop-*` 클래스 이름과 별개의 체계이므로, 웹 appearance 객체를 그대로 옮겨 쓸 수 없습니다.

**fallback** `ReactNode`

엘리먼트가 로드되는 동안 기본 스켈레톤 대신 렌더링됩니다.

**onReady** `() =\> void`

엘리먼트가 안정되면 한 번 실행됩니다. 즉, 버튼이 표시되었거나 엘리먼트가 아무것도 렌더링하지 않는다는 것을 알게 된 시점입니다. `<Checkout>`이 이를 기다리므로 보통은 `<Checkout>` 자체의 `onLoadingChange`를 사용하는 것이 좋습니다.

**onError** `(error: \{ message: string; code?: string \}) =\> void`

이 엘리먼트의 로드 또는 구성 실패입니다. 어떤 경우든 엘리먼트는 자체 오류 화면을 렌더링합니다.

## 상태

세션이 열리고 기기에 결제 가능 여부를 확인하는 동안 스켈레톤 알약 하나가 표시되고, 이후 Powered by Whop 안내 위에 플랫폼 자체의 Apple Pay 또는 Google Pay 버튼이 표시됩니다. 지갑이 없는 기기, 체크아웃의 결제 수단 구성에서 비활성화된 지갑, 품절되었거나 보관된 플랜은 아무것도 렌더링하지 않습니다. 시트로 제대로 마무리할 수 없는 체크아웃(설정, 대기자 명단 가입, 이전, 페이지에서만 물을 수 있는 양식 질문)은 설명 화면을 렌더링하고 `onError`를 통해 `EXPRESS_CHECKOUT_UNAVAILABLE`을 보고합니다. 구매 후 엘리먼트는 결과를 표시합니다. 완료, 처리 중, 또는 결제에 아직 구매자의 조치가 필요하면 Finish payment 또는 Try again 버튼이 표시됩니다.

## 알아두면 좋은 점

* 기기는 하나의 지갑을 제공합니다. iOS에서는 Apple Pay, Android에서는 Google Pay입니다. 그래서 여기에는 `layout` prop이 없습니다. 배치할 두 번째 버튼이 없기 때문입니다.
* 시트는 세션에 아직 필요한 항목을 수집합니다. 세션에 이메일이 없으면 이메일, 판매자가 수집하는 경우 전화번호, 실물 상품의 경우 배송 주소입니다. 전화번호를 인증하는 판매자의 경우 시트가 닫힌 후 네이티브 모달에서 코드 입력 단계가 진행됩니다.
* iOS에서는 구매자가 카드를 변경하면 시트가 가격을 다시 계산하므로 세금이 청구지 주소를 따르며, 판매자가 코드를 허용하면 프로모션 코드 필드를 제공합니다. Google의 Android 시트는 체크아웃 합계를 표시하며 코드 필드가 없습니다.
* 앱은 절대 이동되지 않습니다. 구매가 확정되면 `<Checkout>`의 `onComplete`가 `sessionId` 및 `receiptId`와 함께 한 번 실행되며, 이 시점에 구매자를 다음 화면으로 이동시키면 됩니다. 주문 이행은 이 콜백이 아니라 웹훅에서 처리하세요.
* 3D Secure 및 기타 외부 단계는 iOS에서는 `ASWebAuthenticationSession`, Android에서는 Custom Tabs로 열리며, 엘리먼트는 결제가 안정될 때까지 폴링합니다. `<Checkout>`의 `returnUrl`은 직접 호스팅하는 **https** URL이어야 합니다.
* 모든 `<Checkout>` 옵션은 생성 시점에 고정됩니다. 마운트 후 옵션을 변경하면 `CHECKOUT_OPTIONS_FROZEN`이 보고되고 원래 주문이 유지됩니다. 다른 상품을 판매하려면 `<Checkout>`에 새 `key`를 지정하세요.

> [!NOTE]
>
> 앱을 `<WhopElements getToken={…}>`로 한 번 감싼 다음, 엘리먼트를 `<Checkout>`으로 감싸 마운트하세요. `<Checkout>`은 `plan`, `items`, `checkoutConfiguration`, `quantity`, `promoCode`, `affiliateCode`, `attribution`, `metadata`, `returnUrl`과 함께 `onComplete`, `onError`, `onLoadingChange`, `fallback`을 받습니다. [시작하기](https://docs.whop.com/ko/elements/latest/getting-started.md) 및 [Appearance](https://docs.whop.com/ko/elements/latest/appearance.md)를 참고하세요.


## Related topics

- [CheckoutElement](https://docs.whop.com/ko/elements/latest/checkout/checkout.md)
- [Express Checkout 추가하기](https://docs.whop.com/ko/developer/guides/express-checkout.md)
- [Elements 시작하기](https://docs.whop.com/ko/elements/latest/getting-started.md)
