Transactions
Vue d'ensemble
Otonum conserve un historique complet et paginé de tous les événements de fidélité pour chaque membre : achats, gains de récompenses, échanges et ajustements de solde. L'historique des transactions est en lecture seule depuis l'API. Toutes les entrées sont générées automatiquement par Otonum au fil des événements.
Historique
Pour récupérer l'historique des transactions d'un membre, consultez la Référence API pour les paramètres exacts et les exemples à jour.
| Paramètre | Valeurs | Défaut |
|---|---|---|
Page | Entier ≥ 1 | 1 |
Size | Entier | 10 |
OrderBy | ASC, DESC | ASC |
L'historique est utile pour :
- Portails membres : afficher une chronologie de l'historique points/cashback
- Rapprochement : auditer l'émission de récompenses par rapport à vos propres enregistrements de commandes
- Support : diagnostiquer des récompenses manquantes ou des soldes contestés
La profondeur de l'historique disponible dépend de votre tier d'abonnement. Le tier Starter conserve 30 jours d'historique.
Annulation & dette de points
Si une transaction est annulée après que des points ou du cashback ont déjà été crédités au solde du membre, Otonum crée un ajustement négatif (PointAdjustment) pour récupérer les récompenses.
Le solde du membre peut temporairement devenir négatif suite à un ajustement d'annulation. C'est un comportement attendu, pas une erreur. Votre intégration doit gérer les soldes négatifs correctement lors de l'affichage.
Pour annuler une transaction, appelez l'endpoint d'annulation avec la reference original.
Points importants
- Les achats annulés ne réactivent pas les bons précédemment consommés.
- La
referenced'une transaction annulée est libéré. Vous pouvez réutiliser le même identifiant de commande si la commande est soumise à nouveau comme nouvelle transaction. - Les ajustements apparaissent dans l'historique des transactions comme des lignes séparées.
Voir aussi
- Enregistrer des activités : comment les activités sont soumises
- Bon d'achat : échange et cycle de vie des bons
- Bonnes pratiques : idempotence et déduplication