Skip to content
Guide du centre d'aide · Distribution des passes
5 min de lectureVérifié 2026-11-16

Vendre des cartes

Monétisez les cartes de portefeuille numérique avec le paiement PassFlow en connectant Stripe, PayPal ou Paystack pour une émission instantanée après paiement.

Dans ce guide

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.

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE SYSTÈME : INSCRIPTION PAYANTE & ÉMISSION PAR WEBHOOK
ÉTAPE 01 NAVIGATEUR CLIENT (PASSFLOW /f/:slug)
1
FormStep : le client saisit nom, e-mail, téléphone et attributs perso.
2
OtpStep (Facultatif) : vérifie l'e-mail ou le mobile par code à 6 chiffres
3
PaymentStep : affiche prix, récapitulatif et modules de paiement intégrés
ÉTAPE 02 PASSERELLE DE PAIEMENT (STRIPE / PAYPAL / PAYSTACK)
Traite 3D-Secure 2, Apple Pay, Google Pay ou PayPal
Confirme le débit et émet l'événement de capture
ÉTAPE 03 MOTEUR WEBHOOK PAIEMENT & ÉMISSION PASSINSTANCE
Vérifie cryptographiquement la signature webhook (Stripe-Signature / PayPal)
Crée de façon idempotente la fiche Pass en base (statut ACTIVE)
Injecte les métadonnées (transactionId, amountPaid, currency) en attributs
ÉTAPE 04 AJOUT INSTANTANÉ AU PORTEFEUILLE (PASSSTEP)
Le client ajoute son passe via [Ajouter à Apple Wallet] / [Google Wallet]

Prestataires & rails de paiement pris en charge

Passinstance prend en charge des passerelles de paiement mondiales et régionales via IPublicPassFlowPaymentConfig :

PrestataireMoyens de paiement pris en chargeDevises prises en chargeIdéal pour
StripeCartes bancaires, Apple Pay, Google Pay, Prélèvement SEPA, iDEAL, BancontactPlus de 135 devises (EUR, USD, GBP, etc.)E-commerce international, portefeuilles mobiles et prélèvements européens
PayPalSolde PayPal, cartes bancaires, Paiement en 4X, VenmoPlus de 25 devises mondialesForte notoriété et paiement PayPal en un clic sans friction
PaystackCartes locales, virements bancaires, USSD, Apple PayNGN, GHS, ZAR, KESMarchés africains et opérations de paiement panafricaines
Mobile MoneyMTN MoMo, Orange Money, M-PesaDevises mobiles africaines localesInscription 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. 1
    Dans le tableau de bord, accédez à Paramètres -> Intégrations -> Paiements (/settings/integrations/payments).
  2. 2
    Cliquez sur Connecter (Connect) sur Stripe, PayPal ou Paystack.
  3. 3
    Renseignez vos clés API de production ou terminez le parcours d'onboarding OAuth.

Étape 2 : ouvrir le constructeur PassFlow

  1. 1
    Accédez à Passes -> PassFlows et sélectionnez le parcours lié à votre modèle (ou créez-en un nouveau).
  2. 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. 1
    Saisissez des coordonnées client de test.
  2. 2
    Effectuez un paiement de test à l'aide des cartes de test de votre passerelle ou des identifiants PayPal Sandbox.
  3. 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éthodeChemin de l'endpointDescription
GET/api/v1/pass-flows/public/:url/payment-configRetourne la configuration de paiement : passerelles activées, devise, montant et clés publiques API.
POST/api/v1/pass-flows/public/:url/payment-intentCrée un PaymentIntent Stripe et renvoie clientSecret pour Stripe Elements.
POST/api/v1/pass-flows/public/:url/paypal-orderCrée une commande PayPal v2 et renvoie l'URL d'approbation PayPal.
POST/api/v1/pass-flows/public/:url/paystack/initializeInitialise une transaction Paystack et renvoie une URL d'autorisation.
POST/api/v1/pass-flows/public/:url/mtn-momo/request-to-payDéclenche une demande de paiement push vers un numéro de téléphone MTN Mobile Money.

Exemple : initialiser un Payment Intent Stripe

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"
  }
}

Réponse (200 OK) :

JSON
{
  "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. 1
    Traitement automatique par webhook : Passinstance reçoit le webhook charge.refunded ou PAYMENT.CAPTURE.REFUNDED.
  2. 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.

  1. 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

Documentation produit et développeur associée

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.