Übersicht
Passinstance unterstützt eine anbieterübergreifende Orchestrierung von Zahlungsmethoden (Billing API unter /api/v1/billing/payment-methods* sowie unter Einstellungen -> Abrechnung -> Zahlungsmethode auf /settings/billing/payment-method). Dadurch können Workspaces Abonnements und Add-ons über payment method (CREDIT_CARD | PAYPAL | BANK_TRANSFER | GOOGLE_PAY | APPLE_PAY | STRIPE | CRYPTO | GIFT_CARD | MOBILE_MONEY) begleichen und Zahlungsabwicklungen über payment status (PENDING | COMPLETED | FAILED | CANCELLED | REFUNDED | PARTIALLY_REFUNDED | DISPUTED) nachverfolgen.
Zur strikten Einhaltung von PCI-DSS überträgt oder speichert Passinstance niemals unverschlüsselte Kartennummern (PAN) oder CVV-Sicherheitscodes auf Plattformservern – sämtliche sensiblen Zahlungsdaten werden über zweistufige SetupIntent- bzw. Setup-Token-Handshakes direkt beim jeweiligen Zahlungsdienstleister tokenisiert.
Anbieterübergreifende Architektur zur Zahlungs-Tokenisierung
Wichtig: Passinstance verarbeitet zu keinem Zeitpunkt unverschlüsselte Kreditkartennummern oder CVV-Werte. Alle Abläufe zur Kartenerfassung nutzen
SetupIntent-Client-Secrets von Stripe mit starker Kundenauthentifizierung (3D-Secure 2 / PSD2 SCA) direkt im Browser, bevor die im encrypted storage gespeichertepaymentMethodIdgegenüber der API bestätigt wird.
Unterstützte Zahlungswege & Endpunkte
| Zahlungsweg | Endpunkte | Unterstützte Zahlungsmittel & Währungen |
|---|---|---|
| Gespeicherte Methoden auflisten | GET /api/v1/billing/payment-methods | Gibt alle mit dem Workspace verknüpften, im encrypted storage gespeicherten Zahlungsmethoden zurück, einschließlich isDefault, Kartenmarke/letzte 4 Ziffern, Ablaufstatus oder PayPal-/Mobile-Money-Kennung. |
| Stripe-Karten & SEPA | POST /api/v1/billing/payment-methods/stripe/setup-intentPOST /api/v1/billing/payment-methods/stripe/confirm | Visa, Mastercard, American Express sowie SEPA-Lastschriftmandate mit vollständiger 3D-Secure-2-Authentifizierung (SCA) in EUR und USD. |
| PayPal-Abbuchungsvereinbarungen | POST /api/v1/billing/payment-methods/paypal/setup-tokenPOST /api/v1/billing/payment-methods/paypal/confirm | Im encrypted storage hinterlegte PayPal-Unternehmens- oder Geschäftskonten, die für wiederkehrende Abonnementabrechnungen autorisiert sind. |
| Mobile Money | POST /api/v1/billing/payment-methods/mobile-money | Regionale Mobile-Wallet-Zahlungswege (z. B. M-Pesa, MTN Mobile Money, Orange Money, Airtel Money) für unterstützte Workspaces in Wachstumsmärkten. |
API-Leitfaden: Zahlungsmethoden hinterlegen & bestätigen
1. Gespeicherte Zahlungsmethoden auflisten (GET /api/v1/billing/payment-methods)
GET /api/v1/billing/payment-methods HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Antwort-Payload (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. Zweistufige Stripe-3D-Secure-Kartenregistrierung
Schritt A: Einen Stripe SetupIntent erstellen (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..."
}
Schritt B: Die im encrypted storage gespeicherte Karte bestätigen (POST /api/v1/billing/payment-methods/stripe/confirm)
Nachdem Stripe Elements eine erforderliche 3D-Secure-2-Freigabe im Browser abgeschlossen hat, übergeben Sie das request payload ({ setupIntentId, paymentMethodId }), um die Karte dauerhaft für Ihren Workspace zu speichern:
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. Registrierung von PayPal-Abbuchungsvereinbarungen & Mobile Money
-
PayPal (
POST /api/v1/billing/payment-methods/paypal/setup-token->/confirm): Übermittelt{ returnUrl, cancelUrl }(request payload), um ein PayPal-encrypted storage-Token zu generieren, und ruft anschließend/paypal/confirmmit{ setupTokenId }(request payload) auf. -
Mobile Money (
POST /api/v1/billing/payment-methods/mobile-money): Registriert einen Mobile-Wallet-Zahlungsweg mithilfe desrequest 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"
}
Weiterführende Dokumentation
-
Wiederholen Sie die Zahlung offener Rechnungen und laden Sie PDF-Belege unter Rechnungen & Abrechnungshistorie herunter.
-
Führen Sie ein Tarif-Upgrade durch oder ändern Sie die Abrechnungsintervalle unter Tarifwechsel & Kündigung.
-
Aktualisieren Sie Ihre Rechnungsadresse und USt-IdNr. unter Unternehmenseinstellungen.
