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

# TrackingElement

> 주문 번호 또는 운송장 번호와 체크아웃 시 사용한 이메일로 배송을 조회합니다. 엘리먼트는 운송사의 네이티브 업데이트와 비즈니스에 저장된 지원 링크를 표시합니다. 고객 입력과 조회 결과는 Whop 프레임 안에 머무르며, 호스팅 웹사이트는 이를 전혀 받지 않습니다. 로그인이나 이메일 코드가 필요하지 않습니다.

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

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

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

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

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

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

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

## Props

**showBranding** `boolean`

양식 위에 표시되는 로고와 비즈니스 이름에 대해 저장된 표시 설정을 따릅니다. 자체 헤더가 있는 웹사이트에서 브랜드 헤더 전체를 생략하려면 false로 설정하세요. 기본값은 `true`입니다.

## 이벤트

생성 옵션 또는 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\<TrackingElementProps\>` *required*

## 스타일링

이 엘리먼트는 스타일링용 클래스 이름을 노출하지 않습니다. 스타일을 변경하려면 `appearance`(테마, 강조 색상, 변수)를 사용하세요.


## Related topics

- [Delivery](https://docs.whop.com/ko/elements/latest/delivery/overview.md)
- [EventsElement](https://docs.whop.com/ko/elements/latest/tracking/events.md)
- [PeopleElement](https://docs.whop.com/ko/elements/latest/tracking/people.md)
