Skip to content
Hilfecenter-Anleitung · Drittanbieter-Integrationen
3 Min. LesezeitGeprüft 2026-11-16

Verfügbare Integrationen

Überblick über produktive Schnittstellen: REST-API, HMAC-Webhooks, Dynamische URLs, Embed-Widgets, FTP/SFTP und GA4.

In dieser Anleitung

Ü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/shopify usw.) sind in main.ts explizit 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

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
EINGEHENDE ANBIETER-WEBHOOKS & IPAAS-OAUTH-SCHNITTSTELLE
BETEILIGTE SYSTEMKOMPONENTEN
P1 Externe SaaS- / iPaaS-Plattformen
P2 Passinstance API-Oberfläche
P3 Domänenausführung
SCHRITT CTX KONTEXT Zapier / Make / n8n
SCHRITT 1 ANFRAGE / AKTION GET/api/v1/me
›
(Connected Integrations API)
SCHRITT 2 ANFRAGE / AKTION GET/api/v1/templates/
›
OAuth Scope: templates:read
›
:templateId/attributes
›
liefert dynamisches Schema
SCHRITT 3 ANFRAGE / AKTION POST/api/v1/webhook-subscriptions (targetUrl)
›
registriert REST-Hook
SCHRITT CTX KONTEXT Stripe / Shopify / HubSpot / Klaviyo
SCHRITT 4 ANFRAGE / AKTION POST/webhooks/<vendor>
›
(Vendor Webhook Controllers)
›
Header: Vendor HMAC Signature
›
Anbietersignatur prüfen
›
externalId abgleichen &
›
Pass ausstellen /
›
Upsert ausführen
›
aktualisieren

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:

MethodeEndpunktErforderlicher OAuth-ScopeZweck in Zapier / Make
GET/api/v1/meGültiges OAuth2-TokenPrüft Verbindungsdaten und gibt den authentifizierten Mandanten- und Benutzerkontext zurück (Connected Integrations API).
GET/api/v1/templates/:templateId/attributestemplates:readBefüllt benutzerdefinierte Vorlagenfelder (memberName, points, tier) dynamisch im Aktions-Designer.
POST/api/v1/webhook-subscriptionswebhooks:writeRegistriert ein Webhook-Abonnement ({ event, targetUrl, metadata? }), sobald ein Nutzer einen Zap oder ein Szenario aktiviert.
GET / DELETE/api/v1/webhook-subscriptionswebhooks:read / webhooks:writeListet 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-PlattformEingehende Callback-RouteTypische verarbeitete Trigger-EventsAutomatisierte Passinstance-Aktion
StripePOST /webhooks/stripe & POST /webhooks/stripe/billingcheckout.session.completed, invoice.paid, customer.subscription.deletedStellt bezahlte Mitgliedschaftspässe aus (PassFlow-Webhook auch unter /api/v1/pass-flows/public/webhooks/stripe) oder entwertet bei Kündigung.
ShopifyPOST /webhooks/shopifyorders/paid, orders/cancelled, customers/create, refunds/createErstellt bzw. aktualisiert Treue- oder Geschenkkarten (externalId) und entwertet erstattete Gutscheine.
WooCommercePOST /webhooks/woocommerceorder.completed, order.refunded, customer.createdStellt Filialguthaben-Karten bereit, aktualisiert Treuepunkte und synchronisiert Bestellungseinlösungen.
SalesforcePOST /webhooks/salesforceOutbound Message / Platform Event (Contact, Opportunity, CampaignMember)Stellt VIP-Pässe bei Abschluss von Deals aus (X-Passinstance-Salesforce-Signature).
HubSpotPOST /webhooks/hubspotcontact.creation, contact.propertyChange, deal.propertyChangeNimmt CRM-Kontakte in Wallet Experiences auf und synchronisiert Stufenwechsel.
KlaviyoPOST /webhooks/klaviyoFlow-Webhook-Aktion (Segment-Eintritt, VIP-Meilenstein, Geburtstags-Flow)Erzeugt personalisierte Pass-Links oder löst Sperrbildschirm-Push-Benachrichtigungen aus.
TwilioPOST /webhooks/twilioSMS-Zustellstatus-Callbacks & eingehende SMS-Keyword-Opt-insVerfolgt SMS-Pass-Zustellbelege und stellt Pässe aus, wenn Kunden ein Keyword per SMS senden.
EventbritePOST /webhooks/eventbriteorder.placed, attendee.updated, attendee.checked_inStellt Apple-/Google-Wallet-Event-Tickets (bundleId-signierte .pkpass) aus und synchronisiert den Einlass-Check-in-Status.
TypeformPOST /webhooks/typeformform_response-Formularübermittlungs-WebhookWandelt Umfrage- oder Lead-Erfassungs-Antworten direkt in personalisierte Wallet-Pässe um.
Zoho CRMPOST /webhooks/zohoWorkflow-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.

Weiterführende Produkt- & Entwicklerdoku

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.