Lire le programme de fidélité du compte
/v1/loyalty-program
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êteRetry-Afterindique combien de secondes attendre.
Une question ? contact@wanapos.com
