Récupérer les promotions éligibles d'un client

  • Customers
  • Paiement
  • 1 route
Comment récupérer la liste des offres d'un client ?

Cette route permet de récupérer l'ensemble des promotions auxquelles un client est éligible.

Elle nécessite uniquement l'identifiant d'un client et renvoie, en réponse, toutes les promotions disponibles pour ce client.

Les promotions peuvent appartenir à différentes catégories, notamment:

  • Les avoirs (CREDIT_NOTE)
  • Le parrainage (SPONSORSHIP)
  • Les offres ciblées (TARGETED_OFFER)
  • Les remboursements (REFUND)

Vue d'ensemble

Utilisez ce scénario pour récupérer les promotions ou avantages commerciaux disponibles pour un compte client donné. La réponse peut alimenter un espace client, un cockpit vendeur ou un parcours de devis qui doit connaître les offres éligibles avant le chiffrage.

Prérequis

  • Disposer d'un customer_id valide.
  • Fournir authorization, x-api-key et accept-language si votre contexte d'intégration l'exige.
1

Récupérer les offres commerciales d'un client

Obligatoire

Cette route retourne les offres commerciales disponibles pour un client donné.

Prérequis

Utilisez customer_id avec un jeton d'autorisation valide. Ajoutez date_format si vous avez besoin d'un format de date particulier.

Calling CURL

curl -X GET \
  -H "x-api-key: $API_KEY" \
  -H "accept-language: fr-FR" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  "https://api.clubmed.com/v2/customers/{customer_id}/commercial_offers?date_format=Y-m-d"

Example answer

[
  {
    "id": "offer-1",
    "type": "PROMOTION",
    "offer_id": "PROMO2026",
    "label": "Summer Promo",
    "code": "SUMMER",
    "value": 10,
    "unit": "PERCENT",
    "currency": "EUR",
    "status": "ACTIVE"
  }
]

info: La réponse peut être utilisée pour afficher les promotions éligibles ou préparer une proposition personnalisée.

Codes de réponse

  • 200 OK : les offres commerciales sont renvoyées.
  • 400 Bad Request : paramètres invalides.
  • 401 Unauthorized : jeton manquant ou invalide.
  • 403 Forbidden : le client n'est pas accessible dans ce contexte.
GET/v2/customers/{customer_id}/commercial_offers
Voir plus