# Adhésions

L'API Memberships permet aux tenants d'inscrire des utilisateurs à un programme lié à une annonce de type `membership`.

Chaque adhésion suit l'inscription de l'utilisateur à une annonce (avec un `membership_id` externe propre au tenant), les contributions de paiement associées aux commandes Tradly et l'historique des prix utilisé pour calculer les unités créditées.

## ID de membre externe

`membership_id` est la référence de membre ou de programme fournie par le tenant (par exemple `GOLD-2026-00123`). Ce n'est ni l'`id` de la base de données ni le `user_id` Tradly. Utilisez-le pour faire le lien avec votre CRM ou système de gestion. Il doit être unique pour un tenant et une annonce d'adhésion et peut compter jusqu'à 128 caractères.

## Fonctionnement

1. Créez une annonce de type `membership` avec l'API Listings.
2. Inscrivez l'utilisateur via `POST /v1/memberships`.
3. Lorsqu'il paie par le processus de paiement Tradly, la contribution est enregistrée à la confirmation de commande.
4. Vous pouvez enregistrer l'historique des prix avec `POST /v1/memberships/price_logs` pour suivre les unités créditées.

## Statut initial

| Valeur | Description |
|---|---|
| `active` | Adhésion active (valeur par défaut) |
| `expired` | La date `end_date` est dépassée |
| `cancelled` | Adhésion annulée manuellement |

Omettez `status` à la création pour démarrer l'adhésion en état `active`. Le point de terminaison stocke le statut fourni ; il ne fait pas évoluer automatiquement l'expiration ou l'annulation. Votre application doit gérer ces changements.

## Authentification

Authentifiez-vous avec `Authorization: Bearer <token>`. L'identité du tenant et de l'utilisateur provient du jeton ou de la passerelle. N'envoyez pas d'en-têtes `tenant_id`, `user_id`, `admin` ou `X-Auth-Key`. Les utilisateurs non administrateurs peuvent consulter et créer leurs propres adhésions ; les administrateurs peuvent les gérer pour tout utilisateur.