Codes promo

Créez et gérez des codes de réduction.

Permissions : discounts.read, discounts.write (inclut la lecture). Guide : Codes promo.

Lister les codes

GET /discounts — discounts.read

Paramètre	Description
per_page, cursor	Pagination.
status	active ou inactive.

cURL

curl "https://api.pulse-sell.com/v1/discounts?status=active" \
  -H "Authorization: Bearer $PULSESELL_API_KEY"

Obtenir un code

GET /discounts/{id} — discounts.read

Créer un code

POST /discounts — discounts.write — 201

Champ	Requis	Description
name	oui	Nom interne (120 caractères).
code	oui	3 à 32 caractères A-Z, 0-9, _, - (mis en majuscules).
type	oui	percentage ou fixed.
value	oui	Nombre supérieur à 0 ; un pourcentage ne dépasse pas 100.
max_uses	non	Entier ≥ 1, ou null pour illimité.
starts_at, ends_at	non	ISO 8601 ; ends_at suit starts_at.
status	non	active ou inactive.

cURL

curl -X POST https://api.pulse-sell.com/v1/discounts \
  -H "Authorization: Bearer $PULSESELL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: promo-lance20" \
  -d '{"name": "Lancement", "code": "LANCE20", "type": "percentage", "value": 20, "max_uses": 100}'

Modifier un code

PATCH /discounts/{id} — discounts.write

Mêmes champs que la création, tous optionnels.

Supprimer un code

DELETE /discounts/{id} — discounts.write — 204

Refusé (409) si le code a déjà servi : désactivez-le avec PATCH et {"status": "inactive"} pour conserver l’historique.