Aller au contenu principal

Mettre à jour le wallet

PATCH

https://api-v2.test.eldowallet.fr/wallets

Met à jour le wallet du jeton utilisé : nom, coordonnées, réseaux sociaux, logos, fuseau horaire, webhooks ou conditions générales. Seuls les champs envoyés sont modifiés ; accepte multipart/form-data (pour les images) ou application/json.

À retenir
  • Corps en multipart/form-data : les objets imbriqués (colors, security, locations…) s'envoient en chaîne JSON, les booléens en "true"/"false". Images : PNG ou JPEG, 1 Ko à 5 Mo.
  • termsAndConditions.customUrl est obligatoire si type vaut URL.
  • Toute modification effective met à jour les passes installés en arrière-plan : les cartes de fidélité à chaque fois, les autres types de passes quand un champ qu'ils affichent change (nom, logos, téléphones…). Les porteurs de carte de fidélité sont notifiés selon la règle UPDATE_LOYALTY, ce qui consomme des crédits ; le crédit est vérifié avant toute écriture (INSUFFICIENT_CREDIT, ou 409 INSUFFICIENT_CREDIT_PARTIAL, à lever avec acceptPartialDelivery: true). Une requête sans changement ne déclenche rien.

Requête​

header parameters
  • x-lang string
    Langue des messages d'erreur et des textes renvoyés : `fr` ou `en`.
    enum: en, frdefault: "en"
Body multipart/form-data required
  • webHookUrl string
    URL de webhook, séparées par des virgules. Authentification facultative par URL, via le fragment : `https://host/hook#headers=Authorization:Bearer%20token`.
  • icon string <binary>
  • logo string <binary>
  • androidLogo string <binary>
  • name string
  • identifier string
  • identifierQr string
  • address string
  • website string
  • servicePhone string
  • businessPhone string
  • socialMedia object
    • linkedin string
    • tiktok string
    • twitter string
    • facebook string
    • instagram string
    • youtube string
    • snapchat string
    • pinterest string
    • reddit string
    • whatsapp string
    • telegram string
  • additionalContacts object[]
    • title string required
    • value string required
    • kind string requiredenum: URL, PHONE, EMAIL
  • termsAndConditions object
    • type string
      Type de conditions générales.
      enum: PDF, URL, NONEexample: PDF
    • customUrl string <uri>
      URL personnalisée des conditions générales (correspond à `generalRoleUrl`).
      example: https://example.com/terms
    • pdfFile string <binary>
  • rootDomain string
  • timezone string
  • allowedPasses string[]enum: ALL, EVENT_TICKET, TRANSIT, CINEMA, BOARDING_PASS, COUPON, GENERIC, STORE_CARD, OFFER, HOTEL
  • expiredCleanupEnabled boolean
Body application/json required
  • webHookUrl string
    URL de webhook, séparées par des virgules. Authentification facultative par URL, via le fragment : `https://host/hook#headers=Authorization:Bearer%20token`.
  • icon string <binary>
  • logo string <binary>
  • androidLogo string <binary>
  • name string
  • identifier string
  • identifierQr string
  • address string
  • website string
  • servicePhone string
  • businessPhone string
  • socialMedia object
    • linkedin string
    • tiktok string
    • twitter string
    • facebook string
    • instagram string
    • youtube string
    • snapchat string
    • pinterest string
    • reddit string
    • whatsapp string
    • telegram string
  • additionalContacts object[]
    • title string required
    • value string required
    • kind string requiredenum: URL, PHONE, EMAIL
  • termsAndConditions object
    • type string
      Type de conditions générales.
      enum: PDF, URL, NONEexample: PDF
    • customUrl string <uri>
      URL personnalisée des conditions générales (correspond à `generalRoleUrl`).
      example: https://example.com/terms
    • pdfFile string <binary>
  • rootDomain string
  • timezone string
  • allowedPasses string[]enum: ALL, EVENT_TICKET, TRANSIT, CINEMA, BOARDING_PASS, COUPON, GENERIC, STORE_CARD, OFFER, HOTEL
  • expiredCleanupEnabled boolean

Réponses​

Schéma application/json
  • name string required
  • logo string required
  • icon string required
  • androidLogo string
  • displayIdentifiant boolean required
  • passBuilderPassTemplateId string
  • passBuilderBusinessId string
  • passBuilderToken string
  • identifier string required
  • identifierQr string required
  • address string
  • website string required
  • servicePhone string required
  • businessPhone string required
  • socialMedia object required
    • linkedin string
    • facebook string
    • instagram string
    • tiktok string
    • twitter string
    • youtube string
    • snapchat string
    • pinterest string
    • reddit string
    • whatsapp string
    • telegram string
  • additionalContacts object[] required
    • title string required
    • value string required
    • kind string requiredenum: URL, PHONE, EMAIL
  • termsAndConditions object required
    • type string requiredenum: PDF, URL, NONE
    • customUrl string
    • pdfUrl string
  • webHookUrl string required
  • rootDomain string required
  • timezone string
  • allowedPasses string[] requiredenum: ALL, EVENT_TICKET, TRANSIT, CINEMA, BOARDING_PASS, COUPON, GENERIC, STORE_CARD, OFFER, HOTEL
  • expiredCleanupEnabled boolean required
  • _id string required
  • createdAt string <date-time> required
  • updatedAt string <date-time> required

Les nouveautés de l'API, une fois par mois

Nouveaux endpoints, changements à prévoir, guides et cas d'usage. Pas de spam, désinscription en un clic.

Signaler un problème technique

Une erreur de l’API, un pass qui ne se met pas à jour, un e-mail qui n’arrive pas ? Décrivez le problème : notre équipe technique vous répond.

Pour une réponse rapide, indiquez :

  • La méthode et l’endpoint (ex. POST /clients)
  • Le code d’erreur renvoyé (errorCode) et le corps envoyé
  • La date et l’heure de l’appel
  • Les identifiants concernés (client, modèle, pass)

N’y mettez jamais de jeton d’API ni de mot de passe.

Assistant IA

Beta

Chargement…

Réponses générées par IA (Claude) : vérifiez les points importants.

Connectez-vous pour utiliser l'assistant