> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taap.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Suivre les revenus depuis Stripe ou une page de paiement personnalisée

> Envoyez vos ventes à Radar en connectant Stripe, ou en envoyant un événement payment depuis votre propre page de paiement, puis vérifiez que chaque vente est attribuée.

Radar relie chaque vente à la visite qui y a mené : vous voyez ainsi quelles sources, quelles pages et quels appareils rapportent de l'argent. Pour cela, Radar doit être informé de vos ventes. Il y a deux façons : connecter Stripe, et envoyer un événement `payment` depuis votre propre page de paiement. Ce guide vous aide à choisir la bonne, donne l'appel exact et montre comment vérifier qu'une vente a été attribuée.

Vous n'êtes pas développeur ? Commencez par les articles du Centre d'aide sur [la connexion de Stripe](https://docs.taap.it/fr/help/radar/features/connect-stripe.md) et [la lecture de vos revenus](https://docs.taap.it/fr/help/radar/features/revenue.md).

## Choisir votre méthode

La réponse dépend de l'endroit où vos clients saisissent les informations de leur carte.

| Où les clients paient | Ce que vous faites |
| - | - |
| Sur la page Stripe Checkout, la page de paiement hébergée par Stripe vers laquelle votre site envoie les acheteurs | Connectez Stripe. Il n'y a aucun événement à envoyer. |
| Sur une page de paiement intégrée à votre propre site | Connectez Stripe, et envoyez aussi un événement `payment` quand une vente aboutit. |

Sur une page de paiement personnalisée, connecter Stripe ne suffit pas.

## Avant de commencer

* **Installez le script Radar** sur votre site, et assurez-vous que vos visites apparaissent. Radar ne peut relier une vente qu'à une visite qu'il a vue. Consultez [vérifier votre installation](https://docs.taap.it/fr/help/radar/check-your-installation.md).
* **Ayez un compte Stripe.** Stripe est le prestataire de paiement auquel Radar se connecte.

## Connecter Stripe

Ouvrez votre projet Radar et suivez les étapes de connexion à Stripe affichées dans le tableau de bord. Veillez à terminer chaque étape.

Une fois la connexion active :

* vos paiements alimentent les chiffres de revenus en haut de la vue d'ensemble, la page Revenus, et le montant dépensé affiché pour chaque acheteur sur la page Personnes ;
* chaque client payant est identifié automatiquement, avec l'e-mail et le nom issus de son paiement. Consultez [identifier les visiteurs](https://docs.taap.it/fr/radar/guides/identify-visitors.md).

Si vos clients paient sur la page Stripe Checkout, vous avez terminé. Passez à [vérifier qu'une vente a été attribuée](#vérifier-qu’une-vente-a-été-attribuée).

## Envoyer un événement payment depuis une page de paiement personnalisée

Quand le paiement a lieu sur une page que vous avez créée, votre code informe Radar de la vente avec `visitors.track`. L'appel prend trois arguments :

```javascript theme={null}
visitors.track(
  "payment",
  {
    email: "jane@example.com",
    first_name: "Jane",
    last_name: "Doe",
    name: "Jane Doe",
  },
  {
    revenue_amount: 49,
    revenue_currency: "USD",
  }
);
```

| Argument | Ce que c'est | Ce qu'il faut y mettre |
| - | - | - |
| 1. Nom de l'événement | Une chaîne de caractères. | `"payment"`, écrit exactement ainsi. |
| 2. Propriétés | Un objet qui décrit l'acheteur et la vente. | `email`, `first_name`, `last_name` et `name`. Vous pouvez ajouter vos propres propriétés, comme un numéro de commande. |
| 3. Revenus | Un objet qui porte l'argent. | `revenue_amount`, le montant de la vente, et `revenue_currency`, le code de sa devise, par exemple `"USD"`. |

Deux détails comptent :

* **Le nom `payment` est exact.** C'est le seul nom d'événement sur lequel Radar copie le nom de l'acheteur vers la page Personnes. L'e-mail, lui, est récupéré sur n'importe quel événement.
* **Le montant et la devise vont dans le troisième argument**, pas parmi les propriétés.

### Quand l'envoyer

Envoyez l'événement une fois le paiement confirmé, pas quand l'acheteur clique sur le bouton de paiement. Sinon, une carte refusée compterait comme une vente.

Envoyez-le une seule fois par vente. Si l'appel se trouve sur une page de confirmation, assurez-vous que recharger la page ne l'envoie pas une seconde fois.

```javascript theme={null}
function onPaymentConfirmed(order) {
  if (typeof visitors === "undefined") return;

  visitors.track(
    "payment",
    {
      email: order.customer.email,
      first_name: order.customer.firstName,
      last_name: order.customer.lastName,
      name: order.customer.fullName,
      order_id: order.id,
    },
    {
      revenue_amount: order.total,
      revenue_currency: order.currency,
    }
  );
}
```

Dans cet exemple, `order` représente vos propres données de commande. La première ligne saute l'appel quand le script Radar n'est pas chargé : un script bloqué ne casse donc jamais votre paiement. Consultez [protéger votre code quand le script est absent](https://docs.taap.it/fr/radar/guides/custom-events.md#protéger-votre-code-quand-le-script-est-absent).

## Vérifier qu'une vente a été attribuée

**1. Faire un achat de test**

Sur votre site publié, arrivez comme le ferait un client, par exemple depuis un lien sur un autre site, puis achetez quelque chose.

**2. Regarder la vue d'ensemble**

Ouvrez votre projet dans Radar. Les chiffres **Revenus** et **Ventes** en haut de la vue d'ensemble doivent inclure votre vente de test. S'ils restent vides, vos paiements ne sont pas encore connectés, ou la vente n'a pas pu être rattachée à une visite.

**3. Ouvrir l'acheteur sur la page Personnes**

Allez dans Personnes et cliquez sur l'acheteur. Son historique montre ses visites, d'où il venait et le montant qu'il a dépensé. Comparez ce montant et sa devise avec votre vente de test.

La page Revenus détaille ensuite vos ventes par source, localisation, appareil, produit et client. La page Revenus détaillée est disponible sur le plan Business. Comparez les plans sur la [page des tarifs](https://taap.it/pricing).

### Vérifier avec l'API

Les mêmes chiffres peuvent être lus depuis vos propres outils. L'endpoint de vue d'ensemble renvoie `revenue`, `revenue_currency` et `sales` pour une plage de dates :

```bash theme={null}
curl -X GET 'https://taap.it/api/v1/radar/overview?start=2026-11-01T00:00:00Z&end=2026-11-30T23:59:59Z' \
  -H 'Authorization: Bearer taapit_your_api_key_here'
```

L'[endpoint des personnes](https://docs.taap.it/fr/api-reference/radar/people.md) renvoie une valeur `revenue` pour chaque personne, et peut trier les personnes par revenus. Consultez l'[endpoint des métriques](https://docs.taap.it/fr/api-reference/radar/metrics.md) pour la réponse complète. L'API Radar est disponible à partir du plan Pro.

## Il manque des ventes

Passez ces points en revue, dans l'ordre.

1. **La connexion Stripe est complète.** Chaque étape affichée dans le tableau de bord est faite.
2. **Vous savez où vos clients paient.** Sur la page Stripe Checkout, la connexion suffit. Sur votre propre page de paiement, l'événement `payment` est aussi nécessaire.
3. **L'événement est nommé exactement `payment`**, et le montant et la devise sont dans le troisième argument.
4. **Votre code atteint l'appel.** Un `return` prématuré, une erreur juste avant ou un objet `visitors` absent le font sauter. La console du navigateur affiche l'erreur.
5. **Le script Radar est sur le site** et vos visites apparaissent. Consultez [j'ai installé le script mais je ne vois aucune donnée](https://docs.taap.it/fr/help/radar/no-data.md).

Toujours rien ? Contactez le support depuis le chat de votre tableau de bord ou à l'adresse [hello@taap.it](mailto:hello@taap.it). Décrivez le parcours d'un acheteur sur votre site, de la première page au paiement : c'est la première chose que l'équipe demande.

## Bon à savoir

* **Pas de webhooks.** Radar ne prévient pas vos systèmes quand une vente est enregistrée. Lisez vos chiffres avec l'[API Radar](https://docs.taap.it/fr/api-reference/radar/introduction.md).
* **Supprimer un projet supprime ses données de revenus.** Supprimer un projet Radar supprime toutes ses données.

> [!NOTE]
>
> Ce guide concerne Radar, l'outil de statistiques de votre site web. Pour suivre les ventes qui viennent de vos liens taap.it, consultez plutôt le [suivi des conversions](https://docs.taap.it/fr/conversions/overview.md).

## Étapes suivantes

> [card] [Identifier les visiteurs](https://docs.taap.it/fr/radar/guides/identify-visitors.md)
>
> Les champs d'identité que Radar lit, et la règle sur les noms.

> [card] [Envoyer des événements personnalisés](https://docs.taap.it/fr/radar/guides/custom-events.md)
>
> Suivez les étapes avant la vente : inscriptions, clics et formulaires.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.