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

> Enregistrez les ventes, remboursements et versements Whop dans QuickBooks Online, et permettez à vos clients de régler leurs factures QuickBooks via Whop, avec l'app QuickBooks Sync.

> [card] [Installer QuickBooks Sync](https://whop.com/apps/app_ygXqVjukBrVaU3/install/)
>
> Disponible sur le Whop App Store

L'app QuickBooks Sync connecte une entreprise Whop à une société QuickBooks Online. Utilisez-la pour enregistrer l'activité Whop dans votre comptabilité et pour encaisser le paiement des factures QuickBooks via Whop. Le mode de synchronisation que vous choisissez détermine quelle activité Whop QuickBooks enregistre.

Vous devez disposer d'un accès administrateur à votre entreprise Whop et à une société QuickBooks Online. QuickBooks Desktop n'est pas pris en charge.

## Ce qui est synchronisé

| Activité | Sens | Ce qui se passe |
| - | - | - |
| **Ventes Whop** | Whop → QuickBooks | Un Sales Receipt pour chaque vente (mode All Sales uniquement) |
| **Versements Whop** | Whop → QuickBooks | Un Bank Deposit pour chaque retrait effectué, avec les frais Whop sur une ligne distincte (modes All Sales et Withdrawals Only) |
| **Remboursements** | Dans les deux sens | Un remboursement dans QuickBooks (Refund Receipt ou Credit Memo) rembourse le paiement Whop. Un remboursement dans Whop crée un Refund Receipt dans QuickBooks, sauf en mode Invoicing Only. |
| **Factures** | QuickBooks → Whop | Les nouvelles factures QuickBooks reçoivent un lien de paiement Whop dans le mémo. Lorsque le client paie, l'app marque la facture comme payée. |
| **Transactions récurrentes** | QuickBooks → Whop | Un modèle de facture récurrente crée un plan Whop hebdomadaire, mensuel ou annuel |
| **Produits** | QuickBooks → Whop | Les articles QuickBooks nouveaux ou modifiés créent ou mettent à jour des produits Whop. Les produits Whop n'arrivent dans QuickBooks que via un import rétroactif. |
| **Clients** | Dans les deux sens | Associés par adresse e-mail |

Tant que la connexion est active, l'app désactive QuickBooks Payments sur les nouvelles factures pour que les clients paient via Whop. Les factures déjà ouvertes ne changent pas.

## Configurer l'app

**1. Installez l'app**

Sélectionnez **Installer QuickBooks Sync** en haut de cette page, ou recherchez « QuickBooks Sync » dans le Whop App Store. L'app apparaît ensuite dans votre tableau de bord Whop.

**2. Connectez QuickBooks**

Ouvrez l'app et accédez à **Connection**. Sélectionnez **Connect (Production)** pour votre société réelle, ou **Connect (Sandbox)** pour une société sandbox QuickBooks. Connectez-vous à Intuit, choisissez la société et approuvez la connexion.

**3. Associez vos comptes**

Accédez à **Accounts** et choisissez le compte de revenus, le compte des frais de traitement et le compte bancaire sur lequel arrivent vos retraits Whop. L'app peut créer pour vous un compte de charges « Whop Processing Fees ». Si vous ne choisissez pas de compte de frais, les dépôts de versements n'incluent pas la ligne de frais.

**4. Choisissez un mode de synchronisation**

Accédez à **Overview** et choisissez un mode de synchronisation (voir ci-dessous). Vérifiez-le avant de vous fier à la synchronisation, car le mode détermine si l'app enregistre les ventes Whop individuelles.

**5. Importez les données existantes (facultatif)**

Accédez à **Backfill** pour importer les données antérieures à la connexion :

* **Users to Customers** — crée des clients QuickBooks à partir des membres Whop, associés par e-mail
* **Items / Products** — synchronise les articles entre QuickBooks et Whop
* **Unpaid Invoices** — ajoute des liens de paiement Whop aux factures ouvertes
* **Paid Invoice Matching** — rapproche les factures payées des paiements Whop

L'app ignore les enregistrements déjà associés.

## Modes de synchronisation

Changer de mode n'affecte que l'activité à partir de ce moment. Les enregistrements antérieurs ne changent pas.

| | All Sales | Withdrawals Only | Invoicing Only |
| - | - | - | - |
| **Ventes Whop** | Sales Receipt pour chaque vente | Non enregistrées | Non enregistrées |
| **Versements Whop** | Bank Deposit | Bank Deposit | Non enregistrés |
| **Remboursements Whop** | Refund Receipt | Refund Receipt | Non enregistrés |
| **Factures, modèles récurrents, articles et remboursements QuickBooks** | Synchronisés | Synchronisés | Synchronisés |
| **Idéal pour** | Vendre principalement sur Whop | Suivre uniquement les versements | Utiliser Whop uniquement pour encaisser les factures QuickBooks |

En mode **All Sales**, l'app crée un compte « Whop Clearing ». Les Sales Receipts y sont déposés, et chaque versement transfère le solde vers votre compte bancaire.

En mode Withdrawals Only, l'app enregistre les versements comme des revenus. Si vous facturez aussi vos clients dans QuickBooks, vous comptez ces revenus deux fois : une fois sur la facture et une seconde fois sur le dépôt.

## Taxes

Pour les factures QuickBooks, QuickBooks calcule la taxe et le client paie le total de la facture via Whop. Supprimez les paramètres de taxe des produits Whop correspondants pour que les acheteurs ne soient pas taxés deux fois. Les Sales Receipts des ventes Whop directes enregistrent le montant total sur une seule ligne, sans ligne de taxe distincte.

## Surveiller la synchronisation

**Sync History** liste tous les événements traités par l'app, filtrés par statut. **Errors** liste les événements en échec. L'app réessaie un événement en échec jusqu'à 5 fois, avec des délais croissants entre les tentatives.

## Déconnexion

Accédez à **Connection** et sélectionnez **Disconnect QuickBooks**. L'app conserve votre historique de synchronisation et vos associations si vous vous reconnectez plus tard. Les enregistrements déjà présents dans QuickBooks y restent.

## Étapes suivantes

> [card] [Xero](https://docs.whop.com/fr/third-party-integrations/xero.md)
>
> Envoyez l'activité Whop vers Xero sous forme de flux bancaire.

> [card] [Tarifs et frais](https://docs.whop.com/fr/fees.md)
>
> Consultez les frais qui apparaissent sur vos versements.


## Related topics

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