Suivre une Vente

Endpoint

POST https://track.taap.it/api/events/sale

Authentification

Côté serveur (Recommandé)
Côté client

Utilisez votre clé API secrète :

Authorization: Bearer taapit_sk_xxxxxxxxxxxx

Utilisez votre clé publique :

X-Publishable-Key: taapit_pk_xxxxxxxxxxxx

Corps de la requête

Champ	Type	Requis	Description
`trackingId`	string	✓	Le `ta_tid` du cookie ou paramètre URL
`customer`	object	✓	Informations client
`customer.externalId`	string	✓	Votre ID utilisateur/client interne
`customer.email`	string		Adresse email du client
`customer.firstname`	string		Prénom du client
`customer.lastname`	string		Nom du client
`customer.phoneNumber`	string		Numéro de téléphone du client
`customer.avatarUrl`	string		URL de l’avatar du client
`amount`	number	✓	Montant en unités de devise (pas en centimes)
`currency`	string	✓	Code devise ISO 4217 (ex: `eur`, `usd`)
`metadata`	object		Données personnalisées (paires clé-valeur)

Format du montant : Utilisez les unités de devise, pas les centimes.

✅ 29.99 pour 29,99 €
❌ 2999 serait interprété comme 2999 €

Exemples

cURL
SDK Node.js
Hook React
JavaScript

curl -X POST https://track.taap.it/api/events/sale \
  -H "Authorization: Bearer taapit_sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "trackingId": "rLnWe1uz9t282v7g",
    "customer": {
      "externalId": "user_123",
      "email": "[email protected]"
    },
    "amount": 99.99,
    "currency": "eur",
    "metadata": {
      "orderId": "order_456",
      "plan": "pro"
    }
  }'

import { Taapit } from 'taapit-sdk';

const taapit = new Taapit({
  apiKey: process.env.TAAPIT_API_KEY,
});

await taapit.track.sale({
  trackingId: 'rLnWe1uz9t282v7g',
  customer: {
    externalId: 'user_123',
    email: '[email protected]',
  },
  amount: 99.99,
  currency: 'eur',
  metadata: {
    orderId: 'order_456',
    plan: 'pro',
  },
});

import { useTaapitAnalytics } from 'taapit-sdk/react';

function CheckoutButton({ order }) {
  const { trackSale } = useTaapitAnalytics();

  const handlePurchase = async () => {
    trackSale({
      customer: {
        externalId: order.userId,
        email: order.email,
      },
      amount: order.total,
      currency: 'eur',
      metadata: {
        orderId: order.id,
        plan: order.plan,
      },
    });
  };
}

<script src="https://taap.it/api/sdk" data-publishable-key="taapit_pk_xxx"></script>

<script>
  taapit.trackSale({
    customer: {
      externalId: 'user_123',
      email: '[email protected]',
    },
    amount: 99.99,
    currency: 'eur',
    metadata: {
      orderId: 'order_456',
    },
  });
</script>

Réponse

200 OK
400 Bad Request
401 Unauthorized
404 Not Found

{
  "ok": true
}

{
  "error": "Invalid payload",
  "details": [
    {
      "path": ["amount"],
      "message": "Required"
    }
  ]
}

{
  "error": "Invalid API key"
}

{
  "error": "Click not found for this trackingId"
}

Codes de devise

Utilisez les codes ISO 4217 standard :

Devise	Code
Euro	`eur`
Dollar US	`usd`
Livre Sterling	`gbp`
Yen Japonais	`jpy`
Franc Suisse	`chf`
Dollar Canadien	`cad`
Dollar Australien	`aud`

Codes d’erreur

Code HTTP	Erreur	Description
400	`Invalid payload`	Validation du corps de requête échouée
400	`Missing customer.externalId`	Champ requis non fourni
401	`Invalid API key`	Clé API invalide ou révoquée
401	`Hostname not in allowed list`	Origine non autorisée (côté client)
403	`This click does not belong to your workspace`	trackingId appartient à un autre workspace
404	`Click not found for this trackingId`	trackingId n’existe pas ou a expiré

Commencer

Conversions

Référence API

Endpoint

Authentification

Corps de la requête

Exemples

Réponse

Codes de devise

Codes d’erreur

Commencer

Conversions

Référence API

​Endpoint

​Authentification

​Corps de la requête

​Exemples

​Réponse

​Codes de devise

​Codes d’erreur

Endpoint

Authentification

Corps de la requête

Exemples

Réponse

Codes de devise

Codes d’erreur