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

# Delivery

> 비즈니스를 위한 고객 배송 추적입니다. 웹사이트에 tracking을 마운트하면 고객이 주문 번호 또는 운송장 번호와 체크아웃 시 사용한 이메일을 입력합니다. 로그인, 이메일 코드, 판매자 API 키 또는 액세스 토큰이 필요하지 않습니다.

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

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

## Playground

예시 데이터로 엘리먼트를 조합해 보세요. 컨트롤을 조작하고, 엘리먼트를 추가 및 배치하고, 이벤트가 실시간으로 발생하는 것을 확인할 수 있습니다:

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Delivery /* options */>
        {/* mount elements here */}
      </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 */ });
</script>
```

## 옵션

다음 옵션을 `whop.delivery.create({ … })`에 전달하거나, React에서는 `<Delivery>`의 props로 전달합니다.

**accountId** `string` *required*

biz\_ 접두사가 붙은 비즈니스 ID입니다. 비즈니스 설정에서 고객 배송 추적이 켜져 있어야 합니다.

**appearance** `Appearance`

이 그룹 엘리먼트의 시각적 사용자 지정입니다. 전역 `WhopElements({ appearance })`보다 우선합니다. `update({ appearance })`로 실시간 변경할 수 있습니다.

**locale** `WhopElementsLocale`

이 그룹 엘리먼트 UI 텍스트의 로케일입니다. 앱에 빌드된 로케일 중 하나로 설정하면 전역 구성보다 우선합니다. 그 외의 값은 기본 로케일로 대체됩니다.

## 이벤트

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

### `onLoadingChange`

그룹의 로딩 상태가 변경될 때 실행됩니다. 마운트된 엘리먼트 중 하나라도 로딩 중이면 값은 `true`입니다.

**loading** `boolean`

## 메서드

`whop.delivery.create({ … })` 또는 `useDelivery()`에서 받은 Delivery 핸들에서 호출합니다.

### `update`

마운트된 모든 엘리먼트에 새 핸들 옵션을 병합합니다. React에서는 대신 네임스페이스 props를 변경하세요.

**매개변수**

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

### `destroy`

이 핸들이 생성한 모든 엘리먼트와 하위 컨트롤러를 제거하고, 컨트롤러 프레임을 제거하며, 구독을 해제합니다. 여러 번 호출해도 되지만, 제거된 핸들은 다른 모든 호출을 거부합니다. 다시 시작하려면 새 핸들을 생성하세요. React는 프로바이더가 언마운트될 때 그룹을 자동으로 제거합니다.

## 엘리먼트

이 그룹이 마운트하는 엘리먼트입니다. 각각 별도 페이지가 있습니다:

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


## Related topics

- [Replay Delivery](https://docs.whop.com/ko/api-reference/webhooks/replay-delivery.md)
- [List deliveries](https://docs.whop.com/ko/api-reference/legacy/webhooks/list-deliveries.md)
- [List Deliveries](https://docs.whop.com/ko/api-reference/webhooks/list-deliveries.md)
