Skip to content
Hilfecenter-Anleitung · Abrechnung & Zahlungen
3 Min. LesezeitGeprüft 2026-11-16

Zahlungsmethoden

Verwalten Sie Kredit-/Debitkarten oder SEPA-Mandate sicher direkt über das angebundene Stripe-Kundenportal.

In dieser Anleitung

Ü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

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
ANBIETERÜBERGREIFENDE ZAHLUNGSMETHODEN-ORCHESTRIERUNG
STUFE 01 WORKSPACE-ABRECHNUNGSADMINISTRATOR (CLIENT)
Wählt Zahlungsweg: Stripe-Karte (3DS2) | PayPal-Vereinbarung | Mobile Money
STUFE 02 ZAHLUNGSORCHESTRIERUNGS-ENDPUNKTE (Billing API)
Stripe 3D-Secure
`POST/payment-methods
/stripe/setup-intent`
Client führt 3DS2 aus`POST/payment-methods
/stripe/confirm`
PayPal Saved Billing
`POST/payment-methods
/paypal/setup-token`
Käufer bestätigt Mandat`POST/payment-methods
/paypal/confirm`
Regionales Mobile
MoneyPOST/payment- methods/mobile- money
Telefon-/OTP-Mandat
Verifizierung
STUFE 03 REGISTER GESPEICHERTER ZAHLUNGSMETHODEN (GET/payment-methods)
Speichert nur nicht-sensible Metadaten (Marke, Last4, Ablauf, PayPal-E-Mail)
Wird automatisch für Abo-Verlängerungen & POST/invoices/:id/pay genutzt

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 gespeicherte paymentMethodId gegenüber der API bestätigt wird.

Unterstützte Zahlungswege & Endpunkte

ZahlungswegEndpunkteUnterstützte Zahlungsmittel & Währungen
Gespeicherte Methoden auflistenGET /api/v1/billing/payment-methodsGibt 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 & SEPAPOST /api/v1/billing/payment-methods/stripe/setup-intentPOST /api/v1/billing/payment-methods/stripe/confirmVisa, Mastercard, American Express sowie SEPA-Lastschriftmandate mit vollständiger 3D-Secure-2-Authentifizierung (SCA) in EUR und USD.
PayPal-AbbuchungsvereinbarungenPOST /api/v1/billing/payment-methods/paypal/setup-tokenPOST /api/v1/billing/payment-methods/paypal/confirmIm encrypted storage hinterlegte PayPal-Unternehmens- oder Geschäftskonten, die für wiederkehrende Abonnementabrechnungen autorisiert sind.
Mobile MoneyPOST /api/v1/billing/payment-methods/mobile-moneyRegionale 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)

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

Antwort-Payload (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. Zweistufige Stripe-3D-Secure-Kartenregistrierung

Schritt A: Einen Stripe SetupIntent erstellen (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..."
}

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:

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. 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/confirm mit { setupTokenId } (request payload) auf.
  • Mobile Money (POST /api/v1/billing/payment-methods/mobile-money): Registriert einen Mobile-Wallet-Zahlungsweg mithilfe des 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"
}

Weiterführende Dokumentation

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.