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/v1dansmain.tsafin de respecter nativement les conventions d'URL de rappel et vérificateurs cryptographiques de chaque tiers.
Architecture de connectivité des intégrations
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éthode | Point d'entrée | Portée OAuth requise | Rôle dans Zapier / Make |
|---|---|---|---|
| GET | /api/v1/me | Jeton OAuth2 valide | Vérifie les identifiants de connexion et renvoie le locataire et contexte utilisateur authentifiés (Connected Integrations API). |
| GET | /api/v1/templates/:templateId/attributes | templates:read | Peuple dynamiquement les champs personnalisés du modèle (memberName, points, tier) dans le constructeur d'actions. |
| POST | /api/v1/webhook-subscriptions | webhooks:write | Enregistre un abonnement webhook ({ event, targetUrl, metadata? }) lorsqu'un utilisateur active un Zap ou un scénario. |
GET / DELETE | /api/v1/webhook-subscriptions | webhooks:read / webhooks:write | Liste 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 tierce | Route de rappel entrante | Événements déclencheurs gérés | Action automatisée Passinstance |
|---|---|---|---|
| Stripe | POST /webhooks/stripe & POST /webhooks/stripe/billing | checkout.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. |
| Shopify | POST /webhooks/shopify | orders/paid, orders/cancelled, customers/create, refunds/create | Émet/actualise cartes de fidélité ou cartes cadeaux (externalId) et invalide les bons remboursés. |
| WooCommerce | POST /webhooks/woocommerce | order.completed, order.refunded, customer.created | Crée des avoirs boutique, actualise les points de fidélité et synchronise les encaissements de commandes. |
| Salesforce | POST /webhooks/salesforce | Outbound Message / Platform Event (Contact, Opportunity, CampaignMember) | Émet des cartes VIP lors de la signature de contrats (X-Passinstance-Salesforce-Signature). |
| HubSpot | POST /webhooks/hubspot | contact.creation, contact.propertyChange, deal.propertyChange | Inscrit les contacts CRM dans des Wallet Experiences et synchronise les changements de palier. |
| Klaviyo | POST /webhooks/klaviyo | Flow 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é. |
| Twilio | POST /webhooks/twilio | Rapports d'état SMS & mots-clés SMS entrants | Suit les accusés de livraison SMS et émet une carte dès qu'un client envoie un mot-clé par SMS. |
| Eventbrite | POST /webhooks/eventbrite | order.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. |
| Typeform | POST /webhooks/typeform | Webhook de soumission form_response | Convertit directement les réponses de formulaires ou sondages en passes Wallet personnalisés. |
| Zoho CRM | POST /webhooks/zoho | Webhook 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.
