Skip to content
Guide du centre d'aide · Intégrations tierces
4 min de lectureVérifié 2026-11-16

Intégrations disponibles

Panorama des connecteurs en production : API REST, webhooks HMAC, URL dynamiques, widgets intégrés, FTP/SFTP et GA4.

Dans ce guide

Aperçu

Passinstance propose des surfaces d'intégration natives pour les plateformes d'automatisation no-code (Zapier, Make), les boutiques en ligne, CRM, prestataires de paiement et solutions marketing, administrées dans Paramètres de l'espace -> Intégrations (/settings/workspace/integrations, /connectors, /connected-apps et /link-generator). En plus de l'API REST /api/v1 et des webhooks sortants, Passinstance expose une surface de découverte OAuth/iPaaS (Integrations API) ainsi que des récepteurs webhook entrants sans préfixe par fournisseur (/webhooks/*).

Important : Les points d'entrée webhook entrants par fournisseur (/webhooks/stripe, /webhooks/shopify, etc.) sont explicitement exclus du préfixe global /api/v1 dans main.ts afin de respecter nativement les conventions d'URL de rappel et vérificateurs cryptographiques de chaque tiers.

Architecture de connectivité des intégrations

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
WEBHOOKS ENTRANTS FOURNISSEURS & SURFACE OAUTH IPAAS
ACTEURS SYSTÈME PARTICIPANTS
P1 Plateformes SaaS / iPaaS externes
P2 Surface API Passinstance
P3 Exécution métier
ÉTAPE CTX CONTEXTE Zapier / Make / n8n
ÉTAPE 1 REQUÊTE / ACTION GET/api/v1/me
›
(Connected Integrations API)
ÉTAPE 2 REQUÊTE / ACTION GET/api/v1/templates/
›
Portée OAuth: templates:read
›
:templateId/attributes
›
retourne le schéma dynamique
ÉTAPE 3 REQUÊTE / ACTION POST/api/v1/webhook-subscriptions (targetUrl)
›
enregistre hook REST
ÉTAPE CTX CONTEXTE Stripe / Shopify / HubSpot / Klaviyo
ÉTAPE 4 REQUÊTE / ACTION POST/webhooks/<vendor>
›
(Contrôleurs Webhook Tiers)
›
En-tête : Signature HMAC Tiers
›
Vérifie la signature tiers
›
Apparie externalId & Upsert
›
Émet / MàJ Passe

Surface d'intégration OAuth Zapier & Make (Integrations API)

Les outils d'automatisation low-code se connectent à Passinstance via des jetons Bearer OAuth 2.0 (OAuth 2.0 Authentication + Permission Scope Validation) sous /api/v1 :

MéthodePoint d'entréePortée OAuth requiseRôle dans Zapier / Make
GET/api/v1/meJeton OAuth2 valideVérifie les identifiants de connexion et renvoie le locataire et contexte utilisateur authentifiés (Connected Integrations API).
GET/api/v1/templates/:templateId/attributestemplates:readPeuple dynamiquement les champs personnalisés du modèle (memberName, points, tier) dans le constructeur d'actions.
POST/api/v1/webhook-subscriptionswebhooks:writeEnregistre un abonnement webhook ({ event, targetUrl, metadata? }) lorsqu'un utilisateur active un Zap ou un scénario.
GET / DELETE/api/v1/webhook-subscriptionswebhooks:read / webhooks:writeListe ou supprime les abonnements webhook gérés par OAuth (/api/v1/oauth/connections pour l'interface Applications connectées).

Catégories integration category prises en charge

Lors de la création d'intégrations dans l'espace de travail (/api/v1/integrations), Passinstance classe chaque connecteur selon les 21 valeurs de l'énumération Passinstance database integration category : CRM, MARKETING_AUTOMATION, PAYMENT, TICKETING, GEOLOCATION, NOTIFICATIONS, ANALYTICS, INVENTORY, ACCOUNTING, CREATE_PASS_URL, FTP_JOB, IFRAME_PASS_DOWNLOAD, GOOGLE_ANALYTICS, NFC_PERSONALIZATION, PASS_DATA_FTP_UPLOAD, NAS_DATA_FTP_UPLOAD, FTP_IMPORT_JOB, FTP_EXPORT_JOB, EMBED_PASS_DOWNLOAD, WEB_ANALYTICS et PARAMETERIZED_PASS_LINK.

Routes webhook entrantes dédiées par fournisseur (/webhooks/*)

Passinstance met à disposition des récepteurs webhook entrants dédiés avec vérification cryptographique pour 10 plateformes majeures de e-commerce, CRM, messagerie et billetterie (ainsi que /v1/automations/webhooks/shopify/:customerId et /woocommerce/:customerId pour l'évaluation multi-locataire des règles boutique) :

Plateforme tierceRoute de rappel entranteÉvénements déclencheurs gérésAction automatisée Passinstance
StripePOST /webhooks/stripe & POST /webhooks/stripe/billingcheckout.session.completed, invoice.paid, customer.subscription.deletedÉmet des cartes d'abonnement payantes (webhook PassFlow aussi sous /api/v1/pass-flows/public/webhooks/stripe) ou invalide à la résiliation.
ShopifyPOST /webhooks/shopifyorders/paid, orders/cancelled, customers/create, refunds/createÉmet/actualise cartes de fidélité ou cartes cadeaux (externalId) et invalide les bons remboursés.
WooCommercePOST /webhooks/woocommerceorder.completed, order.refunded, customer.createdCrée des avoirs boutique, actualise les points de fidélité et synchronise les encaissements de commandes.
SalesforcePOST /webhooks/salesforceOutbound Message / Platform Event (Contact, Opportunity, CampaignMember)Émet des cartes VIP lors de la signature de contrats (X-Passinstance-Salesforce-Signature).
HubSpotPOST /webhooks/hubspotcontact.creation, contact.propertyChange, deal.propertyChangeInscrit les contacts CRM dans des Wallet Experiences et synchronise les changements de palier.
KlaviyoPOST /webhooks/klaviyoFlow Webhook Action (entrée dans segment, palier VIP, anniversaire)Génère des liens de passes personnalisés ou déclenche des notifications push sur écran verrouillé.
TwilioPOST /webhooks/twilioRapports d'état SMS & mots-clés SMS entrantsSuit les accusés de livraison SMS et émet une carte dès qu'un client envoie un mot-clé par SMS.
EventbritePOST /webhooks/eventbriteorder.placed, attendee.updated, attendee.checked_inÉmet des billets événementiels Apple/Google Wallet (.pkpass signé par bundleId) et synchronise l'entrée sur place.
TypeformPOST /webhooks/typeformWebhook de soumission form_responseConvertit directement les réponses de formulaires ou sondages en passes Wallet personnalisés.
Zoho CRMPOST /webhooks/zohoWebhook de règle workflow (Leads, Contacts, Deals)Émet et met à jour des cartes membres depuis les transitions de workflows Zoho CRM.

Autres options de connectivité natives

  • Plugin natif Shopware 6 : Suite complète administration, boutique, enregistrement et contrôleurs webhook (/shopware et Intégrations e-commerce).
  • Synchronisation batch planifiée FTP / SFTP : Tâches nocturnes automatisées d'import et d'export CSV (FTP_IMPORT_JOB / FTP_EXPORT_JOB) pour ERP anciens et systèmes POS retail.
  • URL Wallet dynamiques & widgets intégrés : Générateur d'URL signées (/settings/workspace/integrations/link-generator) et boutons HTML prêts à intégrer (EMBED_PASS_DOWNLOAD, IFRAME_PASS_DOWNLOAD).

Parcourez tous nos connecteurs sur /integrations et découvrez l'automatisation interne des règles dans Configuration des workflows.

Documentation produit et développeur associée

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.