Fidélité

Lire le programme de fidélité du compte

GET /v1/loyalty-program
vpn_key Toute clé valide Compte comme une lecture

Renvoie les réglages du programme de fidélité : comment un point se gagne, combien il en faut pour déclencher la récompense, et ce qu'elle apporte. Toute clé valide peut l'appeler.

Appelez cette adresse avant de raisonner sur des points : un point n'a pas la même valeur d'un compte à l'autre. Selon type, un point correspond à une unité de monnaie dépensée (ca), à un article acheté (qt) ou à un passage en caisse (pa). Un client atteint la récompense quand son solde (fidelite.points_actuels dans sa fiche) est supérieur ou égal à points_trigger.

Si actif vaut false, le programme est désactivé : les ventes ne rapportent pas de points, mais les soldes existants sont conservés.

Exemple d'appel

curl "https://api.wanapos.com/v1/loyalty-program" \
  -H "Authorization: Bearer VOTRE_CLE"

Réponse en cas de succès (statut 200)

Le programme de fidélité du compte.

Champ Type Description
data objet
data.actif booléen true si le programme de fidélité est activé sur le compte. S'il vaut false, les ventes ne rapportent aucun point.
data.type texte Comment un point se gagne : ca (un point par unité de monnaie dépensée), qt (un point par article acheté) ou pa (un point par passage en caisse).
data.points_trigger entier Nombre de points à atteindre pour déclencher la récompense.
data.reward_type texte Récompense accordée quand le seuil est atteint : pourcentage (une remise en pourcentage sur un ticket) ou disabled (aucune récompense automatique).
data.remise_pc_val entier Pourcentage de la remise accordée, quand reward_type vaut pourcentage.
data.include_reward_ticket booléen true si le ticket qui utilise la récompense rapporte lui aussi des points.
data.promo_compte booléen true si les articles en promotion ou en solde rapportent des points.
data.date_update texte Date du dernier réglage du programme. Chaîne vide si inconnue.
meta objet
meta.request_id texte Identifiant de l'appel, à communiquer à l'assistance en cas de problème.
{
    "data": {
        "actif": true,
        "type": "ca",
        "points_trigger": 500,
        "reward_type": "pourcentage",
        "remise_pc_val": 10,
        "include_reward_ticket": false,
        "promo_compte": false,
        "date_update": "2026-04-02T09:15:00+02:00"
    },
    "meta": {
        "request_id": "3f9a1c0b7d2e4a61"
    }
}

Erreurs possibles

  • 401 Clé absente, inconnue ou révoquée. Codes : missing_key, invalid_key.
  • 403 Appel refusé pour ce compte ou cette clé. Codes : api_not_activated, account_not_eligible, access_blocked, missing_scope.
  • 429 Quota dépassé. Codes : rate_limited, daily_quota_exceeded, too_many_failed_attempts. L'en-tête Retry-After indique combien de secondes attendre.

Voir toutes les erreurs

Une question ? contact@wanapos.com