Mises à jour Wallet

Surveillez et annulez les opérations de mise à jour push par lots depuis la console d’administration.

Mises à jour du Wallet

Le Mises à jour du Wallet page dans la console d’administration vous permet de suivre l’avancement de chaque opération de mise à jour par lots et d’annuler celles qui sont encore en cours.

Ouvrez-la depuis Paramètres → Surveillance → mises à jour Wallet.

Lecture du tableau

Chaque ligne représente une opération de mise à jour push par lots — un ensemble de tâches de mise à jour par Carte déclenchées par un seul appel API ou événement système.

Colonne	Ce qu’elle affiche
Début	Quand le lot a été accepté par la plateforme.
Dernière activité	Quand la tâche par Carte la plus récente du lot a été traitée.
Opération	Le type d’opération interne qui a généré le lot.
Corrélation	Le correlationId fourni dans l’opération de mise à jour push, ou une valeur générée automatiquement.
Cartes	Nombre total de Cartes dans le lot.
Terminées	Nombre de Cartes qui ont été traitées (succès ou échec).
Erreurs	Nombre de Cartes ayant échoué lors du traitement.
Apple	Nombre de Cartes Apple Wallet dans le lot.
Google	Nombre de Cartes Google Wallet dans le lot.
Statut	État global du lot — par exemple, Terminées ou En cours.

Suivi d’un lot spécifique avec correlationId

Si vous fournissez un correlationId via l’opération de mise à jour push, cette valeur apparaît dans la Corrélation colonne. Utilisez-la pour localiser et surveiller rapidement le lot que vous avez déclenché.

Push update for passes matching the filter.

post

https://app.neostore.cloudhttps://app-qa.neostore.cloud

/api/{tenantId}/passes/pushUpdate

Authorization: Requires Pass.Write scope.

Filtering: Same as GetPasses�identifiers, metadata, pass type, installation status.

Async: Updates are queued. 200 response means scheduled, not complete. Monitor via statistics endpoint.

Data Merge: Merged into each matching pass. Set UpdateMetadata=true for recomputation (slower). Adjust Throughput for concurrency.

Bulk Operations: Ideal for campaigns, loyalty updates, seasonal offers. Use CorrelationId for tracking.

Use Cases: Campaign push; loyalty tier changes; offer refresh; bulk metadata updates.

Example — push a seasonal offer to all loyalty passes:

POST /api/{tenantId}/passes/pushUpdate
    ?filter[0].field=passType&filter[0].operator=equals&filter[0].value=loyalty
            
{
  "additionalData": { "offer": "summer2025", "discount": "20%" },
  "options": {
    "updateMetadata": true,
    "throughput": 12,
    "correlationId": "campaign-summer-2025"
  }
}

Scopes requis

Cet endpoint nécessite les scopes suivants :

Autorisations

admin-bearerapiKey

OAuth2implicitRequis

Authorization URL:

Paramètres de chemin

tenantIdstringRequis

Paramètres de requête

Corps

application/jsontext/jsonapplication/*+json

additionalDataobject · nullableOptionnel

Arbitrary data to persist with the pass (for example, loyalty tier, store code, or campaign flags).

passTypestring · nullableOptionnel

Optional pass type to convert the pass to.

updateMetadatabooleanOptionnelObsolète

Specifies if passes metadata should be updated. Updating metadata is time consuming and could be avoided for notification only push update

Default: false

Réponses

200

Passes scheduled for update; returns the count in the response body.

text/plainapplication/jsontext/json

Result returned after scheduling a bulk push update operation.

passCountinteger · int32Optionnel

Count of passes scheduled for update.

post/api/{tenantId}/passes/pushUpdate

HTTPcURLJavaScriptPython

POST /api/{tenantId}/passes/pushUpdate HTTP/1.1
Host: app.neostore.cloud
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 158

{
  "identifiers": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "additionalData": null,
  "passType": null,
  "options": {
    "throughput": 1,
    "updateMetadata": true,
    "correlationId": null
  }
}

application/jsontext/jsonapplication/*+json

200

Passes scheduled for update; returns the count in the response body.

{
  "passCount": 1
}

Si vous ne fournissez pas de correlationId, la plateforme en génère un automatiquement. Vous pouvez le récupérer dans la réponse de l’API.

Il n’existe pas de webhook de fin au niveau du lot. Interrogez la page Mises à jour du Wallet ou vérifiez l’historique de chaque Carte si vous avez besoin d’une confirmation en temps réel.

Annulation d’une opération en cours

Sélectionnez un lot avec En cours le statut et utilisez l’action d’annulation pour arrêter le traitement ultérieur. Les Cartes déjà traitées avant l’annulation ne sont pas rétablies.

Noms des opérations

Le Opération la colonne affiche le nom interne du composant qui a créé le lot. Ces noms reflètent l’architecture interne de la plateforme et ne sont pas utiles au quotidien. Concentrez-vous sur la Corrélation colonne pour identifier les lots qui vous appartiennent.