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.
Ondersteunde betaalproviders & betaalmethoden
Passinstance ondersteunt internationale en regionale betaalgateways via IPublicPassFlowPaymentConfig:
| Provider | Ondersteunde betaalmethoden | Ondersteunde valuta's | Meest geschikt voor |
|---|---|---|---|
| Stripe | Creditcards/betaalpassen, Apple Pay, Google Pay, SEPA-incasso, iDEAL, Bancontact | 135+ valuta's (EUR, USD, GBP, enz.) | Internationale e-commerce, mobiele wallets en Europese incasso's |
| PayPal | PayPal-saldo, creditcards, Pay in 4, Venmo | 25+ internationale valuta's | Hoge merkherkenning en soepele PayPal-checkout met één klik |
| Paystack | Lokale kaarten, bankoverschrijvingen, USSD, Apple Pay | NGN, GHS, ZAR, KES | Afrikaanse markten en pan-Afrikaanse betalingen |
| Mobile Money | MTN MoMo, Orange Money, M-Pesa | Lokale Afrikaanse mobiele valuta's | Mobile-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
Ga in het dashboard naar Instellingen -> Integraties -> Betalingen (
/settings/integrations/payments). -
2
Klik op Verbinden bij Stripe, PayPal of Paystack.
-
3
Vul uw productie-API-sleutels in of voltooi de OAuth-onboardingstroom.
Stap 2: Open de PassFlow Builder
-
1
Ga naar Passen -> PassFlows en kies de stroom die aan uw sjabloon gekoppeld is (of maak een nieuwe stroom aan).
-
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
Vul testgegevens van een klant in.
-
2
Rond een testbetaling af met testkaarten van uw gateway of Sandbox PayPal-inloggegevens.
-
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:
| Methode | Endpointpad | Beschrijving |
|---|---|---|
| GET | /api/v1/pass-flows/public/:url/payment-config | Retourneert de betaalconfiguratie: ingeschakelde gateways, valuta, bedrag en openbare API-sleutels. |
| POST | /api/v1/pass-flows/public/:url/payment-intent | Maakt een Stripe PaymentIntent aan en retourneert clientSecret voor Stripe Elements. |
| POST | /api/v1/pass-flows/public/:url/paypal-order | Maakt een PayPal v2 Order aan en retourneert de PayPal-goedkeurings-URL. |
| POST | /api/v1/pass-flows/public/:url/paystack/initialize | Initialiseert een Paystack-transactie en retourneert een autorisatie-URL. |
| POST | /api/v1/pass-flows/public/:url/mtn-momo/request-to-pay | Verstuurt een push-betaalverzoek naar een MTN Mobile Money-telefoonnummer. |
Voorbeeld: een Stripe Payment Intent initialiseren
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):
{
"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
Automatische webhookverwerking: Passinstance ontvangt de webhook
charge.refundedofPAYMENT.CAPTURE.REFUNDED. -
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.
-
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
-
Abonnementen verkopen — Terugkerende lidmaatschappen en automatische synchronisatie van verlengingen.
-
Een PayPal API-handtekening aanvragen — PayPal REST OAuth-inloggegevens koppelen.
-
Selfservice-distributie — PassFlows, slimme links en NFC-inschrijving.
-
Registratieformulieren & PassFlow — Stapconfiguraties, botbescherming en formuliervalidatie.
