Skip to content
Helpcentrum-gids · Externe integraties
3 min leestijdGecontroleerd 2026-11-16

Beschikbare integraties

Overzicht van productiekoppelingen: REST API, HMAC-webhooks, dynamische URL's, embed-widgets, FTP/SFTP en GA4.

In deze gids

Overzicht

Passinstance biedt eersteklas integratieoppervlakken voor no-code automatiseringsplatforms (Zapier, Make), e-commerce webwinkels, CRM-systemen, betalingsverwerkers en marketingclouds, die worden geconfigureerd onder Werkruimte-instellingen -> Integraties (/settings/workspace/integrations, /connectors, /connected-apps en /link-generator). Naast de /api/v1 REST API en uitgaande webhooks, stelt Passinstance een OAuth/iPaaS-ontdekkingsoppervlak (Integrations API) en prefixvrije ontvangers voor inkomende leverancierswebhooks (/webhooks/*) beschikbaar.

Belangrijk: Eindpunten voor inkomende leverancierswebhooks (/webhooks/stripe, /webhooks/shopify, enz.) zijn in main.ts expliciet uitgesloten van het globale /api/v1-voorvoegsel, zodat ze direct overeenkomen met de strikte URL-conventies voor callbacks en cryptografische handtekeningverificateurs van externe leveranciers.

Architectuur voor integratieconnectiviteit

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
SYSTEEMARCHITECTUURSTROOM: INKOMENDE LEVERANCIERSWEBHOOKS & IPAAS OAUTH-OPPERVLAK
DEELNEMENDE SYSTEEMACTOREN
P1 Externe SaaS- / iPaaS-platforms
P2 Passinstance API-oppervlak
P3 Domeinuitvoering
STAP CTX KONTEXT Zapier / Make / n8n
STAP 1 VERZOEK / ACTIE GET/api/v1/me
›
(Connected Integrations API)
STAP 2 VERZOEK / ACTIE GET/api/v1/templates/
›
OAuth-scope: templates:read
›
:templateId/attributes
›
retourneert dynamisch schema
STAP 3 VERZOEK / ACTIE POST/api/v1/webhook-subscriptions (targetUrl)
›
registreert REST-hook
STAP CTX KONTEXT Stripe / Shopify / HubSpot / Klaviyo
STAP 4 VERZOEK / ACTIE POST/webhooks/<vendor>
›
(Leveranciers-webhookcontr.)
›
Header: Vendor HMAC Signature
›
Verifieer handtekening
›
Match externalId & Upsert
›
Pas uitgeven / bijwerken

OAuth-integratieoppervlak voor Zapier & Make (Integrations API)

Low-code automatiseringsbouwers maken verbinding met Passinstance via OAuth 2.0 Bearer-tokens (OAuth 2.0 Authentication + Permission Scope Validation) onder /api/v1:

MethodeEindpuntVereiste OAuth-scopeDoel in Zapier / Make
GET/api/v1/meGeldig OAuth2-tokenVerifieert verbindingsgegevens en retourneert de geauthenticeerde tenant- en gebruikerscontext (Connected Integrations API).
GET/api/v1/templates/:templateId/attributestemplates:readVult aangepaste sjabloonvelden (memberName, points, tier) dynamisch in binnen de actieontwerper.
POST/api/v1/webhook-subscriptionswebhooks:writeRegistreert een webhookabonnement ({ event, targetUrl, metadata? }) wanneer een gebruiker een Zap of scenario inschakelt.
GET / DELETE/api/v1/webhook-subscriptionswebhooks:read / webhooks:writeToont of verwijdert door OAuth beheerde webhookabonnementen (/api/v1/oauth/connections voor de UI van verbonden apps).

Ondersteunde integration category-categorieën

Bij het aanmaken van werkruimte-integraties (/api/v1/integrations) classificeert Passinstance connectoren met behulp van de Passinstance database integration category met 21 waarden: 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 en PARAMETERIZED_PASS_LINK.

Speciale routes voor inkomende leverancierswebhooks (/webhooks/*)

Passinstance biedt speciale, op handtekening geverifieerde ontvangers voor inkomende webhooks voor 10 grote commerce-, CRM-, berichten- en evenementenplatforms (plus /v1/automations/webhooks/shopify/:customerId en /woocommerce/:customerId voor multi-tenant regelmatching bij webwinkels):

LeveranciersplatformInkomende callbackrouteTypische verwerkte triggergebeurtenissenGeautomatiseerde actie in Passinstance
StripePOST /webhooks/stripe & POST /webhooks/stripe/billingcheckout.session.completed, invoice.paid, customer.subscription.deletedGeeft betaalde lidmaatschapspassen uit (PassFlow-webhook ook op /api/v1/pass-flows/public/webhooks/stripe) of verklaart passen ongeldig bij annulering.
ShopifyPOST /webhooks/shopifyorders/paid, orders/cancelled, customers/create, refunds/createGeeft loyaliteits- of cadeaubonnen uit / werkt deze bij (externalId) en verklaart terugbetaalde vouchers ongeldig.
WooCommercePOST /webhooks/woocommerceorder.completed, order.refunded, customer.createdRicht winkeltegoedkaarten in, werkt loyaliteitspunten bij en synchroniseert orderverzilveringen.
SalesforcePOST /webhooks/salesforceOutbound Message / Platform Event (Contact, Opportunity, CampaignMember)Geeft VIP-passen uit wanneer deals worden gesloten (X-Passinstance-Salesforce-Signature).
HubSpotPOST /webhooks/hubspotcontact.creation, contact.propertyChange, deal.propertyChangeSchrijft CRM-contacten in voor Wallet Experiences en synchroniseert niveauwijzigingen.
KlaviyoPOST /webhooks/klaviyoFlow Webhook Action (segmenteerinstap, VIP-mijlpaal, verjaardagsstroom)Genereert gepersonaliseerde paslinks of activeert pushmeldingen op het toegangsscherm.
TwilioPOST /webhooks/twilioCallbacks over sms-afleverstatus & inkomende sms-trefwoord-opt-insVolgt ontvangstbevestigingen van sms-pasleveringen en geeft passen uit wanneer klanten een trefwoord sms'en.
EventbritePOST /webhooks/eventbriteorder.placed, attendee.updated, attendee.checked_inGeeft evenementtickets voor Apple/Google Wallet uit (met bundleId ondertekende .pkpass) en synchroniseert de check-in-status bij de ingang.
TypeformPOST /webhooks/typeformform_response-inzendingswebhookZet inzendingen van enquêtes of leadformulieren rechtstreeks om in gepersonaliseerde wallet-passen.
Zoho CRMPOST /webhooks/zohoWebhook voor workflowregels (Leads, Contacts, Deals)Geeft ledenkaarten uit en werkt deze bij vanuit workflowovergangen in Zoho CRM.

Aanvullende systeemeigen verbindingsopties

  • Systeemeigen plug-in voor Shopware 6: Volledige suite met beheerders-, etalage-, registratie- en webhookcontrollers (/shopware en E-commerce-integraties).
  • Geplande FTP- / SFTP-batchsynchronisatie: Geautomatiseerde nachtelijke CSV-import- en exporttaken (FTP_IMPORT_JOB / FTP_EXPORT_JOB) voor bestaande ERP- en retail-POS-systemen.
  • Dynamische Wallet-URL's en insluitwidgets: Ondertekende URL-generatie (/settings/workspace/integrations/link-generator) en kant-en-klare HTML-knoppen (EMBED_PASS_DOWNLOAD, IFRAME_PASS_DOWNLOAD).

Bekijk alle connectoren op /integrations en verken interne regelautomatisering in Workflowconfiguratie.

Gerelateerde product- en ontwikkelaarsdocs

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.