Clients

Les acheteurs de votre boutique, dérivés de vos ventes encaissées.

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": "[e-mail]",
  "name": "Awa Koné",
  "phone": "[phone]",
  "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=[e-mail]" \
  -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.