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

# Codes promo

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

Permissions : `discounts.read`, `discounts.write` (inclut la lecture). Guide : [Codes promo](https://docs.pulse-sell.com/guides/discounts.md).

## Lister les codes

`GET /discounts` — `discounts.read`

| Paramètre | Description |
| - | - |
| `per_page`, `cursor` | [Pagination](https://docs.pulse-sell.com/concepts/pagination.md). |
| `status` | `active` ou `inactive`. |

```bash cURL theme={null}
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`. |

```bash cURL theme={null}
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.


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