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

# QuickBooks

> QuickBooks Sync 앱으로 Whop 판매, 환불, 지급을 QuickBooks Online에 기록하고, 고객이 Whop을 통해 QuickBooks 인보이스를 결제하도록 하세요.

> [card] [QuickBooks Sync 설치하기](https://whop.com/apps/app_ygXqVjukBrVaU3/install/)
>
> Whop App Store에서 사용 가능

QuickBooks Sync 앱은 Whop 비즈니스를 QuickBooks Online 회사에 연결합니다. 이 앱을 사용해 Whop 활동을 장부에 기록하고, Whop을 통해 QuickBooks 인보이스의 대금을 받을 수 있습니다. 선택한 동기화 모드에 따라 QuickBooks에 기록되는 Whop 활동이 결정됩니다.

Whop 비즈니스와 QuickBooks Online 회사에 대한 관리자 권한이 필요합니다. QuickBooks Desktop은 지원되지 않습니다.

## 동기화되는 항목

| 활동 | 방향 | 동작 |
| - | - | - |
| **Whop 판매** | Whop → QuickBooks | 각 판매에 대한 Sales Receipt(All Sales 모드만 해당) |
| **Whop 지급** | Whop → QuickBooks | 완료된 각 출금에 대한 Bank Deposit, Whop 수수료는 별도 줄로 기록(All Sales 및 Withdrawals Only 모드) |
| **환불** | 양방향 | QuickBooks의 환불(Refund Receipt 또는 Credit Memo)은 Whop 결제를 환불합니다. Whop의 환불은 Invoicing Only 모드를 제외하고 QuickBooks에 Refund Receipt를 생성합니다. |
| **인보이스** | QuickBooks → Whop | 새 QuickBooks 인보이스의 메모에 Whop 결제 링크가 추가됩니다. 고객이 결제하면 앱이 인보이스를 결제 완료로 표시합니다. |
| **반복 거래** | QuickBooks → Whop | 반복 인보이스 템플릿은 주간, 월간 또는 연간 Whop 플랜을 생성합니다 |
| **상품** | QuickBooks → Whop | 새로 추가되거나 업데이트된 QuickBooks 항목은 Whop 상품을 생성하거나 업데이트합니다. Whop 상품은 백필을 통해서만 QuickBooks에 반영됩니다. |
| **고객** | 양방향 | 이메일 주소로 매칭 |

연결된 동안 앱은 고객이 Whop을 통해 결제하도록 새 인보이스에서 QuickBooks Payments를 끕니다. 이미 열려 있는 인보이스는 변경되지 않습니다.

## 앱 설정하기

**1. 앱 설치하기**

이 페이지 상단의 **Install QuickBooks Sync**를 선택하거나 Whop App Store에서 "QuickBooks Sync"를 검색하세요. 그러면 앱이 Whop 대시보드에 나타납니다.

**2. QuickBooks 연결하기**

앱을 열고 **Connection**으로 이동하세요. 실제 회사의 경우 \*\*Connect (Production)\*\*을, QuickBooks 샌드박스 회사의 경우 \*\*Connect (Sandbox)\*\*를 선택하세요. Intuit에 로그인하고 회사를 선택한 다음 연결을 승인하세요.

**3. 계정 매핑하기**

**Accounts**로 이동하여 수익 계정, 처리 수수료 계정, Whop 출금이 입금되는 은행 계정을 선택하세요. 앱이 "Whop Processing Fees" 비용 계정을 자동으로 만들어 줄 수 있습니다. 수수료 계정을 선택하지 않으면 지급 입금에서 수수료 줄이 빠집니다.

**4. 동기화 모드 선택하기**

**Overview**로 이동하여 동기화 모드를 선택하세요(아래 참조). 모드에 따라 앱이 개별 Whop 판매를 기록할지 여부가 결정되므로, 동기화에 의존하기 전에 확인하세요.

**5. 기존 데이터 가져오기 (선택 사항)**

연결하기 전의 데이터를 가져오려면 **Backfill**로 이동하세요:

* **Users to Customers** — 이메일로 매칭하여 Whop 멤버로부터 QuickBooks 고객을 생성합니다
* **Items / Products** — QuickBooks와 Whop 간에 항목을 동기화합니다
* **Unpaid Invoices** — 열려 있는 인보이스에 Whop 결제 링크를 추가합니다
* **Paid Invoice Matching** — 결제된 인보이스를 Whop 결제와 매칭합니다

앱은 이미 매핑한 레코드를 건너뜁니다.

## 동기화 모드

모드를 전환하면 그 시점 이후의 활동에만 영향을 줍니다. 이전 레코드는 변경되지 않습니다.

| | All Sales | Withdrawals Only | Invoicing Only |
| - | - | - | - |
| **Whop 판매** | 각 판매에 대한 Sales Receipt | 기록 안 함 | 기록 안 함 |
| **Whop 지급** | Bank Deposit | Bank Deposit | 기록 안 함 |
| **Whop 환불** | Refund Receipt | Refund Receipt | 기록 안 함 |
| **QuickBooks 인보이스, 반복 템플릿, 항목, 환불** | 동기화됨 | 동기화됨 | 동기화됨 |
| **적합한 경우** | 주로 Whop에서 판매하는 경우 | 지급만 추적하는 경우 | QuickBooks 인보이스 수금에만 Whop을 사용하는 경우 |

**All Sales** 모드에서는 앱이 "Whop Clearing" 계정을 만듭니다. Sales Receipt는 이 계정에 입금되고, 각 지급은 잔액을 은행 계정으로 옮깁니다.

Withdrawals Only 모드에서는 앱이 지급을 수익으로 기록합니다. QuickBooks에서 고객에게 인보이스도 발행한다면, 인보이스에서 한 번, 입금에서 또 한 번 수익을 이중으로 계산하게 됩니다.

## 세금

QuickBooks 인보이스의 경우 QuickBooks가 세금을 계산하고 고객은 Whop을 통해 인보이스 총액을 결제합니다. 구매자가 이중으로 과세되지 않도록 해당 Whop 상품에서 세금 설정을 제거하세요. 직접 Whop 판매에 대한 Sales Receipt는 별도의 세금 줄 없이 전체 금액을 한 줄에 기록합니다.

## 동기화 모니터링

**Sync History**에는 앱이 처리한 모든 이벤트가 상태별로 필터링되어 나열됩니다. **Errors**에는 실패한 이벤트가 나열됩니다. 앱은 실패한 이벤트를 시도 간 지연 시간을 늘려 가며 최대 5회까지 재시도합니다.

## 연결 해제

**Connection**으로 이동하여 **Disconnect QuickBooks**를 선택하세요. 나중에 다시 연결할 경우를 위해 앱은 동기화 기록과 매핑을 보관합니다. 이미 QuickBooks에 있는 레코드는 그대로 유지됩니다.

## 다음 단계

> [card] [Xero](https://docs.whop.com/ko/third-party-integrations/xero.md)
>
> Whop 활동을 Xero에 은행 피드로 보내세요.

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


## Related topics

- [Xero](https://docs.whop.com/ko/third-party-integrations/xero.md)
- [Connect a Social Account](https://docs.whop.com/ko/api-reference/social-accounts/connect-a-social-account.md)
- [Connect an External Account](https://docs.whop.com/ko/api-reference/external-accounts/connect-an-external-account.md)
