Skip to content
Helpcentrum-gids · Pass-distributie
4 min leestijdGecontroleerd 2026-11-16

Passen verkopen

Monetariseer digitale wallet-passen met PassFlow Checkout door Stripe, PayPal of Paystack te koppelen voor directe pass-uitgifte na betaling.

In deze gids

Passen verkopen met PassFlow-checkout

Met Passinstance kunnen bedrijven digitale evenementtickets, betaalde lidmaatschappen, VIP-toegangspassen en digitale cadeaukaarten rechtstreeks verkopen via PassFlows (/f/:url). Door betalingsafhandeling op te nemen in de selfservice-inschrijfstroom accepteert u betalingen en geeft u cryptografisch ondertekende Apple Wallet- en Google Wallet-passen uit in één soepele transactie.

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
BETAALDE PASINSCHRIJVING & WEBHOOK-UITGIFTE
FASE 01 KLANTBROWSER (PASSFLOW /f/:slug)
1
FormStep: Klant vult naam, e-mail, telefoon en aangepaste attributen in
2
OtpStep (Optioneel): Verifieert e-mail of mobiel nummer met 6-cijferige code
3
PaymentStep: Toont prijs, artikeloverzicht en ingebedde betaalelementen
FASE 02 BETAALGATEWAY (STRIPE / PAYPAL / PAYSTACK)
Verwerkt 3D-Secure 2-kaartauthenticatie, Apple Pay, Google Pay of PayPal
Bevestigt afschrijving en stuurt vastleggingsevenement
FASE 03 PASSINSTANCE BETAALWEBHOOK- & UITGIFTE-ENGINE
Verifieert webhookhandtekening cryptografisch (Stripe-Signature / PayPal)
Maakt idempotent een Pass-record aan in de database (status ACTIVE)
Voegt betaalmetadata (transactionId, amountPaid, currency) toe aan attributen
FASE 04 DIRECTE WALLET-TOEVOEGING (PASSSTEP)
Klant voegt pas direct toe via [Add to Apple Wallet] en [Save to Google]

Ondersteunde betaalproviders & betaalmethoden

Passinstance ondersteunt internationale en regionale betaalgateways via IPublicPassFlowPaymentConfig:

ProviderOndersteunde betaalmethodenOndersteunde valuta'sMeest geschikt voor
StripeCreditcards/betaalpassen, Apple Pay, Google Pay, SEPA-incasso, iDEAL, Bancontact135+ valuta's (EUR, USD, GBP, enz.)Internationale e-commerce, mobiele wallets en Europese incasso's
PayPalPayPal-saldo, creditcards, Pay in 4, Venmo25+ internationale valuta'sHoge merkherkenning en soepele PayPal-checkout met één klik
PaystackLokale kaarten, bankoverschrijvingen, USSD, Apple PayNGN, GHS, ZAR, KESAfrikaanse markten en pan-Afrikaanse betalingen
Mobile MoneyMTN MoMo, Orange Money, M-PesaLokale Afrikaanse mobiele valuta'sMobile-first klantinschrijving in opkomende markten

Stapsgewijze configuratie: een betaalde PassFlow aanmaken

Zo richt u betaalde pasinschrijving in voor elk sjabloon:

Stap 1: Koppel uw betaalgateway

Koppel eerst uw betaalprovider voordat u pasprijzen instelt:

  1. 1
    Ga in het dashboard naar Instellingen -> Integraties -> Betalingen (/settings/integrations/payments).
  2. 2
    Klik op Verbinden bij Stripe, PayPal of Paystack.
  3. 3
    Vul uw productie-API-sleutels in of voltooi de OAuth-onboardingstroom.

Stap 2: Open de PassFlow Builder

  1. 1
    Ga naar Passen -> PassFlows en kies de stroom die aan uw sjabloon gekoppeld is (of maak een nieuwe stroom aan).
  2. 2
    Zorg voor de volgende volgorde van stappen in de stroom:

- FormStep (Klantgegevens) - EmailStep of OtpStep (Optionele verificatie) - PaymentStep (Betalingsinning) - PassStep (Pasbezorging)

Stap 3: Configureer pasprijs & valuta

Klik op het blok PaymentStep om de afrekeneigenschappen in te stellen:

  • Prijs (amount): Stel de prijs van de pas in (bijv. 25.00).
  • Valuta (currency): Kies uw afrekenvaluta (bijv. EUR, USD).
  • Artikelnaam & beschrijving: Vul de titel in die klanten op de betaalpagina zien (bijv. "Jaarlijks VIP Lounge-lidmaatschap 2026").
  • Betaalproviders: Vink aan welke gekoppelde gateways u wilt aanbieden (bijv. zowel Stripe als PayPal inschakelen).

Stap 4: Koppel betaalmetadata aan pasattributen

U kunt details uit de betaalbevestiging automatisch koppelen aan aangepaste pasvelden:

  • Gebruik {transactionId} om de referentie-ID van de betaalgateway vast te leggen.
  • Gebruik {amountPaid} om de betaalde ticketprijs op de achterzijde van de pas te tonen.
  • Gebruik {paymentDate} om het aankooptijdstip bij te houden.

Stap 5: Publiceer & test uw stroom

Open uw openbare PassFlow-link (/f/:slug) in een incognitovenster:

  1. 1
    Vul testgegevens van een klant in.
  2. 2
    Rond een testbetaling af met testkaarten van uw gateway of Sandbox PayPal-inloggegevens.
  3. 3
    Controleer of de pas onmiddellijk wordt uitgegeven op het scherm PassStep.

Openbare REST API-endpoints voor checkout

Als u de verkoop van passen wilt integreren in uw eigen mobiele app, website of React-frontend, kunt u de openbare PassFlow-betaalendpoints rechtstreeks aanroepen:

MethodeEndpointpadBeschrijving
GET/api/v1/pass-flows/public/:url/payment-configRetourneert de betaalconfiguratie: ingeschakelde gateways, valuta, bedrag en openbare API-sleutels.
POST/api/v1/pass-flows/public/:url/payment-intentMaakt een Stripe PaymentIntent aan en retourneert clientSecret voor Stripe Elements.
POST/api/v1/pass-flows/public/:url/paypal-orderMaakt een PayPal v2 Order aan en retourneert de PayPal-goedkeurings-URL.
POST/api/v1/pass-flows/public/:url/paystack/initializeInitialiseert een Paystack-transactie en retourneert een autorisatie-URL.
POST/api/v1/pass-flows/public/:url/mtn-momo/request-to-payVerstuurt een push-betaalverzoek naar een MTN Mobile Money-telefoonnummer.

Voorbeeld: een Stripe Payment Intent initialiseren

HTTP
POST /api/v1/pass-flows/public/vip-membership-2026/payment-intent HTTP/1.1
Host: api.passinstance.com
Content-Type: application/json

{
  "email": "customer@example.com",
  "name": "Jordan Lee",
  "attributes": {
    "tier": "Gold VIP",
    "seatNumber": "Row A, Seat 12"
  }
}

Respons (200 OK):

JSON
{
  "clientSecret": "pi_3Q9xZ2eZvKYlo2C11223344_secret_R1a2B3c4D5e6F7g8",
  "publishableKey": "pk_live_51H...",
  "amount": 4900,
  "currency": "EUR",
  "flowSessionId": "flow_sess_01j9x87k1"
}

Terugbetalingen, geschillen & pasintrekking afhandelen

Wanneer een klant om een terugbetaling vraagt of een afschrijving betwist via Stripe of PayPal:

  1. 1
    Automatische webhookverwerking: Passinstance ontvangt de webhook charge.refunded of PAYMENT.CAPTURE.REFUNDED.
  2. 2
    Optie voor pasintrekking: Onder Werkruimte-instellingen -> Betalingen configureert u het geautomatiseerde terugbetalingsbeleid:

- Pas automatisch ongeldig verklaren (aanbevolen): Zet pass.voided = true. Apple Wallet plaatst direct een banner "Ongeldig" over de pas en streept de barcode door. Google Wallet markeert de pas als inactief. Scanners weigeren toekomstige incheckpogingen. - Pas behouden: Laat de pas actief en legt een auditrecord vast voor handmatige beoordeling door medewerkers.

  1. 3
    Pushmelding: Bij ongeldigmaking verzendt Passinstance een APNs- en Google Wallet-pushmelding waarmee de pashouder wordt geïnformeerd dat zijn pas wegens terugbetaling is ingetrokken.

Gerelateerde documentatie

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.