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 inmain.tsexpliciet 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
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:
| Methode | Eindpunt | Vereiste OAuth-scope | Doel in Zapier / Make |
|---|---|---|---|
| GET | /api/v1/me | Geldig OAuth2-token | Verifieert verbindingsgegevens en retourneert de geauthenticeerde tenant- en gebruikerscontext (Connected Integrations API). |
| GET | /api/v1/templates/:templateId/attributes | templates:read | Vult aangepaste sjabloonvelden (memberName, points, tier) dynamisch in binnen de actieontwerper. |
| POST | /api/v1/webhook-subscriptions | webhooks:write | Registreert een webhookabonnement ({ event, targetUrl, metadata? }) wanneer een gebruiker een Zap of scenario inschakelt. |
GET / DELETE | /api/v1/webhook-subscriptions | webhooks:read / webhooks:write | Toont 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):
| Leveranciersplatform | Inkomende callbackroute | Typische verwerkte triggergebeurtenissen | Geautomatiseerde actie in Passinstance |
|---|---|---|---|
| Stripe | POST /webhooks/stripe & POST /webhooks/stripe/billing | checkout.session.completed, invoice.paid, customer.subscription.deleted | Geeft betaalde lidmaatschapspassen uit (PassFlow-webhook ook op /api/v1/pass-flows/public/webhooks/stripe) of verklaart passen ongeldig bij annulering. |
| Shopify | POST /webhooks/shopify | orders/paid, orders/cancelled, customers/create, refunds/create | Geeft loyaliteits- of cadeaubonnen uit / werkt deze bij (externalId) en verklaart terugbetaalde vouchers ongeldig. |
| WooCommerce | POST /webhooks/woocommerce | order.completed, order.refunded, customer.created | Richt winkeltegoedkaarten in, werkt loyaliteitspunten bij en synchroniseert orderverzilveringen. |
| Salesforce | POST /webhooks/salesforce | Outbound Message / Platform Event (Contact, Opportunity, CampaignMember) | Geeft VIP-passen uit wanneer deals worden gesloten (X-Passinstance-Salesforce-Signature). |
| HubSpot | POST /webhooks/hubspot | contact.creation, contact.propertyChange, deal.propertyChange | Schrijft CRM-contacten in voor Wallet Experiences en synchroniseert niveauwijzigingen. |
| Klaviyo | POST /webhooks/klaviyo | Flow Webhook Action (segmenteerinstap, VIP-mijlpaal, verjaardagsstroom) | Genereert gepersonaliseerde paslinks of activeert pushmeldingen op het toegangsscherm. |
| Twilio | POST /webhooks/twilio | Callbacks over sms-afleverstatus & inkomende sms-trefwoord-opt-ins | Volgt ontvangstbevestigingen van sms-pasleveringen en geeft passen uit wanneer klanten een trefwoord sms'en. |
| Eventbrite | POST /webhooks/eventbrite | order.placed, attendee.updated, attendee.checked_in | Geeft evenementtickets voor Apple/Google Wallet uit (met bundleId ondertekende .pkpass) en synchroniseert de check-in-status bij de ingang. |
| Typeform | POST /webhooks/typeform | form_response-inzendingswebhook | Zet inzendingen van enquêtes of leadformulieren rechtstreeks om in gepersonaliseerde wallet-passen. |
| Zoho CRM | POST /webhooks/zoho | Webhook 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.
