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

# Xero

> Xero Sync 앱으로 Whop 판매, 수수료, 환불, 지급을 Xero에 은행 거래 내역 줄로 보내고, 인보이스와 매칭하세요.

> [card] [Xero Sync 설치하기](https://whop.com/apps/app_k7BroST9XRQ0W6/install/)
>
> Whop을 Xero에 은행 피드로 연결하기

Xero Sync 앱은 Whop 잔액을 Xero 조직에 은행 피드로 연결합니다. Whop 판매, 수수료, 환불, 지급이 Xero에 은행 거래 내역 줄로 들어옵니다. 그런 다음 Xero에서 이미 발행한 인보이스와 매칭합니다.

이는 회계 동기화가 아니라 은행 피드입니다. Xero에 인보이스, 연락처, 상품을 생성하지 않습니다.

Whop 비즈니스에 대한 관리자 권한과 은행 피드를 지원하는 유료 요금제의 Xero 조직이 필요합니다. 데모 및 원장 조직은 은행 피드를 사용할 수 없습니다. 둘 이상의 통화로 피드를 운영하려면 Xero 요금제에 다중 통화 기능이 필요합니다.

## Xero에 들어오는 항목

| Whop 활동 | 거래 내역 줄 |
| - | - |
| **판매** | 입금. Xero가 일치하는 인보이스를 제안할 수 있도록 고객 이름으로 표시됩니다 |
| **Whop 수수료** | 출금, 별도 줄로 기록 |
| **환불** | 출금 |
| **패소한 지불 거절** | 출금 |
| **지급** | 출금 수수료를 제외하고 잔액에서 빠져나간 금액만큼 출금. 지급 매핑을 켜면 은행 계정으로의 이체로도 기록됩니다. |

새 활동은 약 15분 이내에 Xero에 반영됩니다. Xero에서 매칭을 확인하기 전까지는 아무것도 대사(reconcile)되지 않습니다.

## 앱 설정하기

**1. 설치 및 연결하기**

이 페이지 상단의 버튼으로 앱을 설치하고 Whop 대시보드에서 여세요. **Overview**에서 **Connect to Xero**를 선택하세요. Xero에 로그인하고 조직을 선택한 다음 권한을 승인하세요.

**2. 은행 피드 만들기**

**Bank Feeds**를 열고 판매하는 통화를 선택하세요. 앱은 통화별로 하나의 피드를 만들고, Xero는 일치하는 은행 계정을 만듭니다. 대신 기존 Xero 은행 계정으로 피드를 지정할 수도 있습니다.

**3. 지급 대상 매핑하기 (선택 사항)**

**Payouts**를 열고 각 Whop 지급 대상에 대한 Xero 은행 계정을 선택하세요. 계정은 지급과 동일한 통화여야 합니다. 그러면 앱은 각 지급을 은행 피드로 들어오는 입금과 일치하는 이체로 기록합니다. 매핑되지 않은 대상도 거래 내역 줄로 표시됩니다.

## 앱이 보내는 항목 추적하기

**Activity**에는 앱이 기록한 모든 Whop 거래가 나열됩니다:

* **Ready to send** — 약 15분 이내에 다음 거래 내역과 함께 전송됩니다
* **In Xero** — 전달되었으며 대사할 준비가 되었습니다

## 새 기능을 위해 다시 연결하기

Xero는 다시 연결할 때만 새 권한을 부여합니다. 지급 이체 같은 기능이 생기기 전에 연결했다면 대시보드에 다시 연결하라는 안내가 표시됩니다. 기존 피드는 계속 실행되며 이미 Xero에 있는 항목은 변경되지 않습니다.

## 연결 해제

**Connection**으로 이동하여 연결을 해제하세요. 피드가 중지되며, 이미 전송된 줄은 Xero에 그대로 유지됩니다.

## 다음 단계

> [card] [QuickBooks](https://docs.whop.com/ko/third-party-integrations/quickbooks.md)
>
> Whop 활동을 QuickBooks Online에 기록하세요.

> [card] [가격 및 수수료](https://docs.whop.com/ko/fees.md)
>
> 은행 피드에 표시되는 수수료를 확인하세요.
