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
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
SetupIntentavec authentification forte du client (3D-Secure 2 / DSP2 SCA) appliquée dans le navigateur avant que lepaymentMethodIdmis en coffre-fort ne soit confirmé auprès de l'API.
Rails de paiement pris en charge et points de terminaison
| Rail de paiement | Points de terminaison | Instruments et devises pris en charge |
|---|---|---|
| Lister les moyens enregistrés | GET /api/v1/billing/payment-methods | Renvoie 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 & SEPA | POST /api/v1/billing/payment-methods/stripe/setup-intentPOST /api/v1/billing/payment-methods/stripe/confirm | Mandats Visa, Mastercard, American Express et prélèvement SEPA avec authentification complète 3D-Secure 2 (SCA) en EUR et USD. |
| Accords de facturation PayPal | POST /api/v1/billing/payment-methods/paypal/setup-tokenPOST /api/v1/billing/payment-methods/paypal/confirm | Comptes PayPal professionnels ou d'entreprise mis en coffre-fort et autorisés pour la facturation récurrente d'abonnements. |
| Mobile Money | POST /api/v1/billing/payment-methods/mobile-money | Rails 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)
GET /api/v1/billing/payment-methods HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Charge utile de réponse (200 OK)
{
"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)
POST /api/v1/billing/payment-methods/stripe/setup-intent HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
{
"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 :
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"
}
{
"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/confirmavec{ setupTokenId }(request payload). -
Mobile Money (
POST /api/v1/billing/payment-methods/mobile-money) : Enregistre un rail de portefeuille mobile à l'aide derequest payload({ provider, phoneNumber, currency?, note? }) :
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
-
Relancez les factures ouvertes et téléchargez les reçus PDF dans Factures et historique de facturation.
-
Mettez à niveau votre forfait ou modifiez votre périodicité d'abonnement dans Modifications de forfait et résiliation.
-
Mettez à jour les adresses de facturation de l'entreprise et les numéros de TVA dans Paramètres de l'entreprise.
