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

# PaymentDetailElement

> Une page de détail de paiement avec la ventilation du tableau de bord, l'activité, le client, les détails et le parcours client. Chaque section peut être masquée. Lit payment:basic:read ; l'e-mail du client nécessite member:email:read et le parcours nécessite member:basic:read. Les événements d'action permettent à votre application de confirmer et d'autoriser les modifications ; cet élément ne rembourse, ne relance ni n'annule jamais un paiement lui-même.

> [!NOTE]
>
> Cette page documente `@whop/elements@1.10.0` et `@whop/elements-react@1.10.0`.

*Depuis `v1.0.0`.*

Se monte à l'intérieur de [`Dashboard`](https://docs.whop.com/fr/elements/latest/dashboard/overview). `accountId` et `accessToken` proviennent de celui-ci. Transmettez les props et les callbacks via les options de création ou les props React. Conservez le handle créé, ou la `ref` React, pour appeler `refresh()`.

```tsx React theme={null}
import { WhopElements, Dashboard, PaymentDetailElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Dashboard /* options */>
        <PaymentDetailElement onRefundRequested={(e) => console.log(e)} onRetryRequested={(e) => console.log(e)} onVoidRequested={(e) => console.log(e)} onInvoiceRequested={(e) => console.log(e)} onCustomerSelected={(e) => console.log(e)} onMessageRequested={(e) => console.log(e)} />
      </Dashboard>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const dashboard = window.WhopElements().dashboard.create({ /* options */ });
  dashboard.create('paymentDetail', {
    onRefundRequested: (e) => console.log(e),
    onRetryRequested: (e) => console.log(e),
    onVoidRequested: (e) => console.log(e),
    onInvoiceRequested: (e) => console.log(e),
    onCustomerSelected: (e) => console.log(e),
    onMessageRequested: (e) => console.log(e)
  }).mount('#dashboard-paymentDetail');
</script>
```

Données d'exemple. [Ouvrir le Playground](https://docs.whop.com/fr/elements/latest/dashboard/overview#playground).

## Props

**showActions** `boolean`

Affiche le bouton Refund en haut à droite et le menu d'actions. Les actions de modification nécessitent des gestionnaires d'événements. Par défaut : `true`.

**paymentId** `string`

Le paiement à afficher, préfixé par pay\_. Requis pour charger un paiement. Par défaut : `""`.

**showBreakdown** `boolean`

Affiche le montant du paiement, les frais et le montant net. Par défaut : `true`.

**showActivity** `boolean`

Affiche la chronologie d'activité du paiement. Par défaut : `true`.

**showCustomer** `boolean`

Affiche le nom, le nom d'utilisateur, l'e-mail, le téléphone et l'adresse de facturation du client lorsque c'est autorisé. Par défaut : `true`.

**showDetails** `boolean`

Affiche le produit, le plan, le moyen de paiement, les métadonnées du paiement et les identifiants du paiement. Par défaut : `true`.

**showJourney** `boolean`

Affiche le parcours client. Lit l'API Events limitée au compte uniquement lorsque la section est visible. Par défaut : `true`.

## Événements

Transmettez les callbacks dans les options de création ou dans les props React.

### `onRefundRequested`

Confirmez et autorisez un remboursement dans votre application. Activé uniquement lorsque le paiement est remboursable et qu'un gestionnaire est fourni.

**payload** `object`

**propriétés**

**paymentId** `string` *required*

### `onRetryRequested`

Confirmez et autorisez une nouvelle tentative de débit dans votre application.

**payload** `object`

**propriétés**

**paymentId** `string` *required*

### `onVoidRequested`

Confirmez et autorisez l'annulation de ce paiement dans votre application.

**payload** `object`

**propriétés**

**paymentId** `string` *required*

### `onInvoiceRequested`

Affichez ou téléchargez la facture dans votre application.

**payload** `object`

**propriétés**

**paymentId** `string` *required*

### `onCustomerSelected`

Ouvre le client dans votre application.

**payload** `object`

**propriétés**

**userId** `string` *required*

**memberId** `string | null` *required*

### `onMessageRequested`

Ouvre votre interface de messagerie client.

**payload** `object`

**propriétés**

**userId** `string` *required*

### `onLoaderStart`

S'exécute après le premier affichage du squelette de chargement et avant `onReady`.

### `onReady`

S'exécute après le premier affichage complet de l'élément.

### `onError`

S'exécute lorsque l'élément ne parvient pas à se charger ou plante. L'affichage de repli reste visible. Utilisez `code` pour une gestion programmatique. `sourceKey` identifie une source d'état hôte en échec.

**e** `object`

**propriétés**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Méthodes

Appelez-les sur le handle renvoyé par `create`, ou via une `ref` React.

### `refresh`

Recharge le paiement et ses frais une fois qu'une action de l'hôte est terminée.

**Renvoie** `Promise<void>`

### `mount`

Monte l'élément dans `target` et démarre le chargement. Les composants React se montent eux-mêmes.

**Paramètres**

**target** `string | HTMLElement` *required*

### `destroy`

Supprime l'élément et libère son frame et ses abonnements. Vous pouvez l'appeler plusieurs fois. React supprime l'élément automatiquement.

### `update`

Fusionne de nouvelles props dans l'élément monté. Avec React, modifiez plutôt les props du composant.

**Paramètres**

**options** `Partial\<PaymentDetailElementProps\>` *required*

## Style

Stylisez ces parties via `appearance.classes`. Utilisez le camel case ou le kebab case pour les noms de propriétés et incluez les unités. Les feuilles de style de la page ne peuvent pas atteindre le frame de l'élément. Le framework valide chaque déclaration avant de l'injecter.

| Classe | Cible |
| - | - |
| `.whop-PaymentDetail` | La page de détail du paiement |

```ts theme={null}
const dashboard = whop.dashboard.create({
  appearance: {
    classes: {
      'whop-PaymentDetail': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

dashboard.update({
  appearance: { classes: { 'whop-PaymentDetail': { fontWeight: '700' } } }
});
```

Avec React, transmettez `appearance` à `<Dashboard>`. Définissez-la globalement avec `WhopElements({ appearance })`.


## Related topics

- [Dashboard](https://docs.whop.com/fr/elements/latest/dashboard/overview.md)
- [PaymentElement](https://docs.whop.com/fr/elements/latest/payments/payment.md)
- [PaymentsTableElement](https://docs.whop.com/fr/elements/latest/dashboard/paymentsTable.md)
