Monétiser vos passes avec le paiement PassFlow
Passinstance permet aux entreprises de vendre des billets d'événements numériques, des cartes de membre payantes, des passes d'accès VIP et des cartes cadeaux numériques directement via les PassFlows (/f/:url). En intégrant l'encaissement au sein du parcours d'inscription en libre-service, vous encaissez les paiements et émettez des passes Apple Wallet et Google Wallet signés cryptographiquement en une seule transaction fluide.
Prestataires & rails de paiement pris en charge
Passinstance prend en charge des passerelles de paiement mondiales et régionales via IPublicPassFlowPaymentConfig :
| Prestataire | Moyens de paiement pris en charge | Devises prises en charge | Idéal pour |
|---|---|---|---|
| Stripe | Cartes bancaires, Apple Pay, Google Pay, Prélèvement SEPA, iDEAL, Bancontact | Plus de 135 devises (EUR, USD, GBP, etc.) | E-commerce international, portefeuilles mobiles et prélèvements européens |
| PayPal | Solde PayPal, cartes bancaires, Paiement en 4X, Venmo | Plus de 25 devises mondiales | Forte notoriété et paiement PayPal en un clic sans friction |
| Paystack | Cartes locales, virements bancaires, USSD, Apple Pay | NGN, GHS, ZAR, KES | Marchés africains et opérations de paiement panafricaines |
| Mobile Money | MTN MoMo, Orange Money, M-Pesa | Devises mobiles africaines locales | Inscription mobile-first sur les marchés émergents |
Configuration étape par étape : créer un PassFlow payant
Pour activer l'inscription payante sur n'importe quel modèle :
Étape 1 : connecter votre passerelle de paiement
Avant de définir la tarification du passe, connectez votre prestataire de paiement :
-
1
Dans le tableau de bord, accédez à Paramètres -> Intégrations -> Paiements (
/settings/integrations/payments). -
2
Cliquez sur Connecter (Connect) sur Stripe, PayPal ou Paystack.
-
3
Renseignez vos clés API de production ou terminez le parcours d'onboarding OAuth.
Étape 2 : ouvrir le constructeur PassFlow
-
1
Accédez à Passes -> PassFlows et sélectionnez le parcours lié à votre modèle (ou créez-en un nouveau).
-
2
Dans la séquence d'étapes du parcours, assurez-vous de respecter l'ordre suivant :
- FormStep (Coordonnées du client) - EmailStep ou OtpStep (Vérification facultative) - PaymentStep (Encaissement du paiement) - PassStep (Livraison du passe)
Étape 3 : configurer le prix & la devise du passe
Cliquez sur le bloc PaymentStep pour configurer les propriétés de paiement :
-
Prix (
amount) : définissez le tarif du passe (par ex.25.00). -
Devise (
currency) : sélectionnez votre devise de règlement (par ex.EUR,USD). -
Nom et description de l'article : saisissez l'intitulé affiché aux clients sur la page de paiement (par ex. « Adhésion Annuelle Salon VIP 2026 »).
-
Prestataires de paiement : cochez les passerelles connectées que vous souhaitez proposer (par ex. activer à la fois Stripe et PayPal).
Étape 4 : associer les métadonnées de paiement aux attributs du passe
Vous pouvez lier automatiquement les informations de confirmation de paiement à des champs personnalisés du passe :
-
Utilisez
{transactionId}pour enregistrer l'identifiant de référence de la passerelle de paiement. -
Utilisez
{amountPaid}pour afficher le prix d'achat du billet au verso du passe. -
Utilisez
{paymentDate}pour enregistrer l'horodatage de l'achat.
Étape 5 : publier & tester votre parcours
Ouvrez votre lien PassFlow public (/f/:slug) dans une fenêtre de navigation privée :
-
1
Saisissez des coordonnées client de test.
-
2
Effectuez un paiement de test à l'aide des cartes de test de votre passerelle ou des identifiants PayPal Sandbox.
-
3
Vérifiez que le passe est émis instantanément sur l'écran
PassStep.
Endpoints publics REST API de paiement
Si vous intégrez l'achat de passes directement dans votre propre application mobile, site web ou frontend React, vous pouvez appeler directement les endpoints publics de paiement PassFlow :
| Méthode | Chemin de l'endpoint | Description |
|---|---|---|
| GET | /api/v1/pass-flows/public/:url/payment-config | Retourne la configuration de paiement : passerelles activées, devise, montant et clés publiques API. |
| POST | /api/v1/pass-flows/public/:url/payment-intent | Crée un PaymentIntent Stripe et renvoie clientSecret pour Stripe Elements. |
| POST | /api/v1/pass-flows/public/:url/paypal-order | Crée une commande PayPal v2 et renvoie l'URL d'approbation PayPal. |
| POST | /api/v1/pass-flows/public/:url/paystack/initialize | Initialise une transaction Paystack et renvoie une URL d'autorisation. |
| POST | /api/v1/pass-flows/public/:url/mtn-momo/request-to-pay | Déclenche une demande de paiement push vers un numéro de téléphone MTN Mobile Money. |
Exemple : initialiser un Payment Intent Stripe
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"
}
}
Réponse (200 OK) :
{
"clientSecret": "pi_3Q9xZ2eZvKYlo2C11223344_secret_R1a2B3c4D5e6F7g8",
"publishableKey": "pk_live_51H...",
"amount": 4900,
"currency": "EUR",
"flowSessionId": "flow_sess_01j9x87k1"
}
Gestion des remboursements, litiges & révocation des passes
Lorsqu'un client demande un remboursement ou conteste un débit via Stripe ou PayPal :
-
1
Traitement automatique par webhook : Passinstance reçoit le webhook
charge.refundedouPAYMENT.CAPTURE.REFUNDED. -
2
Option de révocation du passe : dans Paramètres de l'espace de travail -> Paiements, vous pouvez définir votre politique automatisée en cas de remboursement :
- Invalidation automatique du passe (Recommandé) : définit pass.voided = true. Apple Wallet appose immédiatement un bandeau « Invalidé » sur le passe et barre le code-barres. Google Wallet marque le passe comme inactif. Les scanners rejettent toute tentative d'entrée ultérieure. - Conserver le passe : maintient le passe actif et consigne une entrée dans le journal d'audit pour vérification manuelle par vos équipes.
-
3
Alerte par notification push : lors de l'invalidation, Passinstance envoie une notification push APNs et Google Wallet informant le titulaire que son titre d'accès a été révoqué suite à un remboursement.
Documentation connexe
-
Vendre des abonnements — Adhésions récurrentes et synchronisation automatique des renouvellements.
-
Demander une signature API PayPal & des identifiants REST — Connecter les identifiants OAuth REST PayPal.
-
Distribution en libre-service — PassFlows, liens intelligents et inscription NFC.
-
Formulaires d'inscription & PassFlow — Configuration des étapes, protection anti-bot et validation des formulaires.
