Clients

Un client est une adresse e-mail qui a au moins une vente encaissée dans votre boutique. Il n’y a rien à créer ni à synchroniser : la liste se déduit de vos ventes, donc elle est toujours exacte.

Permission : customers.read. Référence : Clients.

curl "https://api.pulse-sell.com/v1/customers?q=@exemple.com&per_page=50" \
  -H "Authorization: Bearer $PULSESELL_API_KEY"

{
  "id": "cus_YXdhQGV4YW1wbGUuY29t",
  "email": "awa@example.com",
  "name": "Awa Koné",
  "phone": "+2250700000000",
  "orders_count": 3,
  "total_spent": [ { "value": 60000, "formatted": "60 000 F CFA", "currency": "XOF" } ],
  "first_order_at": "2026-08-02T10:00:00.000Z",
  "last_order_at": "2026-10-29T16:17:10.000Z"
}

total_spent est une liste : un client qui a acheté dans plusieurs devises a une ligne par devise, sans conversion approximative.
L’identifiant cus_… est stable et se dérive de l’e-mail : vous pouvez l’utiliser directement dans GET /customers/{id}.
La liste est triée par e-mail ; q recherche dans l’adresse.

Retrouver les achats d’un client

curl "https://api.pulse-sell.com/v1/sales?customer_email=awa@example.com" \
  -H "Authorization: Bearer $PULSESELL_API_KEY"

Respectez la vie privée de vos clients : ne stockez que ce dont vous avez besoin, et ne journalisez pas leurs adresses e-mail en clair.

Démarrer

Fondamentaux

Guides par ressource

Cas d'usage

Retrouver les achats d’un client

​Retrouver les achats d’un client

Retrouver les achats d’un client