Skip to content
Guide du centre d'aide · Facturation & paiements
3 min de lectureVérifié 2026-11-16

Moyens de paiement

Mettez à jour vos cartes bancaires ou mandats SEPA en toute sécurité via le portail client Stripe.

Dans ce guide

Présentation

Passinstance prend en charge l'orchestration multi-fournisseurs des moyens de paiement (Billing API sur /api/v1/billing/payment-methods* et sous Settings -> Billing -> Payment Method à l'adresse /settings/billing/payment-method), permettant aux espaces de travail de régler leurs abonnements et options complémentaires via payment method (CREDIT_CARD | PAYPAL | BANK_TRANSFER | GOOGLE_PAY | APPLE_PAY | STRIPE | CRYPTO | GIFT_CARD | MOBILE_MONEY) et de suivre les règlements via payment status (PENDING | COMPLETED | FAILED | CANCELLED | REFUNDED | PARTIALLY_REFUNDED | DISPUTED).

Pour maintenir une conformité PCI-DSS stricte, Passinstance ne transmet ni ne stocke jamais les numéros de carte bruts (PAN) ou les codes de sécurité CVV sur les serveurs de la plateforme — toutes les informations de paiement sensibles sont tokenisées directement auprès du processeur de paiement sous-jacent via des échanges en deux étapes SetupIntent / Setup-Token.

Architecture de tokenisation des paiements multi-fournisseurs

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE SYSTÈME : ORCHESTRATION MULTI-FOURNISSEURS DES PAIEMENTS
ÉTAPE 01 ADMINISTRATEUR DE FACTURATION DE L'ESPACE (CLIENT)
Sélectionne le rail : Carte Stripe (3DS2) | Accord PayPal | Mobile Money
ÉTAPE 02 POINTS D'ORCHESTRATION DE PAIEMENT (Billing API)
Stripe 3D-Secure
`POST/payment-methods
/stripe/setup-intent`
Le client valide 3DS2`POST/payment-methods
/stripe/confirm`
Coffre PayPal Express
`POST/payment-methods
/paypal/setup-token`
L'acheteur approuve`POST/payment-methods
/paypal/confirm`
Mobile Money
régionalPOST/payment- methods/mobile- money
Vérification mandat téléphone / OTP
ÉTAPE 03 REGISTRE DES MOYENS DE PAIEMENT ENREGISTRÉS (GET/payment-methods)
Stocke uniquement les métadonnées non sensibles (Marque, Last4, Exp, Email)
Utilisé automatiquement pour les renouvellements & POST/invoices/:id/pay

Important : Passinstance ne manipule jamais les numéros de carte bancaire bruts ni les valeurs CVV. Tous les flux d'enregistrement de carte utilisent des secrets clients Stripe SetupIntent avec authentification forte du client (3D-Secure 2 / DSP2 SCA) appliquée dans le navigateur avant que le paymentMethodId mis en coffre-fort ne soit confirmé auprès de l'API.

Rails de paiement pris en charge et points de terminaison

Rail de paiementPoints de terminaisonInstruments et devises pris en charge
Lister les moyens enregistrésGET /api/v1/billing/payment-methodsRenvoie tous les moyens de paiement enregistrés rattachés à l'espace de travail, en indiquant isDefault, la marque/les 4 derniers chiffres de la carte, la date d'expiration ou l'identifiant PayPal/Mobile Money.
Cartes Stripe & SEPAPOST /api/v1/billing/payment-methods/stripe/setup-intentPOST /api/v1/billing/payment-methods/stripe/confirmMandats Visa, Mastercard, American Express et prélèvement SEPA avec authentification complète 3D-Secure 2 (SCA) en EUR et USD.
Accords de facturation PayPalPOST /api/v1/billing/payment-methods/paypal/setup-tokenPOST /api/v1/billing/payment-methods/paypal/confirmComptes PayPal professionnels ou d'entreprise mis en coffre-fort et autorisés pour la facturation récurrente d'abonnements.
Mobile MoneyPOST /api/v1/billing/payment-methods/mobile-moneyRails de portefeuilles mobiles régionaux (par ex., M-Pesa, MTN Mobile Money, Orange Money, Airtel Money) pour les espaces de travail des marchés émergents pris en charge.

Guide de l'API : Enregistrement et confirmation des moyens de paiement

1. Lister les moyens de paiement enregistrés (GET /api/v1/billing/payment-methods)

HTTP
GET /api/v1/billing/payment-methods HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>

Charge utile de réponse (200 OK)

JSON
{
  "paymentMethods": [
    {
      "id": "pm_019331f0-9988-7a11-8b22-334455667788",
      "provider": "STRIPE",
      "type": "CARD",
      "brand": "visa",
      "last4": "4242",
      "expMonth": 8,
      "expYear": 2029,
      "isDefault": true,
      "createdAt": "2026-01-15T10:12:00.000Z"
    },
    {
      "id": "pm_01933205-4411-7c22-9d33-556677889900",
      "provider": "PAYPAL",
      "type": "PAYPAL_AGREEMENT",
      "email": "billing@phenix-hospitality.example.com",
      "isDefault": false,
      "createdAt": "2026-06-20T14:05:11.000Z"
    }
  ]
}

2. Enregistrement d'une carte Stripe 3D-Secure en deux étapes

Étape A : Créer un SetupIntent Stripe (POST /api/v1/billing/payment-methods/stripe/setup-intent)

HTTP
POST /api/v1/billing/payment-methods/stripe/setup-intent HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
JSON
{
  "setupIntentId": "seti_1Q9xYz2eZvKYlo2C99887766",
  "clientSecret": "seti_1Q9xYz2eZvKYlo2C99887766_secret_R1a2B3c4D5e6F7g8",
  "publishableKey": "pk_live_51H..."
}

Étape B : Confirmer la carte mise en coffre-fort (POST /api/v1/billing/payment-methods/stripe/confirm)

Une fois que Stripe Elements a terminé tout défi 3D-Secure 2 requis dans le navigateur, transmettez request payload ({ setupIntentId, paymentMethodId }) afin d'enregistrer la carte pour votre espace de travail :

HTTP
POST /api/v1/billing/payment-methods/stripe/confirm HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "setupIntentId": "seti_1Q9xYz2eZvKYlo2C99887766",
  "paymentMethodId": "pm_1Q9xZa2eZvKYlo2C11223344"
}
JSON
{
  "id": "pm_01933240-7766-7b00-8c11-990011223344",
  "provider": "STRIPE",
  "type": "CARD",
  "brand": "mastercard",
  "last4": "8819",
  "expMonth": 11,
  "expYear": 2030,
  "isDefault": true
}

3. Enregistrement d'un accord de facturation PayPal et Mobile Money

  • PayPal (POST /api/v1/billing/payment-methods/paypal/setup-token -> /confirm) : Soumet { returnUrl, cancelUrl } (request payload) pour générer un jeton PayPal encrypted storage, puis appelle /paypal/confirm avec { setupTokenId } (request payload).
  • Mobile Money (POST /api/v1/billing/payment-methods/mobile-money) : Enregistre un rail de portefeuille mobile à l'aide de request payload ({ provider, phoneNumber, currency?, note? }) :
HTTP
POST /api/v1/billing/payment-methods/mobile-money HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "provider": "MPESA",
  "phoneNumber": "+254712345678",
  "currency": "KES",
  "note": "Primary Kenya operations billing number"
}

Documentation connexe

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.