Aller au contenu principal

ClientWithPassInfoResponseDto

walletstring
clientType object
oneOf
storeCard objectobligatoire
oneOf
wallet objectobligatoire
oneOf
namestringobligatoire
logostringobligatoire
iconstringobligatoire
androidLogostring
displayIdentifiantbooleanobligatoire
passBuilderPassTemplateIdstring
passBuilderBusinessIdstring
passBuilderTokenstring
identifierstringobligatoire
identifierQrstringobligatoire
addressstring
websitestringobligatoire
servicePhonestringobligatoire
businessPhonestringobligatoire
socialMedia objectobligatoire
linkedinstring
facebookstring
instagramstring
tiktokstring
twitterstring
youtubestring
snapchatstring
pintereststring
redditstring
whatsappstring
telegramstring
additionalContacts object[]obligatoire
  • Array [
  • titlestringobligatoire
    valuestringobligatoire
    kindstringobligatoire

    Valeurs possibles : [URL, PHONE, EMAIL]

  • ]
  • termsAndConditions objectobligatoire
    typestringobligatoire

    Valeurs possibles : [PDF, URL, NONE]

    customUrlstring
    pdfUrlstring
    webHookUrlstringobligatoire
    rootDomainstringobligatoire
    timezonestring
    allowedPassesstring[]obligatoire

    Valeurs possibles : [ALL, EVENT_TICKET, TRANSIT, CINEMA, BOARDING_PASS, COUPON, GENERIC, STORE_CARD, OFFER, HOTEL]

    expiredCleanupEnabledbooleanobligatoire
    _idstringobligatoire
    createdAtstring<date-time>obligatoire
    updatedAtstring<date-time>obligatoire
    cardTypestringobligatoire

    Valeurs possibles : [STORE_CARD, MEMBER_CARD]

    displayIdentifiantbooleanobligatoire
    displayWalletNameboolean
    stripstringobligatoire
    passBuilderPassTemplateIdstring
    programNamestring
    keysHasChangedstring[]
    startRowstring

    Valeurs possibles : [CREATION_DATE, EXPIRATION_DATE, BIRTHDATE, GAIN, CLUB, ASSOCIATION, ORGANISATION, ENTREPRISE, N_LICENCE, N_ADHERENT, N_MEMBER, MEMBER, N_IMMATRICULATION, INACTIVE, ADMISSION_DATE]

    middleRowstring

    Valeurs possibles : [CREATION_DATE, EXPIRATION_DATE, BIRTHDATE, GAIN, CLUB, ASSOCIATION, ORGANISATION, ENTREPRISE, N_LICENCE, N_ADHERENT, N_MEMBER, MEMBER, N_IMMATRICULATION, INACTIVE, ADMISSION_DATE]

    endRowstring

    Valeurs possibles : [CREATION_DATE, EXPIRATION_DATE, BIRTHDATE, GAIN, CLUB, ASSOCIATION, ORGANISATION, ENTREPRISE, N_LICENCE, N_ADHERENT, N_MEMBER, MEMBER, N_IMMATRICULATION, INACTIVE, ADMISSION_DATE]

    iosHeader object
    labelEnumstringobligatoire

    Valeurs possibles : [TYPE, GAIN, FULLNAME, CUSTOM_TEXT, INACTIVE]

    valueEnumstringobligatoire

    Valeurs possibles : [TYPE, GAIN, FULLNAME, CUSTOM_TEXT, INACTIVE]

    customLabelstring
    customValuestring
    barcodeTypestringobligatoire

    Valeurs possibles : [AZTEC, CODE_128, PDF_417, QR_CODE, NONE]

    descriptions object[]obligatoire
  • Array [
  • titlestringobligatoire
    valuestringobligatoire
  • ]
  • openingHoursstringobligatoire
    colors objectobligatoire
    labelColorstringobligatoire
    backgroundColorstringobligatoire
    foregroundColorstringobligatoire
    oneTimeToUsebooleanobligatoire
    sharingProhibitedbooleanobligatoire
    sharingProhibitedAndroidbooleanobligatoire
    validity objectobligatoire
    expirationTypestringobligatoire

    Valeurs possibles : [NO_EXPIRATION, AT_DATETIME, AFTER_PERIOD]

    expirationDatestring<date-time>
    expirationAfterPeriodstring
    expirationPeriodTypestring

    Valeurs possibles : [YEARS, MONTHS, WEEKS]

    expirationOptionstring

    Valeurs possibles : [AT_CREATION_DATE, END_OF_MONTH]

    gainLabelstringobligatoire

    Valeurs possibles : [GAIN, GAINS, CAGNOTE, POINTS]

    gainUnitstringobligatoire

    Valeurs possibles : [NONE, EURO, USD, MAD, POINTS]

    offerLabelstringobligatoire
    enableDisplayIdentifiantbooleanobligatoire
    gainFormatMigratedbooleanobligatoire

    Indique si le modèle PassBuilder et tous les passes existants ont été migrés vers le nouveau format de gain, où le symbole de l'unité est intégré à la valeur de l'attribut du pass (par exemple « 50 Pts ») plutôt qu'au champ du modèle. false (ou absent) signifie que l'ancien format est toujours utilisé.

    _idstringobligatoire
    createdAtstring<date-time>obligatoire
    updatedAtstring<date-time>obligatoire
    namestringobligatoire
    isDefaultbooleanobligatoire
    _idstringobligatoire
    createdAtstring<date-time>obligatoire
    updatedAtstring<date-time>obligatoire
    passStatusstringnullable

    Statut du pass de carte de fidélité associé.

    Valeurs possibles : [active, inactive, deleted, canceled, expired]

    Exemple : active
    deviceTypesstring

    Liste des types d'appareils distincts, séparés par des virgules.

    Exemple : IOS, ANDROID
    shortLinkstring

    Lien court vers la page d'inscription du pass (par exemple pour un QR code).

    shortIdstring

    Identifiant court du pass, de 4 caractères (utilisé dans les liens courts).

    passBuilderPassIdstring

    Identifiant PassBuilder du pass (utilisé dans les liens courts en l'absence de shortId).

    passIdstring

    Identifiant du pass.

    clientTypeNamestring

    Nom du type de client.

    otherPassStatuses object

    Statut actuel des passes de ce client autres que la carte de fidélité (événement, transport, hôtel), indexé par catégorie de pass. Une catégorie non définie signifie que le client n'a pas encore de pass de ce type. Sert à conditionner les préférences de communication liées à un « nouveau pass » : un client ne peut pas utilement accepter ou refuser les notifications d'un pass qu'il n'a pas encore.

    eventstring

    Valeurs possibles : [active, inactive, deleted, canceled, expired]

    transitstring

    Valeurs possibles : [active, inactive, deleted, canceled, expired]

    hotelstring

    Valeurs possibles : [active, inactive, deleted, canceled, expired]

    sourcestringobligatoire

    Valeurs possibles : [CRM, INTERNAL, EXTERNAL]

    barcodestring
    firstNamestringobligatoire
    lastNamestringobligatoire
    emailstring
    companyNamestring
    renewalDatestring<date-time>
    phoneNumberstring
    birthDatestring<date-time>
    admissionDatestring<date-time>
    gainnumber
    gainHistory object[]
  • Array [
  • gainnumberobligatoire
    datestring<date-time>obligatoire
  • ]
  • communicationPreferences object[]

    Préférences de communication de ce client, par événement et par canal, qui priment sur les règles du wallet (gestion des consentements RGPD). Même structure que WalletSetting.communicationRules. L'absence d'entrée pour un notificationType donné signifie que la communication est activée, comme pour isCommunicationRuleEnabled. L'historique des modifications n'est volontairement pas inclus ici (voir CommunicationPreferenceLog), afin de garder ce document, très souvent lu, léger.

  • Array [
  • notificationTypestringobligatoire

    Valeurs possibles : [NEW_LOYALTY, UPDATE_LOYALTY, REMINDER_LOYALTY, EARNINGS_UPDATE, NEW_COMMUNICATION, EXPIRED_COMMUNICATION, NEW_EVENT, UPDATE_EVENT, NEW_COUPON, UPDATE_COUPON, WELCOME_INTERNAL_CLIENTS, WELCOME_CRM_CLIENTS, WELCOME_EXTERNAL_CLIENTS, WELCOME_COUPON, EXPIRED_COUPON, TRANSIT_TICKET, UPDATE_TRANSIT, HOTEL_RESERVATION, UPDATE_HOTEL_RESERVATION, CINEMA_TICKET]

    smsbooleanobligatoire
    emailbooleanobligatoire
    notificationbooleanobligatoire
  • ]
  • pushInformativeEnabledboolean

    Désinscription des campagnes de notifications push « standard » créées par un gestionnaire et classées comme informatives.

    pushCommercialEnabledboolean

    Désinscription des campagnes de notifications push « standard » créées par un gestionnaire et classées comme commerciales.

    _idstringobligatoire
    createdAtstring<date-time>obligatoire
    updatedAtstring<date-time>obligatoire
    ClientWithPassInfoResponseDto
    {
    "wallet": "string",
    "clientType": {
    "storeCard": {
    "wallet": {
    "name": "string",
    "logo": "string",
    "icon": "string",
    "androidLogo": "string",
    "displayIdentifiant": true,
    "passBuilderPassTemplateId": "string",
    "passBuilderBusinessId": "string",
    "passBuilderToken": "string",
    "identifier": "string",
    "identifierQr": "string",
    "address": "string",
    "website": "string",
    "servicePhone": "string",
    "businessPhone": "string",
    "socialMedia": {
    "linkedin": "string",
    "facebook": "string",
    "instagram": "string",
    "tiktok": "string",
    "twitter": "string",
    "youtube": "string",
    "snapchat": "string",
    "pinterest": "string",
    "reddit": "string",
    "whatsapp": "string",
    "telegram": "string"
    },
    "additionalContacts": [
    {
    "title": "string",
    "value": "string",
    "kind": "URL"
    }
    ],
    "termsAndConditions": {
    "type": "PDF",
    "customUrl": "string",
    "pdfUrl": "string"
    },
    "webHookUrl": "string",
    "rootDomain": "string",
    "timezone": "string",
    "allowedPasses": [
    "ALL"
    ],
    "expiredCleanupEnabled": true,
    "_id": "string",
    "createdAt": "2024-07-29T15:51:28.071Z",
    "updatedAt": "2024-07-29T15:51:28.071Z"
    },
    "cardType": "STORE_CARD",
    "displayIdentifiant": true,
    "displayWalletName": true,
    "strip": "string",
    "passBuilderPassTemplateId": "string",
    "programName": "string",
    "keysHasChanged": [
    "string"
    ],
    "startRow": "CREATION_DATE",
    "middleRow": "CREATION_DATE",
    "endRow": "CREATION_DATE",
    "iosHeader": {
    "labelEnum": "TYPE",
    "valueEnum": "TYPE",
    "customLabel": "string",
    "customValue": "string"
    },
    "barcodeType": "AZTEC",
    "descriptions": [
    {
    "title": "string",
    "value": "string"
    }
    ],
    "openingHours": "string",
    "colors": {
    "labelColor": "string",
    "backgroundColor": "string",
    "foregroundColor": "string"
    },
    "oneTimeToUse": true,
    "sharingProhibited": true,
    "sharingProhibitedAndroid": true,
    "validity": {
    "expirationType": "NO_EXPIRATION",
    "expirationDate": "2024-07-29T15:51:28.071Z",
    "expirationAfterPeriod": "string",
    "expirationPeriodType": "YEARS",
    "expirationOption": "AT_CREATION_DATE"
    },
    "gainLabel": "GAIN",
    "gainUnit": "NONE",
    "offerLabel": "string",
    "enableDisplayIdentifiant": true,
    "gainFormatMigrated": true,
    "_id": "string",
    "createdAt": "2024-07-29T15:51:28.071Z",
    "updatedAt": "2024-07-29T15:51:28.071Z"
    },
    "name": "string",
    "isDefault": true,
    "_id": "string",
    "createdAt": "2024-07-29T15:51:28.071Z",
    "updatedAt": "2024-07-29T15:51:28.071Z"
    },
    "passStatus": "active",
    "deviceTypes": "IOS, ANDROID",
    "shortLink": "string",
    "shortId": "string",
    "passBuilderPassId": "string",
    "passId": "string",
    "clientTypeName": "string",
    "otherPassStatuses": {
    "event": "active",
    "transit": "active",
    "hotel": "active"
    },
    "source": "CRM",
    "barcode": "string",
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "companyName": "string",
    "renewalDate": "2024-07-29T15:51:28.071Z",
    "phoneNumber": "string",
    "birthDate": "2024-07-29T15:51:28.071Z",
    "admissionDate": "2024-07-29T15:51:28.071Z",
    "gain": 0,
    "gainHistory": [
    {
    "gain": 0,
    "date": "2024-07-29T15:51:28.071Z"
    }
    ],
    "communicationPreferences": [
    {
    "notificationType": "NEW_LOYALTY",
    "sms": true,
    "email": true,
    "notification": true
    }
    ],
    "pushInformativeEnabled": true,
    "pushCommercialEnabled": true,
    "_id": "string",
    "createdAt": "2024-07-29T15:51:28.071Z",
    "updatedAt": "2024-07-29T15:51:28.071Z"
    }

    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