Le pass ne se met pas à jour
Vous avez modifié une donnée. L’appel API a répondu en succès. Mais le client voit toujours l’ancienne valeur. Suivez ces vérifications dans l’ordre.
Toujours bloqué ? Contactez le support en précisant l’identifiant du client et l’heure de l’appel.
1. L’appel a-t-il vraiment réussi ?
Regardez le code HTTP et le corps de la réponse.
NOTHING_TO_UPDATE(204) : les valeurs envoyées sont identiques aux valeurs actuelles. Rien ne part.- Erreur
INVALID_MULTIPARTouUNSUPPORTED_MEDIA_TYPE: mauvais Content-Type. Voir Erreurs API fréquentes. - Opération en masse : la réponse immédiate dit seulement que l’opération est acceptée. Vérifiez son résultat avec GET
/bulk-operations/{operationId}.
2. Le pass est-il installé ?
Un pass envoyé mais jamais ajouté au Wallet ne reçoit aucune mise à jour : il n’existe pas encore sur le téléphone.
Vérifiez le statut du client avec GET/clients/{id} ou GET/clients, ou écoutez le webhook pass.installed. S’il n’a pas installé, relancez-le avec POST/clients/reminder-inactive.
Le client a peut-être supprimé le pass (webhook pass.uninstalled). Il doit le rajouter depuis son lien.
3. Avez-vous modifié le bon objet ?
| Vous voulez changer… | Le bon appel |
|---|---|
| Le gain (points, cagnotte) d’un client | PATCH/clients/{id}/gain, ou PATCH/clients/barcode/{barcode}/gain depuis la caisse |
| Le nom, l’email, le type d’un client | PATCH/clients/{id} |
| Le strip ou les infos d’un seul client | PATCH/clients/{id}/specific |
| Le design de la carte de fidélité pour tous | PATCH/store-cards |
| L’horaire d’un trajet | PATCH/transits/{transitId}/passes/trip/{tripNumber} |
| Le billet d’un seul voyageur | PUT/transits/{transitId}/passes/{passId} |
| Un coupon d’un client | PATCH/coupons/{id}/passes/{instanceId} |
| Une réservation d’hôtel | PATCH/hotels/{id}/passes/{passId} |
4. Le pass est-il dans un état final ?
Un pass annulé ou expiré ne se met plus à jour : PASS_ALREADY_CANCELED, PASS_ALREADY_EXPIRED.
5. Côté téléphone
- Pas de réseau : la mise à jour arrive à la prochaine connexion.
- Mises à jour automatiques désactivées : sur iPhone, le client peut couper les mises à jour d’un pass dans ses détails. Il peut aussi tirer vers le bas sur le verso du pass pour forcer un rafraîchissement.
- Délai : la mise à jour passe par les serveurs d’Apple ou de Google. Elle n’est pas toujours instantanée.
6. La valeur a changé, mais pas de notification ?
C’est normal dans certains cas : une mise à jour n’affiche une notification que si le champ modifié est configuré pour notifier, et si la règle de notification correspondante est active (communicationRules, PATCH/wallet-settings). Voir Notifications push.