> ## 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 uygulamasıyla Whop satışlarını, iadelerini ve ödemelerini QuickBooks Online'a kaydedin ve müşterilerin QuickBooks faturalarını Whop üzerinden ödemesine izin verin.

> [card] [QuickBooks Sync'i yükleyin](https://whop.com/apps/app_ygXqVjukBrVaU3/install/)
>
> Whop App Store'da mevcuttur

QuickBooks Sync uygulaması, bir Whop işletmesini bir QuickBooks Online şirketine bağlar. Whop etkinliklerini defterlerinize kaydetmek ve QuickBooks faturalarının ödemesini Whop üzerinden tahsil etmek için kullanın. Seçtiğiniz senkronizasyon modu, QuickBooks'un hangi Whop etkinliklerini kaydedeceğini belirler.

Whop işletmenize ve bir QuickBooks Online şirketine yönetici erişiminiz olmalıdır. QuickBooks Desktop desteklenmez.

## Neler senkronize edilir

| Etkinlik | Yön | Ne olur |
| - | - | - |
| **Whop satışları** | Whop → QuickBooks | Her satış için bir Sales Receipt (yalnızca All Sales modunda) |
| **Whop ödemeleri** | Whop → QuickBooks | Tamamlanan her para çekimi için, Whop ücretleri ayrı bir satırda olacak şekilde bir Bank Deposit (All Sales ve Withdrawals Only modlarında) |
| **İadeler** | Her iki yönde | QuickBooks'taki bir iade (Refund Receipt veya Credit Memo) Whop ödemesini iade eder. Whop'taki bir iade, Invoicing Only modu dışında QuickBooks'ta bir Refund Receipt oluşturur. |
| **Faturalar** | QuickBooks → Whop | Yeni QuickBooks faturalarının notuna bir Whop ödeme bağlantısı eklenir. Müşteri ödeme yaptığında uygulama faturayı ödendi olarak işaretler. |
| **Yinelenen işlemler** | QuickBooks → Whop | Yinelenen bir fatura şablonu haftalık, aylık veya yıllık bir Whop planı oluşturur |
| **Ürünler** | QuickBooks → Whop | Yeni ve güncellenen QuickBooks kalemleri Whop ürünleri oluşturur veya günceller. Whop ürünleri QuickBooks'a yalnızca geriye dönük doldurma (backfill) ile ulaşır. |
| **Müşteriler** | Her iki yönde | E-posta adresine göre eşleştirilir |

Bağlıyken uygulama, müşterilerin Whop üzerinden ödeme yapması için yeni faturalarda QuickBooks Payments'ı kapatır. Halihazırda açık olan faturalar değişmez.

## Uygulamayı kurun

**1. Uygulamayı yükleyin**

Bu sayfanın üst kısmındaki **Install QuickBooks Sync** seçeneğini seçin veya Whop App Store'da "QuickBooks Sync" araması yapın. Uygulama ardından Whop kontrol panelinizde görünür.

**2. QuickBooks'u bağlayın**

Uygulamayı açın ve **Connection** bölümüne gidin. Canlı şirketiniz için **Connect (Production)** veya bir QuickBooks sandbox şirketi için **Connect (Sandbox)** seçeneğini seçin. Intuit'te oturum açın, şirketi seçin ve bağlantıyı onaylayın.

**3. Hesaplarınızı eşleyin**

**Accounts** bölümüne gidin ve gelir hesabını, işlem ücreti hesabını ve Whop para çekimlerinizin yattığı banka hesabını seçin. Uygulama sizin için bir "Whop Processing Fees" gider hesabı oluşturabilir. Bir ücret hesabı seçmezseniz ödeme yatırımlarında ücret satırı yer almaz.

**4. Bir senkronizasyon modu seçin**

**Overview** bölümüne gidin ve bir senkronizasyon modu seçin (aşağıya bakın). Senkronizasyona güvenmeden önce bunu kontrol edin, çünkü mod, uygulamanın tek tek Whop satışlarını kaydedip kaydetmeyeceğini belirler.

**5. Mevcut verileri içe aktarın (isteğe bağlı)**

Bağlanmadan önceki verileri aktarmak için **Backfill** bölümüne gidin:

* **Users to Customers** — Whop üyelerinden e-postaya göre eşleştirilen QuickBooks müşterileri oluşturur
* **Items / Products** — QuickBooks ile Whop arasında kalemleri senkronize eder
* **Unpaid Invoices** — açık faturalara Whop ödeme bağlantıları ekler
* **Paid Invoice Matching** — ödenmiş faturaları Whop ödemeleriyle eşleştirir

Uygulama, önceden eşlediği kayıtları atlar.

## Senkronizasyon modları

Modları değiştirmek yalnızca o andan itibaren gerçekleşen etkinlikleri etkiler. Önceki kayıtlar değişmez.

| | All Sales | Withdrawals Only | Invoicing Only |
| - | - | - | - |
| **Whop satışları** | Her satış için Sales Receipt | Kaydedilmez | Kaydedilmez |
| **Whop ödemeleri** | Bank Deposit | Bank Deposit | Kaydedilmez |
| **Whop iadeleri** | Refund Receipt | Refund Receipt | Kaydedilmez |
| **QuickBooks faturaları, yinelenen şablonlar, kalemler, iadeler** | Senkronize edilir | Senkronize edilir | Senkronize edilir |
| **En uygun olduğu durum** | Ağırlıklı olarak Whop'ta satış yapmak | Yalnızca ödemeleri takip etmek | Whop'u yalnızca QuickBooks faturalarını tahsil etmek için kullanmak |

**All Sales** modunda uygulama bir "Whop Clearing" hesabı oluşturur. Sales Receipt'ler bu hesaba yatırılır ve her ödeme bakiyeyi banka hesabınıza aktarır.

Withdrawals Only modunda uygulama ödemeleri gelir olarak kaydeder. Müşterilerinize QuickBooks'ta da fatura kesiyorsanız, bu geliri iki kez saymış olursunuz: bir kez faturada, bir kez de yatırımda.

## Vergiler

QuickBooks faturaları için vergiyi QuickBooks hesaplar ve müşteri fatura toplamını Whop üzerinden öder. Alıcılardan iki kez vergi alınmaması için eşleşen Whop ürünlerinden vergi ayarlarını kaldırın. Doğrudan Whop satışlarına ait Sales Receipt'ler, ayrı bir vergi satırı olmadan tutarın tamamını tek bir satırda kaydeder.

## Senkronizasyonu izleyin

**Sync History**, uygulamanın işlediği her olayı duruma göre filtrelenmiş olarak listeler. **Errors** başarısız olayları listeler. Uygulama başarısız bir olayı, denemeler arasındaki gecikmeyi artırarak 5 kereye kadar yeniden dener.

## Bağlantıyı kesin

**Connection** bölümüne gidin ve **Disconnect QuickBooks** seçeneğini seçin. Daha sonra yeniden bağlanırsanız uygulama senkronizasyon geçmişinizi ve eşlemelerinizi saklar. QuickBooks'ta zaten bulunan kayıtlar orada kalır.

## Sonraki adımlar

> [card] [Xero](https://docs.whop.com/tr/third-party-integrations/xero.md)
>
> Whop etkinliklerini Xero'ya banka akışı olarak gönderin.

> [card] [Fiyatlandırma ve ücretler](https://docs.whop.com/tr/fees.md)
>
> Ödemelerinizde görünen ücretleri görün.


## Related topics

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