Aller au contenu principal

Carte d'adhérent d'association dans Apple Wallet et Google Wallet

Une association vit de ses adhérents. Chaque année, il faut les relancer, imprimer les cartes, les poster, prévenir de l'assemblée générale. La carte d'adhérent dans Apple Wallet ou Google Wallet fait tout ça à la fois : preuve d'adhésion, canal d'information direct et billet pour vos événements. Vous importez votre liste d'adhérents une fois, puis vous la tenez à jour.

Essayez ce pass en directRemplissez le formulaire, voyez le pass et le code se mettre à jour, puis recevez-le sur votre téléphone.

Le parcours client​

Workflow d'intégration​

  1. Paramétrer la carte d'adhérentBack-office

    Choisissez MEMBER_CARD, affichez l'association (ASSOCIATION) et le numéro d'adhérent (N_ADHERENT). Sur iPhone, affichez la catégorie dans l'en-tête (iosHeader à TYPE). Gardez la même carte d'une année sur l'autre : seules la catégorie et la date de renouvellement changent. Ajoutez vos contacts et votre site sur le wallet.

    PATCH/store-cardsEssayer
    curl -L -X PATCH 'https://api-v2.test.eldowallet.fr/store-cards' \
    -H 'Accept: application/json' \
    -H 'x-lang: fr' \
    -H 'Authorization: Bearer <token>' \
    -F 'strip=@"jardins.png"' \
    -F 'cardType="MEMBER_CARD"' \
    -F 'programName="Carte d'\''adhérent"' \
    -F 'barcodeType="QR_CODE"' \
    -F 'startRow="ASSOCIATION"' \
    -F 'endRow="N_ADHERENT"' \
    -F 'iosHeader="{\"labelEnum\":\"CUSTOM_TEXT\",\"customLabel\":\"Catégorie\",\"valueEnum\":\"TYPE\"}"' \
    -F 'validity="{\"expirationType\":\"NO_EXPIRATION\"}"' \
    -F 'sharingProhibited="true"' \
    -F 'sharingProhibitedAndroid="true"' \
    -F 'colors="{\"backgroundColor\":\"\#2f4a1f\",\"labelColor\":\"\#f4d35e\",\"foregroundColor\":\"\#ffffff\"}"'
    PATCH/store-cardsPATCH/wallets
  2. Une catégorie, un type de clientBack-office

    Membre actif, bienfaiteur, jeune, bénévole, membre d'honneur : chaque catégorie devient un type de client. Vous ciblez ensuite vos messages par catégorie. Voir Types de clients.

    POST/client-types
  3. Importer la liste des adhérentsVotre serveur

    Vous avez déjà un tableur ou un export de votre outil de gestion : importez-le en CSV. L'import tourne en arrière-plan. Avec sendNotificationsToCustomers: true, chaque adhérent reçoit sa carte. Pour une synchronisation régulière, utilisez la création en masse en JSON (jusqu'à 5 000 lignes par appel). Voir Importer une base clients.

    POST/csv-operations/import-csvEssayer
    curl -L 'https://api-v2.test.eldowallet.fr/csv-operations/import-csv' \
    -H 'Accept: application/json' \
    -H 'x-lang: fr' \
    -H 'Authorization: Bearer <token>' \
    -F 'file=@"adherents-2026.csv"' \
    -F 'sendNotificationsToCustomers="true"'
    POST/csv-operations/import-csvGET/csv-operationsPOST/clients/bulkGET/bulk-operations/{operationId}
  4. Émettre la carte à chaque nouvelle adhésionVotre serveur

    À la réception de la cotisation, votre outil crée l'adhérent avec son numéro comme code-barres, sa catégorie, sa date d'adhésion et sa date de renouvellement.

    POST/clientsEssayer
    curl -L 'https://api-v2.test.eldowallet.fr/clients' \
    -H 'Accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'x-lang: fr' \
    -H 'Authorization: Bearer <token>' \
    --data-raw '{
      "firstName": "Paul",
      "lastName": "Garnier",
      "email": "paul.garnier@example.com",
      "barcode": "2026-0318",
      "clientType": "$BIENFAITEUR_TYPE_ID",
      "admissionDate": "2026-09-01T00:00:00.000Z",
      "renewalDate": "2027-08-31T00:00:00.000Z",
      "source": "CRM",
      "sendCard": true
    }'
    POST/clients
  5. L'adhérent ajoute sa carteClient final

    Il la présente à l'entrée d'une activité ou chez un partenaire, même sans réseau.

  6. Relancer ceux qui n'ont pas ajouté leur carteVotre serveur

    Une semaine après l'import, relancez les adhérents dont la carte n'est pas installée : tous, ou une liste précise.

    POST/clients/reminder-inactive
  7. Informer les adhérentsBack-office

    Convocation à l'assemblée générale, appel aux bénévoles, changement de lieu d'une activité : une notification à tous les adhérents, ou à une catégorie (target: SPECIFIC). Pour une campagne (collecte, journée portes ouvertes), créez une communication : le strip de la carte change pendant la période. Voir Notifications push.

    POST/push-notificationsEssayer
    curl -L 'https://api-v2.test.eldowallet.fr/push-notifications' \
    -H 'Accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'x-lang: fr' \
    -H 'Authorization: Bearer <token>' \
    -d '{
      "defaultTitle": "Assemblée générale",
      "defaultMessage": "AG le 14 mars à 18 h, salle des fêtes. Votre présence compte.",
      "target": "ALL",
      "type": "SCHEDULED",
      "category": "INFORMATIVE",
      "scheduleAt": "2027-02-28T09:00:00.000Z"
    }'
    POST/push-notificationsPOST/communications
  8. Billets pour vos événementsVotre serveur

    Soirée annuelle, sortie, tournoi, conférence : créez un événement, puis émettez un billet à chaque inscrit. Passez le clientId de l'adhérent pour relier le billet à sa fiche. Les invités extérieurs reçoivent un billet sans être adhérents. Voir Événements & salons.

    POST/events/{id}/passesEssayer
    curl -L 'https://api-v2.test.eldowallet.fr/events/$EVENT_ID/passes' \
    -H 'Accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'x-lang: fr' \
    -H 'Authorization: Bearer <token>' \
    --data-raw '{
      "firstName": "Paul",
      "lastName": "Garnier",
      "email": "paul.garnier@example.com",
      "clientId": "$CLIENT_ID",
      "leftRow": "Adhérent",
      "rightRow": "Table 4"
    }'
    POST/eventsPOST/events/{id}/passesPOST/events/{id}/passes/bulk
  9. Pointer les entréesVotre serveur

    À l'entrée, scannez le billet et validez-le. Un second scan renvoie PASS_ALREADY_REDEEMED.

    GET/events/{id}/passes/barcode/{barcode}POST/passes/template/{templateId}/redeem/{barcode}
  10. Renouvellement annuelVotre serveur

    Un mois avant la fin de l'année d'adhésion, programmez un rappel aux adhérents concernés. À réception de la cotisation, mettez à jour la date de renouvellement et, si besoin, la catégorie. La carte installée se met à jour.

    PATCH/clients/{id}Essayer
    curl -L -X PATCH 'https://api-v2.test.eldowallet.fr/clients/$CLIENT_ID' \
    -H 'Accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'x-lang: fr' \
    -H 'Authorization: Bearer <token>' \
    -d '{
      "renewalDate": "2028-08-31T00:00:00.000Z",
      "clientType": "$MEMBRE_ACTIF_TYPE_ID"
    }'
    POST/push-notificationsPATCH/clients/{id}PATCH/clients/bulk

Bonnes pratiques​

  • Le numéro d'adhérent comme code-barres. C'est le numéro de votre registre : pas de table de correspondance.
  • Une carte, plusieurs années. Au renouvellement, mettez à jour la carte existante plutôt que d'en créer une seconde.
  • Le strict nécessaire sur la carte. Nom, numéro, catégorie. Le reste reste dans votre outil de gestion.
  • Des messages utiles. AG, activités, bénévolat : INFORMATIVE. Une offre d'un partenaire est COMMERCIAL. Respectez les préférences de communication de chaque adhérent.
  • Nettoyez le fichier avant l'import. Un email et un numéro d'adhérent uniques par ligne : les doublons sont refusés.

Pour aller plus loin​

Pour vous inspirer​

La carte d’adhérent peut faire vivre votre association toute l’année. Voici des idées pour fidéliser vos membres.

Avantages chez les partenairesLes commerçants partenaires accordent une remise sur présentation de la carte. L’adhésion prend de la valeur.
Reçu fiscal disponibleAprès un don ou une cotisation, l’adhérent est prévenu que son reçu est disponible, avec le lien direct.
Merci aux bénévolesLes heures de bénévolat s’affichent sur la carte, avec un message de remerciement à chaque cap franchi.
Consulter les adhérentsSondage, vote en ligne, choix de la prochaine sortie : un message avec le lien, et le résultat sur la carte.
Anniversaire d’adhésion« 10 ans parmi nous ! » Un message de remerciement à chaque date anniversaire, qui renforce l’attachement.
Carte familleChaque membre d’une adhésion familiale a sa propre carte, dans son propre téléphone.
L’activité du jourEn arrivant sur le lieu d’une activité, l’adhérent voit le programme de la journée sur sa carte.
Parrainer un nouvel adhérentUn adhérent fait venir un proche : le nouveau membre reçoit sa carte, le parrain un petit cadeau de remerciement.

Une de ces idées vous parle ? Contactez notre équipe : nous vous montrons comment la mettre en place.

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