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

# API Accounts

> Un Account représente une personne ou une entreprise sur Whop qui peut avoir son propre profil, son propre portefeuille et ses propres paramètres au niveau du compte.

Utilisez les comptes pour les clients, créateurs, marchands, vendeurs ou entreprises connectées que votre intégration prend en charge.

Utilisez l'API Accounts pour créer des comptes, lister les comptes visibles avec vos identifiants, récupérer ou mettre à jour un compte, suspendre ou supprimer un sous-compte géré par votre plateforme, et récupérer le compte associé à la clé API actuelle.

Les champs `business_type`, `industry_group` et `industry_type` classent les comptes. Consultez le [glossaire des types d'entreprises et des secteurs](#business-types-and-industries) pour connaître toutes les valeurs valides.

## Endpoints

| Endpoint | Requête |
| - | - |
| [List Accounts](https://docs.whop.com/fr/api-reference/accounts/list-accounts.md) | GET `/accounts` |
| [Retrieve Account](https://docs.whop.com/fr/api-reference/accounts/retrieve-account.md) | GET `/accounts/{id}` |
| [Retrieve Account Customer Tracking](https://docs.whop.com/fr/api-reference/accounts/retrieve-account-customer-tracking.md) | GET `/accounts/{account_id}/customer_tracking` |
| [Retrieve Account Fees](https://docs.whop.com/fr/api-reference/accounts/retrieve-account-fees.md) | GET `/accounts/{account_id}/fees` |
| [List Financing Providers](https://docs.whop.com/fr/api-reference/accounts/list-financing-providers.md) | GET `/accounts/{account_id}/financing_providers` |
| [Retrieve Account Preferences](https://docs.whop.com/fr/api-reference/accounts/retrieve-account-preferences.md) | GET `/accounts/{account_id}/preferences` |
| [List Account Reserves](https://docs.whop.com/fr/api-reference/accounts/list-account-reserves.md) | GET `/accounts/{account_id}/reserves` |
| [Create Account](https://docs.whop.com/fr/api-reference/accounts/create-account.md) | POST `/accounts` |
| [Form Company](https://docs.whop.com/fr/api-reference/accounts/form-company.md) | POST `/accounts/{id}/form_company` |
| [Retry Failed Ads Payments](https://docs.whop.com/fr/api-reference/accounts/retry-failed-ads-payments.md) | POST `/accounts/{id}/retry_ads_payment` |
| [Suspend a Subaccount](https://docs.whop.com/fr/api-reference/accounts/suspend-a-subaccount.md) | POST `/accounts/{id}/suspend` |
| [Transfer Account Ownership](https://docs.whop.com/fr/api-reference/accounts/transfer-account-ownership.md) | POST `/accounts/{id}/transfer_ownership` |
| [Update Account](https://docs.whop.com/fr/api-reference/accounts/update-account.md) | PATCH `/accounts/{id}` |
| [Update Account Fees](https://docs.whop.com/fr/api-reference/accounts/update-account-fees.md) | PATCH `/accounts/{account_id}/fees` |
| [Update Account Preferences](https://docs.whop.com/fr/api-reference/accounts/update-account-preferences.md) | PATCH `/accounts/{account_id}/preferences` |
| [Delete a Subaccount](https://docs.whop.com/fr/api-reference/accounts/delete-a-subaccount.md) | DELETE `/accounts/{id}` |

## Majorations de frais

Les majorations de frais permettent à une plateforme d'ajouter des frais ou de subventionner les frais de versement de ses sous-comptes. Gérez-les via le document des frais du compte : définissez des valeurs par défaut sur le compte de plateforme ou remplacez des frais individuels sur un sous-compte. Consultez [Majorations et subventions de frais](https://docs.whop.com/fr/developer/platforms/fee-markups.md) pour des exemples, les limites et les exigences de financement.

### Endpoints des frais

| Action | Endpoint | Méthode du SDK |
| - | - | - |
| [Récupérer les frais du compte](https://docs.whop.com/fr/api-reference/accounts/retrieve-account-fees.md) | `GET /api/v1/accounts/{account_id}/fees` | `client.accounts.fees.retrieve(accountId)` |
| [Mettre à jour les frais du compte](https://docs.whop.com/fr/api-reference/accounts/update-account-fees.md) | `PATCH /api/v1/accounts/{account_id}/fees` | `client.accounts.fees.update(accountId, changes)` |

Utilisez la clé API du compte de plateforme disposant de l'autorisation `company:update_child_fees` pour configurer les majorations. Chaque majoration renvoyée inclut `adjustable` et `unadjustable_reason` afin que votre intégration puisse déterminer si la modification est possible.

### Lire les frais

```typescript theme={null}
const fees = await client.accounts.fees.retrieve("biz_connected_account");
```

La section `markups` contient les taux effectifs du sous-compte. La section `child_markups` d'un compte de plateforme contient ses valeurs par défaut pour les sous-comptes.

Le `source` d'une majoration vaut `custom` lorsqu'elle est configurée à ce niveau, ou `default` lorsqu'elle se rabat sur un taux hérité ou sur zéro. Son champ `default` indique le taux qui s'appliquerait si la majoration personnalisée était supprimée. Les montants fixes renvoyés utilisent l'objet Money ; les mises à jour acceptent `fixed` sous forme de nombre en dollars américains.

### Définir les valeurs par défaut de la plateforme

Mettez à jour `child_markups` sur le compte de plateforme. Cet exemple définit une majoration de paiement de 2 % sans frais fixes :

```typescript theme={null}
await client.accounts.fees.update("biz_platform_id", {
	child_markups: { payments: { percentage: 2, fixed: 0 } },
});
```

`percentage: 2` signifie 2 %. Les valeurs par défaut s'appliquent aux sous-comptes sans remplacement pour ces frais. Les majorations de paiement s'appliquent lorsqu'aucuns frais d'application de checkout ne sont définis.

### Définir un remplacement pour un sous-compte

Mettez à jour `markups` sur le sous-compte. Cet exemple remplace sa majoration de paiement héritée par 1 % plus 0,25 \$ :

```typescript theme={null}
await client.accounts.fees.update("biz_connected_account", {
	markups: { payments: { percentage: 1, fixed: 0.25 } },
});
```

Seules les clés que vous envoyez changent. Pour les autres types de transactions, utilisez `transfers`, `crypto_swaps`, `deposits` indexés par rail, ou `payouts` indexés par moyen de versement. Consultez l'[endpoint de mise à jour](https://docs.whop.com/fr/api-reference/accounts/update-account-fees.md) pour connaître les clés prises en charge et le schéma de la requête.

### Supprimer une majoration

Envoyez `null` pour la majoration afin de la supprimer. Supprimer le remplacement d'un sous-compte rétablit la valeur par défaut de sa plateforme, ou zéro si aucune valeur par défaut n'est configurée :

```typescript theme={null}
await client.accounts.fees.update("biz_connected_account", {
	markups: { payments: null },
});
```

Pour supprimer une valeur par défaut de la plateforme, envoyez `child_markups: { payments: null }` au compte de plateforme. Un `{ percentage: 0, fixed: 0 }` explicite reste un taux configuré ; utilisez `null` pour rétablir l'héritage.

## Documents juridiques

Un compte publie ses documents juridiques sous forme de fichiers PDF : `terms_of_service`, `privacy_policy`, `return_policy`, `cancellation_policy`, `shipping_policy` et `eula`. Chacun est renvoyé en lecture sous forme de [File](https://docs.whop.com/fr/api-reference/files/file) et se définit via [Update Account](https://docs.whop.com/fr/api-reference/accounts/update-account.md) avec l'`id` d'un fichier que vous avez [téléversé](https://docs.whop.com/fr/developer/guides/upload-files.md).

Les nouveaux litiges utilisent par défaut ces documents comme preuves de politique. L'emplacement de politique d'annulation prend `cancellation_policy`, puis `terms_of_service`, puis `return_policy`. L'emplacement de politique de remboursement prend `return_policy`, puis `terms_of_service`. Chaque emplacement se rabat sur la politique de la plateforme Whop lorsqu'aucun n'est défini, et `shipping_policy` est joint aux litiges portant sur des biens physiques. Définissez-les une fois ici, et n'utilisez [Upload Dispute Evidence](https://docs.whop.com/fr/api-reference/disputes/upload-dispute-evidence.md) que lorsqu'un litige nécessite une version différente d'une politique.

```typescript TypeScript theme={null}
import { readFile } from "node:fs/promises";

const file = await client.files.create({ filename: "terms-of-service.pdf" });
await fetch(file.upload_url!, {
	method: "PUT",
	headers: file.upload_headers as Record<string, string>,
	body: await readFile("./terms-of-service.pdf"),
});

await client.accounts.update({
	id: "biz_xxxxxxxxxxxxx",
	terms_of_service: { id: file.id },
});
```

```python Python theme={null}
import requests

file = client.files.create(filename="terms-of-service.pdf")
with open("./terms-of-service.pdf", "rb") as contents:
    requests.put(file.upload_url, headers=file.upload_headers or {}, data=contents)

client.accounts.update(
    "biz_xxxxxxxxxxxxx",
    terms_of_service={"id": file.id},
)
```

Envoyez `null` pour un document afin de le supprimer. Seuls les fichiers PDF sont acceptés.

## Attributs

**id** `string` *required*

ID du compte, préfixé par `biz_`.

**ads\_spend\_usd** `number | null` *required*

Dépenses publicitaires facturées sur toute la durée de vie du compte, en USD. Calculé uniquement sur `list` pour les appelants disposant de `stats:read` sur le compte ; `null` sinon.

**balances** `object[]` *required*

Avoirs du compte, chacun avec sa valeur en USD. Vide lorsque `total_usd` vaut `null`.

> [accordion] Propriétés
>
> **balance** `string` *required*
>
> Montant total détenu en unités natives, sous forme de chaîne décimale.
>
> **breakdown** `object` *required*
>
> Solde réparti en montants disponible, en attente et en réserve, sous forme de chaînes décimales en unités natives, avec les jours où le montant en attente devrait être réglé.
>
> > [accordion] Propriétés
> >
> > **available** `string` *required*
> >
> > Montant que vous pouvez dépenser, envoyer ou retirer dès maintenant, en unités natives, sous forme de chaîne décimale.
> >
> > **finishing\_settlement** `string` *required*
> >
> > La part de `pending` qui est déjà réglée et attend d'être transférée vers le portefeuille crypto du compte ou la Whop Card, où elle devient `available`. Le transfert commence généralement dans l'heure ; pendant son exécution, le montant est indiqué dans `in_transit` à la place. L'argent déplacé uniquement pour compléter le solde minimum conservé du compte n'est pas inclus. En unités natives, sous forme de chaîne décimale.
> >
> > **in\_transit** `string` *required*
> >
> > Montant en cours de transfert entre les propres destinations du compte, comme une recharge de carte. En unités natives, sous forme de chaîne décimale.
> >
> > **pending** `string` *required*
> >
> > Montant provenant de paiements récents encore en cours de règlement, en unités natives, sous forme de chaîne décimale.
> >
> > **pending\_settlements** `object[]` *required*
> >
> > Date à laquelle le montant en attente devrait être réglé, une entrée par jour, la plus proche en premier. L'argent sans jour de règlement prévu, y compris `finishing_settlement`, est exclu : ces entrées plus `finishing_settlement` peuvent donc totaliser moins que `pending`, jamais plus.
> >
> > > [accordion] Propriétés
> > >
> > > **amount** `string` *required*
> > >
> > > Montant attendu ce jour-là, en unités natives, sous forme de chaîne décimale.
> > >
> > > **date** `string` *required*
> > >
> > > Le jour où cet argent devrait finir d'être réglé, sous forme de date ISO 8601.
> >
> > **reserve** `string` *required*
> >
> > Montant retenu, en unités natives, sous forme de chaîne décimale. Récupérez les réserves du compte pour savoir pourquoi il est retenu et quand il sera débloqué.
>
> **icon\_url** `string | null` *required*
>
> URL de l'icône de l'avoir.
>
> **name** `string` *required*
>
> Le nom d'affichage de l'avoir
>
> **price\_usd** `number | null` *required*
>
> Prix en USD par unité, ou `null` lorsqu'aucun taux de change n'est disponible.
>
> **symbol** `string` *required*
>
> Symbole d'affichage de l'avoir, comme `USDT`, `cbBTC` ou `EUR`.
>
> **value\_usd** `string | null` *required*
>
> Valeur de l'avoir en USD, ou `null` lorsqu'aucun taux de change n'est disponible.

**banner\_image\_url** `string | null` *required*

URL de l'image de bannière du compte.

**business\_address** `object | null` *required*

Adresse professionnelle du compte utilisée pour calculer les taxes, avec `line1`, `line2`, `city`, `state`, `postal_code` et `country`. `null` lorsqu'aucune adresse n'est définie.

**business\_name** `string | null` *required*

La raison sociale du compte utilisée avec son adresse fiscale.

**business\_type** `string | null` *required*

Catégorie d'activité générale du compte. Consultez le [glossaire des types d'entreprises et des secteurs](https://docs.whop.com/fr/api-reference/accounts/account#business-types-and-industries-glossary) pour connaître les valeurs valides.

**can\_transfer\_pending\_balance\_to\_children** `boolean` *required*

Indique si les fonds en attente peuvent être transférés de ce compte de plateforme vers ses sous-comptes.

**cancellation\_policy** `object | null` *required*

Le document de politique d'annulation du compte, ou `null` s'il n'en a pas publié.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'ID du fichier, préfixé par `file_`.
>
> **blurhash** `string | null` *required*
>
> Espace réservé BlurHash pour une image ou une vidéo. Null lorsqu'il est indisponible ou supprimé par la modération.
>
> **content\_type** `string | null` *required*
>
> Le type MIME du fichier d'origine, par exemple `application/pdf`. Il est conservé lorsque la modération supprime le fichier.
>
> **created\_at** `string` *required*
>
> Date de création du fichier, sous forme d'horodatage ISO 8601.
>
> **duration\_seconds** `number | null` *required*
>
> Durée de l'audio ou de la vidéo en secondes. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **filename** `string | null` *required*
>
> Le nom du fichier d'origine, extension comprise.
>
> **height** `integer | null` *required*
>
> Hauteur de l'image ou de la vidéo en pixels. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **multipart\_chunk\_size** `integer | null`
>
> La taille en octets que doit avoir chaque partie (sauf la dernière). Présent uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> **multipart\_upload\_id** `string | null`
>
> L'ID du téléversement en plusieurs parties, à renvoyer à `complete`. Présent uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> **multipart\_upload\_urls** `object[] | null`
>
> L'URL présignée de chaque partie. Présente uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> > [accordion] Propriétés
> >
> > **part\_number** `integer` *required*
> >
> > L'index (à partir de 1) de cette partie dans le téléversement en plusieurs parties.
> >
> > **url** `string` *required*
> >
> > L'URL présignée vers laquelle envoyer (PUT) les octets de cette partie.
>
> **object** `string` *required*
>
> Le type de cet objet, toujours `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Indique si la modération a supprimé le fichier. Lorsque `true`, `url` sert une image de remplacement. `filename`, `size` et `content_type` décrivent toujours le fichier d'origine.
>
> **size** `integer | null` *required*
>
> La taille du fichier en octets. `null` tant que le téléversement n'est pas terminé.
>
> **upload\_headers** `object`
>
> En-têtes à envoyer avec le PUT de téléversement. Présents uniquement à la création.
>
> **upload\_status** `string` *required*
>
> L'étape du cycle de vie de téléversement où se trouve le fichier.
>
> Options disponibles : `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> URL présignée vers laquelle envoyer (PUT) les octets du fichier. Présente uniquement à la création, et uniquement pour les téléversements en une seule partie.
>
> **url** `string | null` *required*
>
> Une URL pour télécharger le fichier. Les fichiers publics obtiennent une URL CDN permanente, et les fichiers privés une URL signée qui expire. `null` tant que le téléversement n'est pas terminé. Lorsque la modération supprime le fichier, une URL d'image de remplacement.
>
> **visibility** `string` *required*
>
> Les fichiers `public` sont servis depuis une URL CDN non signée. Les fichiers `private` sont servis depuis une URL signée qui expire.
>
> Options disponibles : `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL de la forme d'onde audio. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **width** `integer | null` *required*
>
> Largeur de l'image ou de la vidéo en pixels. Null lorsqu'elle est indisponible ou supprimée par la modération.

**capabilities** `object | null` *required*

Rails de paiement activés pour ce compte, chacun `active`, `inactive` ou `pending` (intégration ou examen en cours). Calculé uniquement sur `retrieve` et `me` pour les appelants disposant de la portée `company:balance:read` ; `null` sinon.

> [accordion] Propriétés
>
> **accept\_bank\_payments** `string` *required*
>
> Encaissements bancaires : prélèvements, virements et rails bancaires locaux
>
> Options disponibles : `active`, `inactive`, `pending`
>
> **accept\_bnpl\_payments** `string` *required*
>
> Encaissements en paiement fractionné (buy-now-pay-later) ; nécessite une approbation
>
> Options disponibles : `active`, `inactive`, `pending`
>
> **accept\_card\_payments** `string` *required*
>
> Encaissements par carte, y compris Apple Pay et Google Pay
>
> Options disponibles : `active`, `inactive`, `pending`
>
> **bank\_deposit** `string` *required*
>
> Dépôts par virement bancaire ou ACH sur le compte bancaire virtuel du compte
>
> Options disponibles : `active`, `inactive`, `pending`
>
> **card\_deposit** `string` *required*
>
> Recharges de solde en débitant un moyen de paiement enregistré
>
> Options disponibles : `active`, `inactive`, `pending`
>
> **card\_issuing** `string` *required*
>
> Émission de cartes Whop ; nécessite l'approbation de la demande de carte
>
> Options disponibles : `active`, `inactive`, `pending`
>
> **crypto\_deposit** `string` *required*
>
> Dépôts on-chain sur le portefeuille crypto du compte
>
> Options disponibles : `active`, `inactive`, `pending`
>
> **crypto\_payout** `string` *required*
>
> Versements on-chain vers un portefeuille crypto
>
> Options disponibles : `active`, `inactive`, `pending`
>
> **instant\_payout** `string` *required*
>
> Versements instantanés vers une destination de versement éligible
>
> Options disponibles : `active`, `inactive`, `pending`
>
> **run\_ads** `string` *required*
>
> Lancement de campagnes publicitaires via Whop Ads. `inactive` tant que l'identité ou l'entreprise du compte n'est pas vérifiée, tant qu'un contrat de services publicitaires demandé attend la signature du compte, et tant que le compte est suspendu de Whop Ads.
>
> Options disponibles : `active`, `inactive`, `pending`
>
> **standard\_payout** `string` *required*
>
> Versements standard vers une destination de versement externe
>
> Options disponibles : `active`, `inactive`, `pending`
>
> **transfer** `string` *required*
>
> Transferts vers d'autres comptes
>
> Options disponibles : `active`, `inactive`, `pending`

**cards** `object | null` *required*

Détails de la demande Whop Cards du compte. Renvoyé sur `list`, `retrieve` et `me` pour les appelants disposant de la portée `company:balance:read` ; `null` sinon, ou lorsque le compte n'a aucune demande de carte ni examen de demande bloquant.

> [accordion] Propriétés
>
> **decline\_reason** `string | null` *required*
>
> Motif pour lequel l'émetteur de la carte a refusé la demande. `unsupported_state` remplace `unsupported_region` pour une personne ou une entreprise vérifiée aux États-Unis. `compliance` couvre les contrôles de sanctions, de personnes politiquement exposées et de médias défavorables. `other` couvre les motifs qui ne figurent pas dans cette liste. `null` lorsque `status` n'est pas `denied`, ou lorsque l'émetteur n'a pas refusé la demande.
>
> Options disponibles : `compromised_identity`, `duplicate`, `unsupported_region`, `compliance`, `fraud`, `verification_failed`, `unsupported_state`, `other`
>
> **kind** `string | null` *required*
>
> Indique si la demande de carte vérifie une entreprise (`business`, KYB) ou une personne (`individual`, identité du consommateur). `null` lorsque la demande n'est pas encore liée à une vérification.
>
> Options disponibles : `individual`, `business`
>
> **status** `string` *required*
>
> L'état de la demande de carte. `approved` signifie que des cartes peuvent être émises. `needs_verification` signifie que le demandeur n'a pas encore terminé la vérification d'identité ; `needs_information` signifie qu'il l'a fait, mais que les documents ont été rejetés pour un motif corrigeable et doivent être soumis à nouveau. `pending` et `manual_review` sont en cours. `denied`, `locked` et `canceled` sont définitifs.
>
> Options disponibles : `approved`, `pending`, `manual_review`, `denied`, `locked`, `canceled`, `needs_verification`, `needs_information`

**collect\_vat\_id** `boolean` *required*

Indique si le paiement affiche un champ de numéro de TVA/identifiant fiscal que les acheteurs peuvent renseigner facultativement. N'exige pas de numéro de TVA pour acheter.

**company\_formation** `object` *required*

État de création de société du compte, géré via [Form Company](https://docs.whop.com/fr/api-reference/accounts/form-company.md). Un `status` `draft` jusqu'au paiement du checkout de création, puis l'avancement du dépôt avec les documents téléchargeables et les signatures en attente. Vide lorsque l'état de création est temporairement indisponible.

> [accordion] Propriétés
>
> **documents** `object[]`
>
> Documents de création disponibles au téléchargement, comme les Articles of Organization et la lettre de confirmation de l'EIN. Présent dès que `status` quitte `draft`.
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > ID du document, préfixé par `file_`.
> >
> > **name** `string` *required*
> >
> > Nom lisible du document, comme `Articles of Organization`.
> >
> > **type** `string` *required*
> >
> > Catégorie du document : `articles_of_organization`, `operating_agreement`, `ein_letter`, `signed_ss4`, `signed_form8821`, ou `mail` pour le courrier postal reçu au nom de la société.
> >
> > **url** `string` *required*
> >
> > URL CDN pour télécharger le document.
>
> **ein\_registered** `boolean`
>
> Indique si l'EIN de la société a été émis par l'IRS. Présent dès que `status` quitte `draft`.
>
> **legal\_name** `string | null`
>
> Nom enregistré de la société, y compris la forme juridique, par exemple `Acme, LLC`. Présent dès que `status` quitte `draft`.
>
> **signatures** `object`
>
> Formulaires IRS en attente de la signature d'un fondateur, chacun avec une URL de signature hébergée. Présent dès que `status` quitte `draft` ; vide lorsqu'il n'y a rien à signer.
>
> > [accordion] Propriétés
> >
> > **form8821** `object`
> >
> > État de signature du formulaire IRS 8821, l'autorisation d'accès aux informations fiscales. Présent uniquement tant que le formulaire nécessite encore une action du fondateur.
> >
> > > [accordion] Propriétés
> > >
> > > **expires\_at** `string`
> > >
> > > Date d'expiration de l'URL de signature, sous forme d'horodatage ISO 8601. Présent uniquement lorsque l'URL de signature est incluse.
> > >
> > > **status** `string` *required*
> > >
> > > `pending` lorsqu'une session de signature est prête pour le fondateur ; `unknown` lorsque l'état de la signature n'a pas pu être déterminé.
> > >
> > > Options disponibles : `pending`, `unknown`
> > >
> > > **url** `string`
> > >
> > > URL de signature hébergée où le fondateur remplit le formulaire. Présente tant que `status` vaut `pending` et que l'appelant dispose de `incorporation:write`. Omise des webhooks.
> >
> > **ss4** `object`
> >
> > État de signature du formulaire IRS SS-4, la demande d'EIN. Présent uniquement tant que le formulaire nécessite encore une action du fondateur.
> >
> > > [accordion] Propriétés
> > >
> > > **expires\_at** `string`
> > >
> > > Date d'expiration de l'URL de signature, sous forme d'horodatage ISO 8601. Présent uniquement lorsque l'URL de signature est incluse.
> > >
> > > **status** `string` *required*
> > >
> > > `pending` lorsqu'une session de signature est prête pour le fondateur ; `unknown` lorsque l'état de la signature n'a pas pu être déterminé.
> > >
> > > Options disponibles : `pending`, `unknown`
> > >
> > > **url** `string`
> > >
> > > URL de signature hébergée où le fondateur remplit le formulaire. Présente tant que `status` vaut `pending` et que l'appelant dispose de `incorporation:write`. Omise des webhooks.
>
> **state\_registered** `boolean`
>
> Indique si le dépôt de création de société auprès de l'État est terminé. Présent dès que `status` quitte `draft`.
>
> **status** `string`
>
> Options disponibles : `draft`, `processing`, `filed`, `rejected`, `completed`

**country** `string | null` *required*

Pays où se trouve le compte.

**created\_at** `string` *required*

Date de création du compte, sous forme d'horodatage ISO 8601.

**customers\_l30d** `integer | null` *required*

Clients distincts ayant un reçu payé auprès du compte au cours des 30 derniers jours, actualisé toutes les quelques heures. Calculé uniquement sur `retrieve` pour les appelants disposant de `stats:read` sur le compte ; `null` sinon, ainsi que lorsque le décompte est indisponible.

**description** `string | null` *required*

Description promotionnelle du compte.

**direct\_reports\_count** `integer`

Nombre de membres de l'équipe qui relèvent directement de l'entreprise, sans responsable au-dessus d'eux. Présent sur les lectures d'un seul compte.

**dispute\_fighter\_enabled** `boolean` *required*

Indique si Whop constitue et dépose les preuves de litige pour ce compte. L'activer inscrit le compte aux frais de succès facturés sur les litiges qu'il remporte.

**economic\_intelligence** `boolean` *required*

Indique si Economic Intelligence est activé pour le compte. Il se désactive automatiquement à la fin de sa période d'engagement. Tant qu'il est désactivé, le compte ne peut ni activer une expérience ni exécuter une recommandation.

**email** `string | null` *required*

Adresse e-mail du propriétaire du compte.

**eula** `object | null` *required*

Le document de contrat de licence utilisateur final du compte, ou `null` s'il n'en a pas publié.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'ID du fichier, préfixé par `file_`.
>
> **blurhash** `string | null` *required*
>
> Espace réservé BlurHash pour une image ou une vidéo. Null lorsqu'il est indisponible ou supprimé par la modération.
>
> **content\_type** `string | null` *required*
>
> Le type MIME du fichier d'origine, par exemple `application/pdf`. Il est conservé lorsque la modération supprime le fichier.
>
> **created\_at** `string` *required*
>
> Date de création du fichier, sous forme d'horodatage ISO 8601.
>
> **duration\_seconds** `number | null` *required*
>
> Durée de l'audio ou de la vidéo en secondes. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **filename** `string | null` *required*
>
> Le nom du fichier d'origine, extension comprise.
>
> **height** `integer | null` *required*
>
> Hauteur de l'image ou de la vidéo en pixels. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **multipart\_chunk\_size** `integer | null`
>
> La taille en octets que doit avoir chaque partie (sauf la dernière). Présent uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> **multipart\_upload\_id** `string | null`
>
> L'ID du téléversement en plusieurs parties, à renvoyer à `complete`. Présent uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> **multipart\_upload\_urls** `object[] | null`
>
> L'URL présignée de chaque partie. Présente uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> > [accordion] Propriétés
> >
> > **part\_number** `integer` *required*
> >
> > L'index (à partir de 1) de cette partie dans le téléversement en plusieurs parties.
> >
> > **url** `string` *required*
> >
> > L'URL présignée vers laquelle envoyer (PUT) les octets de cette partie.
>
> **object** `string` *required*
>
> Le type de cet objet, toujours `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Indique si la modération a supprimé le fichier. Lorsque `true`, `url` sert une image de remplacement. `filename`, `size` et `content_type` décrivent toujours le fichier d'origine.
>
> **size** `integer | null` *required*
>
> La taille du fichier en octets. `null` tant que le téléversement n'est pas terminé.
>
> **upload\_headers** `object`
>
> En-têtes à envoyer avec le PUT de téléversement. Présents uniquement à la création.
>
> **upload\_status** `string` *required*
>
> L'étape du cycle de vie de téléversement où se trouve le fichier.
>
> Options disponibles : `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> URL présignée vers laquelle envoyer (PUT) les octets du fichier. Présente uniquement à la création, et uniquement pour les téléversements en une seule partie.
>
> **url** `string | null` *required*
>
> Une URL pour télécharger le fichier. Les fichiers publics obtiennent une URL CDN permanente, et les fichiers privés une URL signée qui expire. `null` tant que le téléversement n'est pas terminé. Lorsque la modération supprime le fichier, une URL d'image de remplacement.
>
> **visibility** `string` *required*
>
> Les fichiers `public` sont servis depuis une URL CDN non signée. Les fichiers `private` sont servis depuis une URL signée qui expire.
>
> Options disponibles : `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL de la forme d'onde audio. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **width** `integer | null` *required*
>
> Largeur de l'image ou de la vidéo en pixels. Null lorsqu'elle est indisponible ou supprimée par la modération.

**external\_id** `string | null` *required*

L'identifiant propre à la plateforme parente pour ce sous-compte, unique parmi les sous-comptes de la plateforme. `null` lorsqu'il n'est pas défini.

**financing** `object | null` *required*

La demande de financement la plus récente du compte. Calculé uniquement sur `retrieve` et `me` pour les appelants disposant de la portée `company:balance:read` ; `null` sinon, ou lorsque le compte n'a jamais demandé de financement.

> [accordion] Propriétés
>
> **application\_id** `string` *required*
>
> L'ID de la demande de financement la plus récente du compte, commençant par inrq\_. Récupérez-la pour connaître les exigences et les retours d'examen.
>
> **status** `string` *required*
>
> L'état d'examen de la demande de financement la plus récente : `requires_collection` (en attente du marchand, y compris après une demande d'informations complémentaires), `awaiting_review`, `approved`, `denied` ou `completed`. L'activation des moyens de paiement par financement est indiquée par `capabilities.accept_bnpl_payments`.
>
> Options disponibles : `requires_collection`, `awaiting_review`, `completed`, `approved`, `denied`

**funds\_release\_at** `string | null` *required*

Date à partir de laquelle un compte suspendu peut verser son solde vers son propre moyen de versement, sous forme d'horodatage ISO 8601. Un litige peut la repousser. Calculé sur `retrieve`, `me` et `suspend` ; `null` sinon, lorsque `status` n'est pas `suspended`, et lorsque la suspension bloque le solde.

**home\_preferences** `string[]` *required*

Préférences de la page d'accueil publique du compte.

Options disponibles : `hide_member_count`, `hide_members_card`

**industry\_type** `string | null` *required*

Secteur d'activité spécifique du compte. Consultez le [glossaire des types d'entreprises et des secteurs](https://docs.whop.com/fr/api-reference/accounts/account#business-types-and-industries-glossary) pour connaître les valeurs valides.

**invoice\_prefix** `string | null` *required*

Préfixe utilisé pour les factures du compte.

**level** `object | null` *required*

La progression Whop Levels du `owner` du compte, comptabilisée sur l'ensemble des comptes qu'il possède, afin qu'ils affichent tous le même niveau. Calculé uniquement sur `retrieve` et `me` pour les appelants disposant de la portée `company:basic:read` ; `null` sinon, ainsi que lorsque le compte ne fait pas partie de Whop Levels.

> [accordion] Propriétés
>
> **account\_level** `integer` *required*
>
> Le niveau propre à ce compte, à partir de ses seuls points, de `0` à `10`. `current` est plus élevé lorsque les autres comptes du propriétaire le font monter.
>
> **current** `integer` *required*
>
> Le niveau qui s'applique : le plus élevé atteint par le propriétaire ce mois-ci ou au cours des 5 mois précédents, de `0` à `10`.
>
> **points** `integer` *required*
>
> Points gagnés ce mois-ci sur l'ensemble des comptes du propriétaire, plus ses points de partenaire, arrondis à l'inférieur. Un compte dont le solde mensuel est négatif compte pour zéro.
>
> **points\_by\_source** `object` *required*
>
> Les points de ce mois-ci, répartis selon leur provenance. Chaque source est nette de ses remboursements : l'une d'elles peut donc être négative.
>
> > [accordion] Propriétés
> >
> > **ads** `integer` *required*
> >
> > Points issus des frais Whop Ads payés, nets des remboursements : 10 par dollar, arrondis vers zéro.
> >
> > **cards** `integer` *required*
> >
> > Points issus des dépenses Whop Card capturées, nets des remboursements : 10 par dollar, arrondis vers zéro.
> >
> > **partners** `integer` *required*
> >
> > Points issus des comptes que le propriétaire a parrainés en tant que partenaire : 1 pour 3 points qu'ils gagnent, arrondis vers zéro.
> >
> > **trading** `integer` *required*
> >
> > Points issus du volume de trading de contrats perpétuels exécuté via Whop : 1 par dollar échangé, arrondis vers zéro.
>
> **resets\_at** `string` *required*
>
> Date à laquelle les points de ce mois-ci sont remis à zéro, sous forme d'horodatage ISO 8601.

**logo\_url** `string | null` *required*

URL de l'image du logo du compte.

**metadata** `object` *required*

Métadonnées clé/valeur arbitraires fournies lors de la création du compte.

**onboarding\_type** `string | null` *required*

Type d'intégration (onboarding) effectuée par le compte.

Options disponibles : `platform`, `seller`

**opengraph\_image\_url** `string | null` *required*

URL de l'image Open Graph du compte.

**opengraph\_image\_variant** `string | null` *required*

Variante de l'image Open Graph du compte.

Options disponibles : `white`, `black`, `orange`

**orchestration\_enabled** `boolean` *required*

Indique si l'orchestration des paiements est activée pour ce compte.

**other\_business\_description** `string | null` *required*

Détails du type d'entreprise lorsque business\_type vaut `other`.

**other\_industry\_description** `string | null` *required*

Détails du secteur lorsque industry\_type vaut `other`.

**owner** `object` *required*

L'utilisateur unique qui possède le compte, dont l'e-mail est le `email` ci-dessus. À distinguer du rôle `owner` des membres de l'équipe, que n'importe quel nombre d'entre eux peut détenir.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID de l'utilisateur, préfixé par `user_`.
>
> **name** `string | null` *required*
>
> Nom d'affichage.
>
> **profile\_picture** `object` *required*
>
> Conteneur de l'avatar. Son `url` est toujours présent, et correspond à un espace réservé généré lorsque l'utilisateur n'a défini aucune photo.
>
> > [accordion] Propriétés
> >
> > **url** `string` *required*
> >
> > URL de l'image de l'avatar. Toujours présente. Il s'agit d'un espace réservé généré lorsque l'utilisateur n'a défini aucune photo.
>
> **username** `string` *required*
>
> Nom d'utilisateur public.

**parent\_account** `object | null` *required*

Compte parent des sous-comptes, ou `null` pour les comptes autonomes.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du compte, préfixé par `biz_`.
>
> **fees** `object`
>
> Taux de majoration que ce parent facture au sous-compte lu, indexés par type de frais (par exemple `crypto_deposit_markup`), chacun avec `percentage_fee` et `fixed_fee_usd`. Résolus en donnant la priorité aux remplacements propres au sous-compte sur la valeur par défaut de la plateforme.
>
> **logo\_url** `string | null` *required*
>
> URL de l'image du logo du compte.
>
> **route** `string` *required*
>
> Identifiant de route public du compte.
>
> **title** `string` *required*
>
> Nom d'affichage du compte.

**partner** `object | null`

Le partenaire de premier niveau actif du compte. Présent sur les réponses de retrieve ; null lorsqu'aucun partenaire de premier niveau actif n'est attribué au compte. Omis des autres réponses.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID de l'utilisateur, préfixé par `user_`.
>
> **email** `string | null` *required*
>
> Adresse e-mail pour contacter le partenaire. Null lorsque le partenaire n'a pas ajouté sa propre adresse e-mail.
>
> **name** `string | null` *required*
>
> Nom d'affichage.
>
> **profile\_picture** `object` *required*
>
> Conteneur de l'avatar. Son `url` est toujours présent, et correspond à un espace réservé généré lorsque l'utilisateur n'a défini aucune photo.
>
> > [accordion] Propriétés
> >
> > **url** `string` *required*
> >
> > URL de l'image de l'avatar. Toujours présente. Il s'agit d'un espace réservé généré lorsque l'utilisateur n'a défini aucune photo.
>
> **referring\_account** `object | null` *required*
>
> Entreprise au nom de laquelle le partenaire a parrainé ce compte, lorsque le parrainage appartient à son équipe. `null` pour un parrainage personnel.
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > ID du compte, préfixé par `biz_`.
> >
> > **title** `string` *required*
> >
> > Nom d'affichage du compte.
>
> **username** `string` *required*
>
> Nom d'utilisateur public.
>
> **whop\_partner\_verified\_at** `string | null` *required*
>
> Date à laquelle l'utilisateur est devenu un Whop Partner vérifié, sous forme d'horodatage ISO 8601. Null s'il n'est pas vérifié.

**payment\_controls** `object | null` *required*

Contrôles de santé des paiements actuellement appliqués au compte. Calculé uniquement sur `retrieve` et `me` pour les appelants disposant de la portée `company:balance:read` ; `null` sinon.

> [accordion] Propriétés
>
> **dispute\_alert\_auto\_refund** `object` *required*
>
> Paramètres de remboursement automatique pour les alertes de litige avant rétrofacturation.
>
> > [accordion] Propriétés
> >
> > **locked** `boolean` *required*
> >
> > Indique si le propriétaire du compte est empêché de modifier ce seuil.
> >
> > **threshold\_usd** `number | null` *required*
> >
> > Montant maximal d'alerte de litige remboursé automatiquement, en USD. `null` lorsque les remboursements automatiques sont désactivés.
>
> **dispute\_alert\_fee\_usd** `number | null` *required*
>
> Frais facturés pour chaque alerte de litige, en USD. `null` lorsqu'ils sont indisponibles.
>
> **enforce\_3ds** `boolean` *required*
>
> Indique si 3-D Secure est imposé sur chaque paiement par carte au checkout. Le compte ne peut pas le contourner tant qu'il est défini.
>
> **financing\_disabled** `boolean` *required*
>
> Indique si les contrôles de santé des paiements désactivent explicitement le financement. Ceci est indépendant de l'approbation du financement dans `capabilities.accept_bnpl_payments`.
>
> **high\_risk\_processing\_fee\_percentage** `number` *required*
>
> Pourcentage de frais de traitement supplémentaires pour le traitement à haut risque.
>
> **payment\_method\_warnings** `object[]` *required*
>
> Moyens de paiement pour lesquels le compte a été averti qu'ils approchent de leur seuil de taux de litiges. Chaque entrée contient `payment_method`, `measure` (`disputes`, `disputes_and_tc40s` ou `fraud_disputes`), `warned_at` sous forme d'horodatage ISO 8601, ainsi que `rate`, `warning_rate` et `target_rate` sous forme de fractions où `0.01` correspond à 1 %. Vide lorsqu'aucun n'a fait l'objet d'un avertissement. Un moyen averti est mis en pause, et apparaît dans `restricted_payment_methods`, s'il dépasse toujours son taux cible environ quatre semaines plus tard.
>
> **pending\_auto\_topup\_fee\_percentage** `number` *required*
>
> Pourcentage de frais facturés lorsque le solde en attente, non encore réglé, est avancé pour alimenter le solde des cartes du compte, où `2` signifie 2 %. `0` lorsque le compte en est exempté.
>
> **pending\_balance\_delay\_days** `integer` *required*
>
> Nombre de jours supplémentaires pendant lesquels les paiements restent en attente avant de devenir disponibles.
>
> **reserve** `object` *required*
>
> Réserve actuellement appliquée au volume de paiements entrants.
>
> > [accordion] Propriétés
> >
> > **hold\_period\_days** `integer` *required*
> >
> > Nombre de jours pendant lesquels les fonds en réserve sont retenus avant d'être libérés.
> >
> > **percentage** `number | null` *required*
> >
> > Pourcentage du volume de paiements entrants retenu en réserve. `null` lorsqu'aucune réserve n'est appliquée.
>
> **resolution\_center\_auto\_refund** `object` *required*
>
> Paramètres de remboursement automatique pour les dossiers du centre de résolution.
>
> > [accordion] Propriétés
> >
> > **card\_threshold\_usd** `number | null` *required*
> >
> > Montant maximal des dossiers du centre de résolution financés par carte remboursé automatiquement, en USD. `null` lorsque les remboursements automatiques sont désactivés pour les cartes.
> >
> > **financing\_threshold\_usd** `number | null` *required*
> >
> > Montant maximal des dossiers du centre de résolution financés par financement remboursé automatiquement, en USD. `null` lorsque les remboursements automatiques sont désactivés pour le financement.
> >
> > **locked** `boolean` *required*
> >
> > Indique si le propriétaire du compte est empêché de modifier ces seuils.
> >
> > **paypal\_threshold\_usd** `number | null` *required*
> >
> > Montant maximal des dossiers du centre de résolution financés par PayPal remboursé automatiquement, en USD. `null` lorsque les remboursements automatiques sont désactivés pour PayPal.
>
> **restricted\_payment\_methods** `string[]` *required*
>
> Marques de cartes bloquées au checkout pour ce compte. Vide lorsqu'aucune n'est bloquée. Le compte ne peut pas les réactiver lui-même.
>
> Options disponibles : `card_visa`, `card_mastercard`, `card_american_express`, `card_discover_global_network`, `addi`, `affirm`, `afterpay_clearpay`, `alma`, `billie`, `capchase_pay`, `claritypay`, `flex_pay`, `klarna`, `kriya`, `kueski`, `mondu`, `oney`, `scalapay`, `sequra`, `sezzle`, `splitit`, `sunbit`, `tabby`, `tamara`, `zip`, `card_installments_three`, `card_installments_six`, `card_installments_twelve`, `oney_3x`, `oney_4x`, `klarna_pay_now`, `us_bank_account`, `sepa_debit`, `bacs_debit`, `au_becs_debit`, `acss_debit`, `pay_by_bank`, `payto`, `paypal`, `cashapp`, `venmo`, `amazon_pay`, `link`, `wechat_pay`
>
> **undated\_pending\_reason** `string | null` *required*
>
> Raison pour laquelle les fonds en attente sans date de règlement ne bougent pas encore. `kyc_incomplete`, `pending_information_request` et `update_payout_profile` sont des actions que le marchand peut entreprendre. `compliance_review` signifie qu'une vérification déjà soumise par le marchand est en cours d'examen : ces fonds restent donc en attente jusqu'à sa validation. `withdrawals_disabled` signifie que Whop a bloqué les retraits : ces fonds ne peuvent donc pas devenir disponibles. `null` lorsqu'il n'y a aucune raison à afficher — encore en cours de compensation, ou retenus pour une raison non nommée ici.
>
> Options disponibles : `kyc_incomplete`, `pending_information_request`, `update_payout_profile`, `compliance_review`, `withdrawals_disabled`
>
> **withdrawal\_schedule** `object` *required*
>
> Comment le solde du compte est retiré automatiquement.
>
> > [accordion] Propriétés
> >
> > **day** `integer | null` *required*
> >
> > Jour d'exécution du retrait automatique : 0-6 (dimanche-samedi) pour `weekly`, 1-31 pour `monthly`. `null` pour `manual` et `daily`.
> >
> > **frequency** `string` *required*
> >
> > Fréquence à laquelle le solde du compte est retiré automatiquement.
> >
> > Options disponibles : `manual`, `daily`, `weekly`, `monthly`
> >
> > **next\_payout\_date** `string | null` *required*
> >
> > Prochaine date d'exécution prévue du retrait automatique, sous forme de date ISO 8601. `null` pour `manual` et `daily`, où aucune date unique ne s'applique.

**payment\_method\_configuration** `object | null` *required*

Les moyens de paiement par défaut du compte au checkout. Le `payment_method_configuration` propre à une variante ou à une configuration de checkout est prioritaire. `null` lorsque le compte utilise les valeurs par défaut de la plateforme Whop.

> [accordion] Propriétés
>
> **disabled** `string[]` *required*
>
> Moyens de paiement que ce checkout exclut, même lorsque les valeurs par défaut les proposeraient.
>
> **enabled** `string[]` *required*
>
> Moyens de paiement que ce checkout propose en plus de ceux fournis par les valeurs par défaut.
>
> **include\_platform\_defaults** `boolean` *required*
>
> Indique si l'ensemble par défaut de Whop sert de point de départ. Lorsque `false`, seul `enabled` est proposé.

**platform\_credits** `object[]` *required*

Crédits de plateforme émis par Whop, par devise, lus depuis le cache des soldes. Les crédits ne peuvent être dépensés que pour des produits Whop éligibles, comme Whop Ads, ne peuvent jamais être retirés et ne sont pas inclus dans `balances` ni dans `total_usd`. Vide lorsque le compte n'en détient aucun ou que `total_usd` vaut `null`.

> [accordion] Propriétés
>
> **amount** `string` *required*
>
> Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
>
> **currency** `string` *required*
>
> Code de devise ISO 4217 à trois lettres, en minuscules.
>
> **decimals** `integer` *required*
>
> Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
>
> **display\_decimals** `integer` *required*
>
> Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.

**privacy\_policy** `object | null` *required*

Le document de politique de confidentialité du compte, ou `null` s'il n'en a pas publié.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'ID du fichier, préfixé par `file_`.
>
> **blurhash** `string | null` *required*
>
> Espace réservé BlurHash pour une image ou une vidéo. Null lorsqu'il est indisponible ou supprimé par la modération.
>
> **content\_type** `string | null` *required*
>
> Le type MIME du fichier d'origine, par exemple `application/pdf`. Il est conservé lorsque la modération supprime le fichier.
>
> **created\_at** `string` *required*
>
> Date de création du fichier, sous forme d'horodatage ISO 8601.
>
> **duration\_seconds** `number | null` *required*
>
> Durée de l'audio ou de la vidéo en secondes. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **filename** `string | null` *required*
>
> Le nom du fichier d'origine, extension comprise.
>
> **height** `integer | null` *required*
>
> Hauteur de l'image ou de la vidéo en pixels. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **multipart\_chunk\_size** `integer | null`
>
> La taille en octets que doit avoir chaque partie (sauf la dernière). Présent uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> **multipart\_upload\_id** `string | null`
>
> L'ID du téléversement en plusieurs parties, à renvoyer à `complete`. Présent uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> **multipart\_upload\_urls** `object[] | null`
>
> L'URL présignée de chaque partie. Présente uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> > [accordion] Propriétés
> >
> > **part\_number** `integer` *required*
> >
> > L'index (à partir de 1) de cette partie dans le téléversement en plusieurs parties.
> >
> > **url** `string` *required*
> >
> > L'URL présignée vers laquelle envoyer (PUT) les octets de cette partie.
>
> **object** `string` *required*
>
> Le type de cet objet, toujours `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Indique si la modération a supprimé le fichier. Lorsque `true`, `url` sert une image de remplacement. `filename`, `size` et `content_type` décrivent toujours le fichier d'origine.
>
> **size** `integer | null` *required*
>
> La taille du fichier en octets. `null` tant que le téléversement n'est pas terminé.
>
> **upload\_headers** `object`
>
> En-têtes à envoyer avec le PUT de téléversement. Présents uniquement à la création.
>
> **upload\_status** `string` *required*
>
> L'étape du cycle de vie de téléversement où se trouve le fichier.
>
> Options disponibles : `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> URL présignée vers laquelle envoyer (PUT) les octets du fichier. Présente uniquement à la création, et uniquement pour les téléversements en une seule partie.
>
> **url** `string | null` *required*
>
> Une URL pour télécharger le fichier. Les fichiers publics obtiennent une URL CDN permanente, et les fichiers privés une URL signée qui expire. `null` tant que le téléversement n'est pas terminé. Lorsque la modération supprime le fichier, une URL d'image de remplacement.
>
> **visibility** `string` *required*
>
> Les fichiers `public` sont servis depuis une URL CDN non signée. Les fichiers `private` sont servis depuis une URL signée qui expire.
>
> Options disponibles : `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL de la forme d'onde audio. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **width** `integer | null` *required*
>
> Largeur de l'image ou de la vidéo en pixels. Null lorsqu'elle est indisponible ou supprimée par la modération.

**product\_tax\_code** `object | null` *required*

Code de classification fiscale appliqué par défaut aux produits du compte, avec `id`, `name` et `product_type`. `null` lorsqu'aucune valeur par défaut n'est définie.

**recommended\_actions** `object[] | null` *required*

OBSOLÈTE : utilisez plutôt l'endpoint `GET /economic_intelligence?account_id=\{account_id}`.

> [accordion] Propriétés
>
> **action** `string` *required*
>
> La recommandation ; de nouvelles valeurs peuvent être ajoutées, gérez donc les actions inconnues de manière appropriée
>
> Options disponibles : `theme_business`, `create_product`, `create_plan`, `verify_identity`, `connect_affiliate_program`, `create_promotion`, `migrate_from_stripe`, `accept_first_payment`, `launch_first_ad`, `launch_draft_campaign`, `increase_ad_budget`, `refresh_ad_creatives`, `fix_ad_billing`, `exclude_customers_from_ads`, `retarget_abandoned_checkouts`, `fix_funnel_dropoff`, `invite_team_member`, `enable_tax_collection`, `create_card`, `apply_for_financing`
>
> **blocked\_capabilities** `string[]` *required*
>
> Fonctionnalités que cela débloquerait, ou vide
>
> **cta** `string` *required*
>
> L'URL vers laquelle pointe l'appel à l'action
>
> **cta\_label** `string` *required*
>
> Libellé du bouton
>
> **description** `string` *required*
>
> Texte d'accompagnement, ou vide
>
> **icon\_url** `string | null` *required*
>
> URL de l'icône d'illustration, ou `null`
>
> **impact\_score** `integer | null` *required*
>
> Impact estimé de 0 à 100, ou `null` lorsqu'il n'est pas classé
>
> **reasoning** `string | null` *required*
>
> Raison pour laquelle cette action a été recommandée, ou `null`
>
> **status** `string` *required*
>
> Toujours facultatif — jamais bloquant
>
> Options disponibles : `optional`
>
> **title** `string` *required*
>
> Titre de la recommandation

**require\_2fa** `boolean` *required*

Indique si les utilisateurs autorisés doivent activer l'authentification à deux facteurs.

**required\_actions** `object[] | null` *required*

Actions que le propriétaire du compte doit effectuer pour débloquer des fonctionnalités comme les versements et les dépenses par carte, triées par priorité d'affichage. Calculé uniquement sur `retrieve` et `me` pour les appelants disposant de la portée `company:balance:read` ; `null` sinon.

> [accordion] Propriétés
>
> **action** `string` *required*
>
> Ce que le titulaire doit faire ; de nouvelles valeurs peuvent être ajoutées, gérez donc les actions inconnues de manière appropriée
>
> Options disponibles : `deposit_funds`, `review_held_payments`, `submit_information_request`, `update_automatic_withdrawal_method`, `reauthorize_payout_methods`, `update_payout_method`, `update_payout_profile`, `card_usage_review`, `verify_identity`, `scale_account_setup`, `sign_formation_documents`, `configure_tax_remitter`, `add_vat_registration`, `confirm_tax_details`, `accept_payout_terms`, `enable_two_factor_authentication`, `respond_to_abuse_report`
>
> **blocked\_capabilities** `string[]` *required*
>
> Fonctionnalités bloquées jusqu'à la résolution de ce point
>
> **cta** `string | null` *required*
>
> L'URL vers laquelle pointe l'appel à l'action, ou null lorsqu'il n'y a pas de bouton
>
> **cta\_label** `string` *required*
>
> Libellé du bouton, ou vide lorsqu'il n'y a pas de bouton
>
> **description** `string` *required*
>
> Texte d'accompagnement, ou vide
>
> **icon\_url** `string | null` *required*
>
> L'URL de l'icône d'illustration de l'action, ou null si elle n'en a pas
>
> **status** `string` *required*
>
> required (à traiter maintenant) ou pending (en cours d'examen)
>
> Options disponibles : `required`, `pending`
>
> **title** `string` *required*
>
> Titre de l'action

**return\_policy** `object | null` *required*

Le document de politique de retour du compte, ou `null` s'il n'en a pas publié.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'ID du fichier, préfixé par `file_`.
>
> **blurhash** `string | null` *required*
>
> Espace réservé BlurHash pour une image ou une vidéo. Null lorsqu'il est indisponible ou supprimé par la modération.
>
> **content\_type** `string | null` *required*
>
> Le type MIME du fichier d'origine, par exemple `application/pdf`. Il est conservé lorsque la modération supprime le fichier.
>
> **created\_at** `string` *required*
>
> Date de création du fichier, sous forme d'horodatage ISO 8601.
>
> **duration\_seconds** `number | null` *required*
>
> Durée de l'audio ou de la vidéo en secondes. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **filename** `string | null` *required*
>
> Le nom du fichier d'origine, extension comprise.
>
> **height** `integer | null` *required*
>
> Hauteur de l'image ou de la vidéo en pixels. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **multipart\_chunk\_size** `integer | null`
>
> La taille en octets que doit avoir chaque partie (sauf la dernière). Présent uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> **multipart\_upload\_id** `string | null`
>
> L'ID du téléversement en plusieurs parties, à renvoyer à `complete`. Présent uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> **multipart\_upload\_urls** `object[] | null`
>
> L'URL présignée de chaque partie. Présente uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> > [accordion] Propriétés
> >
> > **part\_number** `integer` *required*
> >
> > L'index (à partir de 1) de cette partie dans le téléversement en plusieurs parties.
> >
> > **url** `string` *required*
> >
> > L'URL présignée vers laquelle envoyer (PUT) les octets de cette partie.
>
> **object** `string` *required*
>
> Le type de cet objet, toujours `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Indique si la modération a supprimé le fichier. Lorsque `true`, `url` sert une image de remplacement. `filename`, `size` et `content_type` décrivent toujours le fichier d'origine.
>
> **size** `integer | null` *required*
>
> La taille du fichier en octets. `null` tant que le téléversement n'est pas terminé.
>
> **upload\_headers** `object`
>
> En-têtes à envoyer avec le PUT de téléversement. Présents uniquement à la création.
>
> **upload\_status** `string` *required*
>
> L'étape du cycle de vie de téléversement où se trouve le fichier.
>
> Options disponibles : `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> URL présignée vers laquelle envoyer (PUT) les octets du fichier. Présente uniquement à la création, et uniquement pour les téléversements en une seule partie.
>
> **url** `string | null` *required*
>
> Une URL pour télécharger le fichier. Les fichiers publics obtiennent une URL CDN permanente, et les fichiers privés une URL signée qui expire. `null` tant que le téléversement n'est pas terminé. Lorsque la modération supprime le fichier, une URL d'image de remplacement.
>
> **visibility** `string` *required*
>
> Les fichiers `public` sont servis depuis une URL CDN non signée. Les fichiers `private` sont servis depuis une URL signée qui expire.
>
> Options disponibles : `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL de la forme d'onde audio. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **width** `integer | null` *required*
>
> Largeur de l'image ou de la vidéo en pixels. Null lorsqu'elle est indisponible ou supprimée par la modération.

**rewards** `object[]`

Récompenses professionnelles associées via le lien de parrainage actif de ce compte, avec la progression propre au compte et le statut du registre. Présent sur les réponses de retrieve ; vide sans accès en lecture à la fois au solde et aux statistiques.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID de la définition de récompense, préfixé par `prwd_`. La progression et le statut s'appliquent au compte qui la contient.
>
> **qualification\_amount** `object` *required*
>
> Volume éligible en USD requis pour obtenir cette récompense.
>
> > [accordion] Propriétés
> >
> > **amount** `string` *required*
> >
> > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> >
> > **currency** `string` *required*
> >
> > Code de devise ISO 4217 à trois lettres, en minuscules.
> >
> > **decimals** `integer` *required*
> >
> > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> >
> > **display\_decimals** `integer` *required*
> >
> > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
>
> **qualification\_progress** `object` *required*
>
> Volume éligible en USD pour l'activité de la récompense, cumulé par ce compte depuis l'attribution, calculé selon les règles d'exécution.
>
> > [accordion] Propriétés
> >
> > **amount** `string` *required*
> >
> > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> >
> > **currency** `string` *required*
> >
> > Code de devise ISO 4217 à trois lettres, en minuscules.
> >
> > **decimals** `integer` *required*
> >
> > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> >
> > **display\_decimals** `integer` *required*
> >
> > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
>
> **qualification\_type** `string` *required*
>
> Activité qui rend ce compte éligible à la récompense.
>
> Options disponibles : `sales`, `ad_spend`
>
> **reward\_amount** `object` *required*
>
> Montant en USD crédité pour cette récompense. Utilise le montant d'attribution enregistré une fois l'exécution commencée.
>
> > [accordion] Propriétés
> >
> > **amount** `string` *required*
> >
> > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> >
> > **currency** `string` *required*
> >
> > Code de devise ISO 4217 à trois lettres, en minuscules.
> >
> > **decimals** `integer` *required*
> >
> > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> >
> > **display\_decimals** `integer` *required*
> >
> > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
>
> **status** `string` *required*
>
> L'état de la récompense de ce compte. Credited nécessite une écriture comptabilisée dans le registre ; processing inclut une condition remplie en attente d'exécution. Reversing et reversed reflètent une annulation ultérieure de la récompense.
>
> Options disponibles : `in_progress`, `processing`, `credited`, `reversing`, `reversed`, `unavailable`

**route** `string` *required*

Identifiant de route public du compte.

**send\_customer\_emails** `boolean` *required*

Indique si Whop envoie des e-mails transactionnels aux clients au nom de ce compte.

**shipping\_policy** `object | null` *required*

Le document de politique d'expédition du compte, ou `null` s'il n'en a pas publié.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'ID du fichier, préfixé par `file_`.
>
> **blurhash** `string | null` *required*
>
> Espace réservé BlurHash pour une image ou une vidéo. Null lorsqu'il est indisponible ou supprimé par la modération.
>
> **content\_type** `string | null` *required*
>
> Le type MIME du fichier d'origine, par exemple `application/pdf`. Il est conservé lorsque la modération supprime le fichier.
>
> **created\_at** `string` *required*
>
> Date de création du fichier, sous forme d'horodatage ISO 8601.
>
> **duration\_seconds** `number | null` *required*
>
> Durée de l'audio ou de la vidéo en secondes. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **filename** `string | null` *required*
>
> Le nom du fichier d'origine, extension comprise.
>
> **height** `integer | null` *required*
>
> Hauteur de l'image ou de la vidéo en pixels. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **multipart\_chunk\_size** `integer | null`
>
> La taille en octets que doit avoir chaque partie (sauf la dernière). Présent uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> **multipart\_upload\_id** `string | null`
>
> L'ID du téléversement en plusieurs parties, à renvoyer à `complete`. Présent uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> **multipart\_upload\_urls** `object[] | null`
>
> L'URL présignée de chaque partie. Présente uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> > [accordion] Propriétés
> >
> > **part\_number** `integer` *required*
> >
> > L'index (à partir de 1) de cette partie dans le téléversement en plusieurs parties.
> >
> > **url** `string` *required*
> >
> > L'URL présignée vers laquelle envoyer (PUT) les octets de cette partie.
>
> **object** `string` *required*
>
> Le type de cet objet, toujours `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Indique si la modération a supprimé le fichier. Lorsque `true`, `url` sert une image de remplacement. `filename`, `size` et `content_type` décrivent toujours le fichier d'origine.
>
> **size** `integer | null` *required*
>
> La taille du fichier en octets. `null` tant que le téléversement n'est pas terminé.
>
> **upload\_headers** `object`
>
> En-têtes à envoyer avec le PUT de téléversement. Présents uniquement à la création.
>
> **upload\_status** `string` *required*
>
> L'étape du cycle de vie de téléversement où se trouve le fichier.
>
> Options disponibles : `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> URL présignée vers laquelle envoyer (PUT) les octets du fichier. Présente uniquement à la création, et uniquement pour les téléversements en une seule partie.
>
> **url** `string | null` *required*
>
> Une URL pour télécharger le fichier. Les fichiers publics obtiennent une URL CDN permanente, et les fichiers privés une URL signée qui expire. `null` tant que le téléversement n'est pas terminé. Lorsque la modération supprime le fichier, une URL d'image de remplacement.
>
> **visibility** `string` *required*
>
> Les fichiers `public` sont servis depuis une URL CDN non signée. Les fichiers `private` sont servis depuis une URL signée qui expire.
>
> Options disponibles : `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL de la forme d'onde audio. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **width** `integer | null` *required*
>
> Largeur de l'image ou de la vidéo en pixels. Null lorsqu'elle est indisponible ou supprimée par la modération.

**show\_joined\_whops** `boolean` *required*

Indique si le compte apparaît dans les whops rejoints sur d'autres comptes.

**show\_reviews\_dtc** `boolean` *required*

Indique si les avis sont affichés sur les pages produit en vente directe aux consommateurs.

**show\_user\_directory** `boolean` *required*

Indique si le compte affiche les utilisateurs dans l'annuaire des utilisateurs.

**social\_links** `object[]` *required*

Liens sociaux du compte.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'ID du lien social
>
> **title** `string | null` *required*
>
> Le titre d'affichage facultatif du lien social
>
> **url** `string` *required*
>
> L'URL du lien social
>
> **website** `string` *required*
>
> La plateforme sociale de ce lien
>
> Options disponibles : `x`, `instagram`, `facebook`, `tiktok`, `youtube`, `linkedin`, `twitch`, `website`, `custom`

**status** `string | null` *required*

Indique si le compte peut opérer sur Whop : `active` ou `suspended`. Calculé sur `list`, `retrieve`, `me` et `suspend` ; `null` sinon.

**status\_reason** `string | null` *required*

Raison de la suspension du compte, sous forme de libellé tel que `Suspended - Fraudulent activity`. `Suspended` lorsqu'aucune raison n'est enregistrée. Calculé sur `retrieve`, `me` et `suspend`. `null` sinon, ou lorsque `status` n'est pas `suspended`.

**store\_page\_config** `object` *required*

Configuration d'affichage de la page boutique du compte.

> [accordion] Propriétés
>
> **accent\_color** `string | null` *required*
>
> Couleur d'accent utilisée sur la page boutique du compte.
>
> Options disponibles : `ruby`, `tomato`, `red`, `crimson`, `pink`, `plum`, `purple`, `violet`, `iris`, `cyan`, `teal`, `jade`, `green`, `grass`, `brown`, `blue`, `orange`, `indigo`, `sky`, `mint`, `yellow`, `amber`, `lime`, `lemon`, `magenta`, `gold`, `bronze`, `gray`
>
> **layout** `string | null` *required*
>
> Mise en page utilisée sur la page boutique du compte.
>
> Options disponibles : `featured`, `compact`
>
> **profile\_variant** `string | null` *required*
>
> Présentation du profil utilisée sur la page boutique du compte.
>
> Options disponibles : `personal`, `business`
>
> **whop\_affiliate\_link** `boolean` *required*
>
> Indique si la page boutique du compte affiche un lien d'affiliation Whop.

**target\_audience** `string | null` *required*

Public cible de ce compte.

**tax\_collection\_enabled\_states** `string[]` *required*

Codes des États américains (parmi les 50 États plus `DC`) où le compte collecte les taxes : l'ensemble complet lorsque Whop reverse les taxes (`tax_remitted_by` `whop`), le sous-ensemble configuré lorsque le compte les reverse lui-même (`self`), et vide dans les autres cas. Lors d'une mise à jour, envoyez la liste complète pour la remplacer (autorisé uniquement avec `self`).

**tax\_identifiers** `object[]` *required*

Immatriculations fiscales/TVA du compte. Vide lorsqu'aucune n'est définie.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID de l'identifiant fiscal.
>
> **tax\_id\_type** `string` *required*
>
> Type d'identifiant fiscal.
>
> Options disponibles : `ad_nrt`, `ao_tin`, `ar_cuit`, `al_tin`, `am_tin`, `aw_tin`, `au_abn`, `au_arn`, `eu_vat`, `az_tin`, `bs_tin`, `bh_vat`, `bd_bin`, `bb_tin`, `by_tin`, `bj_ifu`, `bo_tin`, `ba_tin`, `br_cnpj`, `br_cpf`, `bg_uic`, `bf_ifu`, `kh_tin`, `cm_niu`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `cv_nif`, `cl_tin`, `cn_tin`, `co_nit`, `cd_nif`, `cr_tin`, `hr_oib`, `do_rcn`, `ec_ruc`, `eg_tin`, `sv_nit`, `et_tin`, `eu_oss_vat`, `ge_vat`, `gh_tin`, `de_stn`, `gb_vat`, `gn_nif`, `hk_br`, `hu_tin`, `is_vat`, `in_gst`, `id_npwp`, `il_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `kz_bin`, `ke_pin`, `kg_tin`, `la_tin`, `li_uid`, `li_vat`, `my_frp`, `my_itn`, `my_sst`, `mr_nif`, `mx_rfc`, `md_vat`, `me_pib`, `ma_vat`, `np_pan`, `nz_gst`, `ng_tin`, `mk_vat`, `no_vat`, `no_voec`, `om_vat`, `pe_ruc`, `ph_tin`, `pl_nip`, `ro_tin`, `ru_inn`, `ru_kpp`, `sa_vat`, `sn_ninea`, `rs_pib`, `sg_gst`, `sg_uen`, `si_tin`, `za_vat`, `kr_brn`, `es_cif`, `ch_uid`, `ch_vat`, `tw_vat`, `tj_tin`, `tz_vat`, `th_vat`, `tr_tin`, `ug_tin`, `ua_vat`, `ae_trn`, `us_ein`, `uy_ruc`, `uz_tin`, `uz_vat`, `ve_rif`, `vn_tin`, `zm_tin`, `zw_tin`, `sr_fin`, `xi_vat`
>
> **tax\_id\_value** `string` *required*
>
> Valeur de l'identifiant fiscal, par exemple `DE123456789`. Consultez le [guide des identifiants fiscaux](https://docs.whop.com/fr/developer/guides/tax-ids.md).

**tax\_remitted\_by** `string | null` *required*

Qui calcule et reverse les taxes pour le compte. `whop` signifie que Whop calcule et reverse. `self` signifie que Whop calcule, et que le compte collecte et reverse. `none` signifie ni l'un ni l'autre, et le compte en est responsable. Les nouvelles entreprises commencent avec `whop`, et les nouveaux comptes connectés avec `none`. `null` signifie que le compte n'a encore aucun paramètre.

Options disponibles : `whop`, `self`, `none`

**tax\_type** `string | null` *required*

Comment les taxes sont appliquées aux prix du compte : `inclusive` (taxes incluses dans le prix affiché) ou `exclusive` (taxes ajoutées en sus). Vaut `exclusive` par défaut lorsqu'il n'est pas défini ; `null` uniquement lorsque le compte n'a aucune connexion de paiement.

Options disponibles : `inclusive`, `exclusive`

**terms\_of\_service** `object | null` *required*

Le document de conditions d'utilisation du compte, ou `null` s'il n'en a pas publié.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'ID du fichier, préfixé par `file_`.
>
> **blurhash** `string | null` *required*
>
> Espace réservé BlurHash pour une image ou une vidéo. Null lorsqu'il est indisponible ou supprimé par la modération.
>
> **content\_type** `string | null` *required*
>
> Le type MIME du fichier d'origine, par exemple `application/pdf`. Il est conservé lorsque la modération supprime le fichier.
>
> **created\_at** `string` *required*
>
> Date de création du fichier, sous forme d'horodatage ISO 8601.
>
> **duration\_seconds** `number | null` *required*
>
> Durée de l'audio ou de la vidéo en secondes. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **filename** `string | null` *required*
>
> Le nom du fichier d'origine, extension comprise.
>
> **height** `integer | null` *required*
>
> Hauteur de l'image ou de la vidéo en pixels. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **multipart\_chunk\_size** `integer | null`
>
> La taille en octets que doit avoir chaque partie (sauf la dernière). Présent uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> **multipart\_upload\_id** `string | null`
>
> L'ID du téléversement en plusieurs parties, à renvoyer à `complete`. Présent uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> **multipart\_upload\_urls** `object[] | null`
>
> L'URL présignée de chaque partie. Présente uniquement à la création, et uniquement pour les téléversements en plusieurs parties.
>
> > [accordion] Propriétés
> >
> > **part\_number** `integer` *required*
> >
> > L'index (à partir de 1) de cette partie dans le téléversement en plusieurs parties.
> >
> > **url** `string` *required*
> >
> > L'URL présignée vers laquelle envoyer (PUT) les octets de cette partie.
>
> **object** `string` *required*
>
> Le type de cet objet, toujours `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Indique si la modération a supprimé le fichier. Lorsque `true`, `url` sert une image de remplacement. `filename`, `size` et `content_type` décrivent toujours le fichier d'origine.
>
> **size** `integer | null` *required*
>
> La taille du fichier en octets. `null` tant que le téléversement n'est pas terminé.
>
> **upload\_headers** `object`
>
> En-têtes à envoyer avec le PUT de téléversement. Présents uniquement à la création.
>
> **upload\_status** `string` *required*
>
> L'étape du cycle de vie de téléversement où se trouve le fichier.
>
> Options disponibles : `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> URL présignée vers laquelle envoyer (PUT) les octets du fichier. Présente uniquement à la création, et uniquement pour les téléversements en une seule partie.
>
> **url** `string | null` *required*
>
> Une URL pour télécharger le fichier. Les fichiers publics obtiennent une URL CDN permanente, et les fichiers privés une URL signée qui expire. `null` tant que le téléversement n'est pas terminé. Lorsque la modération supprime le fichier, une URL d'image de remplacement.
>
> **visibility** `string` *required*
>
> Les fichiers `public` sont servis depuis une URL CDN non signée. Les fichiers `private` sont servis depuis une URL signée qui expire.
>
> Options disponibles : `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL de la forme d'onde audio. Null lorsqu'elle est indisponible ou supprimée par la modération.
>
> **width** `integer | null` *required*
>
> Largeur de l'image ou de la vidéo en pixels. Null lorsqu'elle est indisponible ou supprimée par la modération.

**three\_ds\_level** `string | null` *required*

Comportement 3D Secure pour les paiements par carte en session pris en charge. `mandate_challenge` exige un challenge 3DS avant le traitement du paiement ; `mandate_if_required` impose un challenge uniquement lorsque le processeur de paiement l'exige ; `frictionless_if_required` utilise le flux 3DS sans friction habituel. Les paiements de 1 000 \$ ou plus utilisent `mandate_if_required` sauf si `mandate_challenge` est sélectionné. Les exigences de risque et de reprise d'authentification peuvent prévaloir sur cette préférence. `null` utilise le flux de checkout standard.

Options disponibles : `mandate_challenge`, `mandate_if_required`, `frictionless_if_required`

**title** `string` *required*

Nom d'affichage du compte.

**total\_earned\_usd** `number | null` *required*

Ventes du compte sur toute sa durée de vie, normalisées en USD. Calculé uniquement sur `retrieve` et `me` pour les appelants disposant de la portée `stats:read` ; `null` sinon.

**total\_usd** `string | null` *required*

Valeur totale en USD de l'ensemble des soldes dont le taux de change est connu. Calculé uniquement sur les lectures d'un seul compte (`retrieve` et `me`) ; `null` sur les réponses de liste, les écritures, en l'absence d'autorisation de lecture du solde, ou lorsque la source du solde est indisponible.

**trading** `trading_account | null` *required*

L'adresse du compte de trading, un instantané de sa marge et de ses positions ouvertes, ainsi que ses abonnements WebSocket. Activez-le avec `include_trading=true` sur les lectures d'un seul compte. `null` sinon, sans autorisation de trading, ou sans portefeuille Ethereum.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'ID du portefeuille Whop associé à ce compte de trading, préfixé par `cwal_`.
>
> **account\_id** `string | null` *required*
>
> Le compte qui possède ce compte de trading, préfixé par `biz_`. `null` lorsqu'il appartient à un utilisateur.
>
> **hyperliquid** `object | null` *required*
>
> État propre à Hyperliquid. Présent lorsque `provider` vaut `hyperliquid`, `null` sinon.
>
> > [accordion] Propriétés
> >
> > **address** `string` *required*
> >
> > Adresse de portefeuille en minuscules qui détient le compte Hyperliquid.
> >
> > **depositable** `string | null` *required*
> >
> > USDT0 dans le portefeuille Whop sur Plasma qu'une transaction `deposit` peut transférer vers ce compte, sous forme de chaîne décimale. `null` lorsque la chaîne n'a pas pu être lue.
> >
> > **margin\_summary** `object | null` *required*
> >
> > Valeur du compte et marge sur la plateforme d'échange principale et les marchés `xyz`, lues depuis Hyperliquid au plus une fois par seconde. `null` lorsque Hyperliquid n'a pas pu être lu. Utilisez `websocket_subscriptions` pour les mises à jour en direct.
> >
> > > [accordion] Propriétés
> > >
> > > **account\_value** `object` *required*
> > >
> > > Valeur totale du compte en USD, y compris les profits et pertes latents.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **total\_margin\_used** `object` *required*
> > >
> > > Marge allouée aux positions ouvertes, en USD.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **total\_position\_notional** `object` *required*
> > >
> > > Valeur notionnelle cumulée des positions ouvertes, en USD.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **withdrawable** `object` *required*
> > >
> > > Montant en USD pouvant être retiré immédiatement sans clôturer de positions.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> >
> > **positions** `trading_position[] | null` *required*
> >
> > Positions perpétuelles ouvertes sur la plateforme d'échange principale et les marchés `xyz`, lues depuis Hyperliquid au plus une fois par seconde. `null` lorsque Hyperliquid n'a pas pu être lu. Utilisez `websocket_subscriptions` pour les mises à jour en direct.
> >
> > > [accordion] Propriétés
> > >
> > > **id** `string` *required*
> > >
> > > ID de la position de trading, préfixé par `trdpos_`. Stable pour un marché au sein d'un même compte de trading.
> > >
> > > **entry\_price** `object | null` *required*
> > >
> > > Prix d'entrée moyen en USD, ou `null` lorsque le fournisseur l'omet.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **hyperliquid** `object | null` *required*
> > >
> > > Détails des contrats perpétuels Hyperliquid. Présent sur les positions Hyperliquid, `null` sinon.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **cumulative\_funding** `object` *required*
> > > >
> > > > Frais de financement payés sur la position sur plusieurs périodes, en USD.
> > > >
> > > > > [accordion] Propriétés
> > > > >
> > > > > **all\_time** `object | null` *required*
> > > > >
> > > > > Frais de financement payés sur ce marché sur tout l'historique du compte, en USD, ou `null` lorsqu'ils sont indisponibles.
> > > > >
> > > > > > [accordion] Propriétés
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > > > >
> > > > > **since\_change** `object | null` *required*
> > > > >
> > > > > Frais de financement payés depuis la dernière modification de la taille de la position, en USD, ou `null` lorsqu'ils sont indisponibles.
> > > > >
> > > > > > [accordion] Propriétés
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > > > >
> > > > > **since\_open** `object | null` *required*
> > > > >
> > > > > Frais de financement payés depuis l'ouverture de la position, en USD, ou `null` lorsqu'ils sont indisponibles.
> > > > >
> > > > > > [accordion] Propriétés
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > > >
> > > > **leverage** `object` *required*
> > > >
> > > > Mode de marge et multiplicateur de la position.
> > > >
> > > > > [accordion] Propriétés
> > > > >
> > > > > **type** `string` *required*
> > > > >
> > > > > `cross` partage la marge entre les positions. `isolated` limite la marge à cette position.
> > > > >
> > > > > Options disponibles : `cross`, `isolated`
> > > > >
> > > > > **value** `integer` *required*
> > > > >
> > > > > Multiplicateur appliqué à la marge de la position, comme `10` pour 10x.
> > > >
> > > > **liquidation\_price** `object | null` *required*
> > > >
> > > > Prix de liquidation estimé en USD, ou `null` lorsque Hyperliquid n'en indique aucun.
> > > >
> > > > > [accordion] Propriétés
> > > > >
> > > > > **amount** `string` *required*
> > > > >
> > > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> > > > >
> > > > > **currency** `string` *required*
> > > > >
> > > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > > >
> > > > > **decimals** `integer` *required*
> > > > >
> > > > > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> > > > >
> > > > > **display\_decimals** `integer` *required*
> > > > >
> > > > > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > > >
> > > > **margin\_used** `object` *required*
> > > >
> > > > Marge allouée à la position, en USD.
> > > >
> > > > > [accordion] Propriétés
> > > > >
> > > > > **amount** `string` *required*
> > > > >
> > > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> > > > >
> > > > > **currency** `string` *required*
> > > > >
> > > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > > >
> > > > > **decimals** `integer` *required*
> > > > >
> > > > > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> > > > >
> > > > > **display\_decimals** `integer` *required*
> > > > >
> > > > > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > > >
> > > > **return\_on\_equity** `string` *required*
> > > >
> > > > Rendement des capitaux propres sous forme de chaîne de ratio décimal, comme `0.1` pour 10 %.
> > >
> > > **market** `string` *required*
> > >
> > > Symbole du marché chez le fournisseur, comme `ETH`.
> > >
> > > **object** `string` *required*
> > >
> > > **position\_value** `object` *required*
> > >
> > > Valeur actuelle de la position en USD.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **side** `string` *required*
> > >
> > > Options disponibles : `long`, `short`
> > >
> > > **size** `string` *required*
> > >
> > > Taille absolue de la position sous forme de chaîne décimale.
> > >
> > > **unrealized\_pnl** `object` *required*
> > >
> > > Profit ou perte latent en USD. Négatif en cas de perte.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> >
> > **websocket\_subscriptions** `object[]` *required*
> >
> > Abonnements pour les mises à jour du compte en direct. Envoyez chaque `message` tel quel après vous être connecté à `websocket_url`.
> >
> > > [accordion] Propriétés
> > >
> > > **channel** `string` *required*
> > >
> > > Le flux de mises à jour en direct que cet abonnement ouvre.
> > >
> > > Options disponibles : `clearinghouse_state`, `open_orders`, `order_updates`, `user_fills`, `user_events`
> > >
> > > **message** `string` *required*
> > >
> > > Message d'abonnement JSON à envoyer tel quel via le WebSocket Hyperliquid.
> >
> > **websocket\_url** `string` *required*
> >
> > URL WebSocket Hyperliquid à laquelle se connecter directement pour les mises à jour en direct.
>
> **object** `string` *required*
>
> **provider** `string` *required*
>
> Plateforme de trading qui détient les positions et les ordres.
>
> Options disponibles : `hyperliquid`
>
> **spot** `object | null` *required*
>
> Avoirs spot dans le portefeuille Whop avec leur prix d'entrée et leurs profits et pertes. `null` lorsqu'ils n'ont pas pu être lus.
>
> > [accordion] Propriétés
> >
> > **holdings** `object[]` *required*
> >
> > Chaque actif spot encore détenu par le portefeuille, avec son prix d'entrée moyen et ses profits et pertes. Le prix de revient considère les unités les plus anciennes comme vendues en premier et inclut les actifs arrivés depuis l'extérieur de Whop.
> >
> > > [accordion] Propriétés
> > >
> > > **average\_entry\_price** `object | null` *required*
> > >
> > > Le prix moyen payé par unité encore détenue, en USD, en considérant les unités les plus anciennes comme vendues en premier. `null` lorsqu'il n'est pas connu.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **cost\_basis** `object` *required*
> > >
> > > Le montant payé en USD pour les unités encore détenues.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **market** `string` *required*
> > >
> > > L'`id` du marché spot issu de `GET /trades/markets`, comme `BTC`, `XAUT`, ou le ticker d'une action tokenisée comme `AAPL`.
> > >
> > > **realized\_pnl** `object` *required*
> > >
> > > Gains et pertes déjà réalisés par des ventes, en USD.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **unrealized\_pnl** `object` *required*
> > >
> > > La valeur des unités encore détenues moins leur `cost_basis`, en USD.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **unrealized\_pnl\_percentage** `number | null` *required*
> > >
> > > `unrealized_pnl` en pourcentage de `cost_basis`, où `2` signifie une hausse de 2 %. `null` lorsqu'il n'est pas connu.
>
> **user\_id** `string | null` *required*
>
> L'utilisateur qui possède ce compte de trading, préfixé par `user_`. `null` lorsqu'il appartient à un compte.

**use\_logo\_as\_opengraph\_image\_fallback** `boolean` *required*

Indique si le compte utilise son logo comme image Open Graph de secours.

**verification** `object` *required*

Statut de vérification d'identité du compte pour les profils `individual` (KYC) et `business` (KYB). Chacun vaut `null` jusqu'à sa création, puis un `status` parmi `not_started`, `pending`, `manual_review`, `approved` ou `rejected`.

**volume\_l30d\_usd** `number | null` *required*

Volume traité par le compte au cours des 30 derniers jours (GMV issu des reçus payés), normalisé en USD. Calculé uniquement sur `list` pour les appelants disposant de `stats:read` sur le compte ; `null` sinon.

**volume\_usd** `number | null` *required*

Volume traité par le compte sur toute sa durée de vie — ventes plus transferts reçus — normalisé en USD. Calculé uniquement sur `list` pour les appelants disposant de `stats:read` sur le compte ; `null` sinon.

**wallet** `object | null` *required*

Portefeuille crypto principal du compte, ou `null` si aucun n'a été provisionné.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du portefeuille, préfixé par `wallet_`.
>
> **address** `string` *required*
>
> L'adresse on-chain du portefeuille
>
> **network** `string` *required*
>
> Le réseau blockchain sur lequel se trouve le portefeuille
>
> Options disponibles : `solana`, `ethereum`, `bitcoin`

**website** `string | null` *required*

L'URL du site web professionnel du compte, ou `null` si aucune n'a été fournie. La définir ajoute également une entrée `website` à `social_links`.

**whop\_partner\_enabled\_at** `string | null`

Date à laquelle le compte a activé le mode Whop Partner, sous forme d'horodatage ISO 8601. Présent sur les lectures d'un seul compte et les réponses de mise à jour ; `null` jusqu'à ce que le compte active le mode Whop Partner en envoyant `whop_partner_enabled: true` lors d'une mise à jour.

```json Account theme={null}
{
	"id": "biz_xxxxxxxxxxxxx",
	"trading": {
		"id": "cwal_xxxxxxxxxxxxx",
		"object": "trading_account",
		"account_id": "biz_xxxxxxxxxxxxx",
		"user_id": null,
		"provider": "hyperliquid",
		"hyperliquid": {
			"address": "0x1234567890abcdef1234567890abcdef12345678",
			"websocket_url": "wss://api.hyperliquid.xyz/ws",
			"websocket_subscriptions": [
				{
					"channel": "clearinghouse_state",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"clearinghouseState\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "open_orders",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"openOrders\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "order_updates",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"orderUpdates\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "user_fills",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"userFills\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "user_events",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"userEvents\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				}
			],
			"depositable": "1250.50",
			"margin_summary": {
				"account_value": {
					"currency": "usd",
					"amount": "1520.50",
					"decimals": 2,
					"display_decimals": 2
				},
				"total_position_notional": {
					"currency": "usd",
					"amount": "4350.00",
					"decimals": 2,
					"display_decimals": 2
				},
				"total_margin_used": {
					"currency": "usd",
					"amount": "435.00",
					"decimals": 2,
					"display_decimals": 2
				},
				"withdrawable": {
					"currency": "usd",
					"amount": "500.00",
					"decimals": 2,
					"display_decimals": 2
				}
			},
			"positions": [
				{
					"id": "trdpos_0123456789abcdef",
					"object": "trading_position",
					"market": "ETH",
					"side": "short",
					"size": "1.5",
					"entry_price": {
						"currency": "usd",
						"amount": "3000.00",
						"decimals": 2,
						"display_decimals": 2
					},
					"position_value": {
						"currency": "usd",
						"amount": "4350.00",
						"decimals": 2,
						"display_decimals": 2
					},
					"unrealized_pnl": {
						"currency": "usd",
						"amount": "150.25",
						"decimals": 2,
						"display_decimals": 2
					},
					"hyperliquid": {
						"leverage": {
							"type": "cross",
							"value": 10
						},
						"liquidation_price": {
							"currency": "usd",
							"amount": "4912.40",
							"decimals": 2,
							"display_decimals": 2
						},
						"margin_used": {
							"currency": "usd",
							"amount": "435.00",
							"decimals": 2,
							"display_decimals": 2
						},
						"return_on_equity": "0.33",
						"cumulative_funding": {
							"all_time": {
								"currency": "usd",
								"amount": "1.20",
								"decimals": 2,
								"display_decimals": 2
							},
							"since_open": {
								"currency": "usd",
								"amount": "0.40",
								"decimals": 2,
								"display_decimals": 2
							},
							"since_change": {
								"currency": "usd",
								"amount": "0.10",
								"decimals": 2,
								"display_decimals": 2
							}
						}
					}
				}
			]
		},
		"spot": {
			"holdings": [
				{
					"market": "BTC",
					"average_entry_price": {
						"currency": "usd",
						"amount": "79841.12345678",
						"decimals": 8,
						"display_decimals": 8
					},
					"cost_basis": {
						"currency": "usd",
						"amount": "400.00",
						"decimals": 2,
						"display_decimals": 2
					},
					"unrealized_pnl": {
						"currency": "usd",
						"amount": "38.25",
						"decimals": 2,
						"display_decimals": 2
					},
					"unrealized_pnl_percentage": 9.5625,
					"realized_pnl": {
						"currency": "usd",
						"amount": "3.25",
						"decimals": 2,
						"display_decimals": 2
					}
				}
			]
		}
	},
	"balances": [
		{
			"balance": "1250.5",
			"breakdown": {
				"available": "1200.50",
				"in_transit": "0",
				"pending": "50.00",
				"reserve": "0",
				"pending_settlements": [
					{
						"amount": "50.00",
						"date": "2026-08-01"
					}
				],
				"finishing_settlement": "0"
			},
			"icon_url": "https://cdn.whop.com/tokens/usdt.png",
			"name": "Tether USD",
			"price_usd": 1,
			"symbol": "USDT",
			"value_usd": "1250.50"
		},
		{
			"balance": "45.00",
			"breakdown": {
				"available": "40.00",
				"in_transit": "0",
				"pending": "5.00",
				"reserve": "0",
				"pending_settlements": [
					{
						"amount": "3.00",
						"date": "2026-08-01"
					},
					{
						"amount": "2.00",
						"date": "2026-08-04"
					}
				],
				"finishing_settlement": "0"
			},
			"icon_url": null,
			"name": "EUR",
			"price_usd": 1.11,
			"symbol": "EUR",
			"value_usd": "50.00"
		}
	],
	"platform_credits": [
		{
			"amount": "25.00",
			"currency": "usd",
			"decimals": 2,
			"display_decimals": 2
		}
	],
	"banner_image_url": "https://cdn.whop.com/banner.png",
	"business_type": "ecommerce",
	"can_transfer_pending_balance_to_children": false,
	"cancellation_policy": null,
	"country": "US",
	"created_at": "2026-06-01T12:00:00Z",
	"description": "Petal Post delivers fresh bouquets.",
	"economic_intelligence": false,
	"email": "hello@petalpost.example",
	"eula": null,
	"external_id": null,
	"home_preferences": ["hide_member_count"],
	"industry_type": "flower_delivery_gig",
	"invoice_prefix": "PETAL",
	"company_formation": {
		"status": "filed",
		"legal_name": "Petal Post, LLC",
		"state_registered": true,
		"ein_registered": false,
		"signatures": {
			"ss4": {
				"status": "pending",
				"url": "https://esign.doola.com/session/sess_1a2b3c",
				"expires_at": "2026-08-01T00:00:00Z"
			}
		},
		"documents": [
			{
				"id": "file_petalpost123",
				"name": "Articles of Organization",
				"type": "articles_of_organization",
				"url": "https://img.whop.com/documents/articles-of-organization.pdf"
			}
		]
	},
	"logo_url": "https://cdn.whop.com/logo.png",
	"metadata": {
		"external_merchant_id": "merchant_123"
	},
	"onboarding_type": "seller",
	"opengraph_image_url": "https://cdn.whop.com/og.png",
	"opengraph_image_variant": "black",
	"other_business_description": "Local flower delivery",
	"other_industry_description": "Same-day floral gifts",
	"owner": {
		"id": "user_xxxxxxxxxxxx",
		"username": "petalpost",
		"name": "Ada Flores",
		"profile_picture": {
			"url": "https://cdn.whop.com/user.png"
		}
	},
	"parent_account": {
		"id": "biz_platform123",
		"title": "Petal Platform",
		"route": "petal-platform",
		"logo_url": "https://cdn.whop.com/petal-platform-logo.png"
	},
	"privacy_policy": null,
	"require_2fa": true,
	"dispute_fighter_enabled": false,
	"orchestration_enabled": true,
	"collect_vat_id": false,
	"capabilities": {
		"accept_card_payments": "active",
		"accept_bank_payments": "active",
		"accept_bnpl_payments": "inactive",
		"standard_payout": "inactive",
		"instant_payout": "inactive",
		"crypto_payout": "inactive",
		"transfer": "inactive",
		"bank_deposit": "active",
		"crypto_deposit": "active",
		"card_deposit": "active",
		"card_issuing": "inactive",
		"run_ads": "active"
	},
	"payment_controls": {
		"dispute_alert_auto_refund": {
			"threshold_usd": 250,
			"locked": false
		},
		"resolution_center_auto_refund": {
			"card_threshold_usd": null,
			"financing_threshold_usd": null,
			"paypal_threshold_usd": null,
			"locked": false
		},
		"dispute_alert_fee_usd": 29,
		"high_risk_processing_fee_percentage": 0,
		"pending_auto_topup_fee_percentage": 2,
		"pending_balance_delay_days": 0,
		"financing_disabled": false,
		"enforce_3ds": false,
		"restricted_payment_methods": [],
		"payment_method_warnings": [],
		"reserve": {
			"percentage": null,
			"hold_period_days": 90
		},
		"withdrawal_schedule": {
			"frequency": "monthly",
			"day": 1,
			"next_payout_date": "2026-09-01"
		},
		"undated_pending_reason": null
	},
	"cards": {
		"kind": "business",
		"status": "approved",
		"decline_reason": null
	},
	"financing": null,
	"required_actions": [
		{
			"action": "verify_identity",
			"status": "required",
			"title": "Identity verification required",
			"description": "Complete verification before your total earnings exceed $5k to continue accepting payments.",
			"cta_label": "Verify now",
			"cta": "https://whop.com/dashboard/biz_xxxxxxxxxxxxx/balance/?verify=true",
			"icon_url": null,
			"blocked_capabilities": [
				"accept_card_payments",
				"accept_bank_payments",
				"standard_payout",
				"instant_payout",
				"crypto_payout",
				"transfer",
				"bank_deposit",
				"card_issuing"
			]
		}
	],
	"recommended_actions": [
		{
			"action": "migrate_from_stripe",
			"status": "optional",
			"title": "Migrate your business from Stripe.",
			"description": "",
			"cta_label": "Get started",
			"cta": "https://whop.com/dashboard/biz_xxxxxxxxxxxxx/settings/stripe-migrations/",
			"icon_url": "https://whop.com/illustrations/orange/crane.svg",
			"blocked_capabilities": [],
			"reasoning": null,
			"impact_score": null
		},
		{
			"action": "accept_first_payment",
			"status": "optional",
			"title": "Accept your first payment.",
			"description": "",
			"cta_label": "Create payment link",
			"cta": "https://whop.com/dashboard/biz_xxxxxxxxxxxxx/links/checkout/create/",
			"icon_url": "https://whop.com/illustrations/orange/card.svg",
			"blocked_capabilities": [],
			"reasoning": null,
			"impact_score": null
		},
		{
			"action": "apply_for_financing",
			"status": "optional",
			"title": "Offer financing at checkout",
			"description": "Let customers pay over time with buy now, pay later.",
			"cta_label": "Apply",
			"cta": "https://whop.com/dashboard/biz_xxxxxxxxxxxxx/settings/payments/",
			"icon_url": "https://whop.com/illustrations/orange/piggy-bank.svg",
			"blocked_capabilities": ["accept_bnpl_payments"],
			"reasoning": null,
			"impact_score": null
		}
	],
	"return_policy": null,
	"route": "petal-post",
	"shipping_policy": null,
	"website": "https://petalpost.example",
	"send_customer_emails": true,
	"payment_method_configuration": {
		"enabled": ["klarna"],
		"disabled": ["crypto"],
		"include_platform_defaults": true
	},
	"show_joined_whops": false,
	"show_reviews_dtc": true,
	"show_user_directory": false,
	"status": "active",
	"status_reason": null,
	"funds_release_at": null,
	"terms_of_service": null,
	"three_ds_level": "mandate_challenge",
	"total_earned_usd": 3450,
	"ads_spend_usd": 180.25,
	"volume_usd": 4250.5,
	"volume_l30d_usd": 1200,
	"customers_l30d": 24,
	"level": {
		"current": 1,
		"points": 41000,
		"points_by_source": {
			"cards": 40000,
			"ads": 0,
			"trading": 1000,
			"partners": 0
		},
		"resets_at": "2026-11-01T04:00:00.000Z",
		"account_level": 0
	},
	"social_links": [
		{
			"id": "social_petalpost123",
			"title": "Petal Post",
			"url": "https://petalpost.example",
			"website": "website"
		}
	],
	"store_page_config": {
		"accent_color": "red",
		"layout": "compact",
		"profile_variant": "business",
		"whop_affiliate_link": true
	},
	"target_audience": "Customers sending flowers locally",
	"tax_collection_enabled_states": ["CA", "NY"],
	"tax_remitted_by": "whop",
	"tax_type": "exclusive",
	"product_tax_code": {
		"id": "ptc_CzLNn2Z058xEC1",
		"name": "Digital Group Chat",
		"product_type": "digital"
	},
	"business_address": {
		"line1": "123 Garden Way",
		"line2": null,
		"city": "Austin",
		"state": "TX",
		"postal_code": "78701",
		"country": "US"
	},
	"business_name": "Petal Post, LLC",
	"tax_identifiers": [
		{
			"id": "taxid_petalpost123",
			"tax_id_type": "us_ein",
			"tax_id_value": "12-3456789"
		}
	],
	"title": "Petal Post",
	"total_usd": "1300.50",
	"use_logo_as_opengraph_image_fallback": true,
	"verification": {
		"business": null,
		"individual": {
			"status": "approved"
		}
	},
	"wallet": {
		"id": "wallet_petalpost123",
		"address": "So11111111111111111111111111111111111111112",
		"network": "solana"
	}
}
```

## Types d'entreprises et secteurs

Trois champs classent les comptes : `business_type`, `industry_group` et `industry_type`. La taxonomie complète se trouve sur sa propre page :

> [card] [Types d'entreprises et secteurs](https://docs.whop.com/fr/api-reference/accounts/business-types.md)


## Related topics

- [API Social Accounts (obsolète)](https://docs.whop.com/fr/api-reference/social-accounts/social-account.md)
- [List Accounts](https://docs.whop.com/fr/api-reference/accounts/list-accounts.md)
- [Update Account](https://docs.whop.com/fr/api-reference/accounts/update-account.md)
