Überblick
Passinstance bietet erstklassige Integrationsschnittstellen für No-Code-Automatisierungsplattformen (Zapier, Make), E-Commerce-Storefronts, CRM-Systeme, Zahlungsdienstleister und Marketing-Clouds, konfigurierbar unter Arbeitsbereich-Einstellungen -> Integrationen (/settings/workspace/integrations, /connectors, /connected-apps und /link-generator). Zusätzlich zur /api/v1-REST-API und ausgehenden Webhooks stellt Passinstance eine OAuth-/iPaaS-Discovery-Schnittstelle (Integrations API) sowie präfixfreie Empfänger für eingehende Anbieter-Webhooks (/webhooks/*) bereit.
Wichtig: Eingehende Anbieter-Webhook-Endpunkte (
/webhooks/stripe,/webhooks/shopifyusw.) sind inmain.tsexplizit vom globalen/api/v1-Präfix ausgenommen, damit sie strikte Callback-URL-Konventionen von Drittanbietern und kryptografische Signaturprüfer sofort ohne Anpassung erfüllen.
Architektur der Integrationskonnektivität
Zapier- & Make-OAuth-Integrationsschnittstelle (Integrations API)
Low-Code-Automatisierungstools verbinden sich mit Passinstance über OAuth-2.0-Bearer-Tokens (OAuth 2.0 Authentication + Permission Scope Validation) unter /api/v1:
| Methode | Endpunkt | Erforderlicher OAuth-Scope | Zweck in Zapier / Make |
|---|---|---|---|
| GET | /api/v1/me | Gültiges OAuth2-Token | Prüft Verbindungsdaten und gibt den authentifizierten Mandanten- und Benutzerkontext zurück (Connected Integrations API). |
| GET | /api/v1/templates/:templateId/attributes | templates:read | Befüllt benutzerdefinierte Vorlagenfelder (memberName, points, tier) dynamisch im Aktions-Designer. |
| POST | /api/v1/webhook-subscriptions | webhooks:write | Registriert ein Webhook-Abonnement ({ event, targetUrl, metadata? }), sobald ein Nutzer einen Zap oder ein Szenario aktiviert. |
GET / DELETE | /api/v1/webhook-subscriptions | webhooks:read / webhooks:write | Listet OAuth-verwaltete Webhook-Abonnements auf oder entfernt sie (/api/v1/oauth/connections für die UI verbundener Apps). |
Unterstützte integration category-Kategorien
Beim Anlegen von Arbeitsbereich-Integrationen (/api/v1/integrations) klassifiziert Passinstance Konnektoren über das 21 Werte umfassende 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 und PARAMETERIZED_PASS_LINK.
Dedizierte eingehende Anbieter-Webhook-Routen (/webhooks/*)
Passinstance stellt dedizierte, signaturgeprüfte Empfänger für eingehende Webhooks von 10 großen Commerce-, CRM-, Messaging- und Event-Plattformen bereit (zusätzlich /v1/automations/webhooks/shopify/:customerId und /woocommerce/:customerId für mandantenfähigen Storefront-Regelabgleich):
| Anbieter-Plattform | Eingehende Callback-Route | Typische verarbeitete Trigger-Events | Automatisierte Passinstance-Aktion |
|---|---|---|---|
| Stripe | POST /webhooks/stripe & POST /webhooks/stripe/billing | checkout.session.completed, invoice.paid, customer.subscription.deleted | Stellt bezahlte Mitgliedschaftspässe aus (PassFlow-Webhook auch unter /api/v1/pass-flows/public/webhooks/stripe) oder entwertet bei Kündigung. |
| Shopify | POST /webhooks/shopify | orders/paid, orders/cancelled, customers/create, refunds/create | Erstellt bzw. aktualisiert Treue- oder Geschenkkarten (externalId) und entwertet erstattete Gutscheine. |
| WooCommerce | POST /webhooks/woocommerce | order.completed, order.refunded, customer.created | Stellt Filialguthaben-Karten bereit, aktualisiert Treuepunkte und synchronisiert Bestellungseinlösungen. |
| Salesforce | POST /webhooks/salesforce | Outbound Message / Platform Event (Contact, Opportunity, CampaignMember) | Stellt VIP-Pässe bei Abschluss von Deals aus (X-Passinstance-Salesforce-Signature). |
| HubSpot | POST /webhooks/hubspot | contact.creation, contact.propertyChange, deal.propertyChange | Nimmt CRM-Kontakte in Wallet Experiences auf und synchronisiert Stufenwechsel. |
| Klaviyo | POST /webhooks/klaviyo | Flow-Webhook-Aktion (Segment-Eintritt, VIP-Meilenstein, Geburtstags-Flow) | Erzeugt personalisierte Pass-Links oder löst Sperrbildschirm-Push-Benachrichtigungen aus. |
| Twilio | POST /webhooks/twilio | SMS-Zustellstatus-Callbacks & eingehende SMS-Keyword-Opt-ins | Verfolgt SMS-Pass-Zustellbelege und stellt Pässe aus, wenn Kunden ein Keyword per SMS senden. |
| Eventbrite | POST /webhooks/eventbrite | order.placed, attendee.updated, attendee.checked_in | Stellt Apple-/Google-Wallet-Event-Tickets (bundleId-signierte .pkpass) aus und synchronisiert den Einlass-Check-in-Status. |
| Typeform | POST /webhooks/typeform | form_response-Formularübermittlungs-Webhook | Wandelt Umfrage- oder Lead-Erfassungs-Antworten direkt in personalisierte Wallet-Pässe um. |
| Zoho CRM | POST /webhooks/zoho | Workflow-Regel-Webhook (Leads, Contacts, Deals) | Stellt Mitgliedskarten aus Zoho-CRM-Workflow-Übergängen aus und aktualisiert sie. |
Weitere native Anbindungsoptionen
-
Natives Shopware-6-Plugin: Vollständige Admin-, Storefront-, Registrierungs- und Webhook-Controller-Suite (/shopware und E-Commerce-Integrationen).
-
Zeitgesteuerter FTP- / SFTP-Batch-Sync: Automatisierte nächtliche CSV-Import- und -Export-Jobs (
FTP_IMPORT_JOB/FTP_EXPORT_JOB) für klassische ERP- und Einzelhandels-POS-Systeme. -
Dynamische Wallet-URLs & Embed-Widgets: Signierte URL-Generierung (
/settings/workspace/integrations/link-generator) sowie direkt einsetzbare HTML-Buttons (EMBED_PASS_DOWNLOAD,IFRAME_PASS_DOWNLOAD).
Entdecken Sie alle Konnektoren auf /integrations sowie interne Regelautomatisierung unter Workflow-Konfiguration.
