Payment Methods API

Mit der Payment Methods API können Sie eine Vielzahl von Zahlungsmethoden über eine einzige API annehmen. Ein PaymentMethod-Objekt enthält die Zahlungsmethodendetails, mit denen Sie Zahlungen erstellen können. Mit der Payment Methods API können Sie eine PaymentMethod mit Folgendem kombinieren:

• Mit einem PaymentIntent zur Annahme einer Zahlung
• Mit einem SetupIntent und einem/einer Kunden/Kundin, um Zahlungsdetails für später zu speichern

Unterstützte Zahlungsmethoden

Im Leitfaden zu Zahlungsmethoden finden Sie Informationen darüber, welche Zahlungsmethode an bestimmten Standorten verwendet werden soll.

In dem Leitfaden wird erklärt, welche Zahlungsmethoden in bestimmten Regionen verfügbar sind, er enthält eine detaillierte Beschreibung der Eigenschaften jeder Zahlungsmethode sowie die geografischen Regionen, in denen die jeweilige Zahlungsmethode am relevantesten ist. Sie können jede im Dashboard verfügbare Zahlungsmethode aktivieren. Die Aktivierung erfolgt in der Regel sofort und erfordert keine zusätzlichen Vereinbarungen.

Kundenaktionen

Für manche Zahlungsmethoden muss Ihr/e Kund/in zusätzliche Schritte ausführen, um die Zahlung abzuschließen. Der Parameter next_action des PaymentIntent-Objekts gibt die Art der erforderlichen Kundenaktion an.

Häufig müssen Kund/innen eine der folgenden Aktionen ausführen:

• Zum Onlinedienst ihrer Bank weiterleiten, um die Zahlung zu authentifizieren und zu genehmigen.
• Die Inhaberschaft ihres Kontos verifizieren, indem sie einen einmaligen Code angeben, den Sie an die Stripe-API senden (z. B. Mikroeinzahlungen).
• Geld über den Onlineservice ihrer Bank überweisen (z. B. bei Banküberweisungen).

Nicht für alle Zahlungsmethoden sind zusätzliche Kundenaktionen notwendig. Kartenzahlungen (abgesehen von 3D Secure) erfordern zum Beispiel keine zusätzliche Authentifizierung, die über das Erfassen von Kartendetails hinausgeht.

Sofortige oder verzögerte Benachrichtigung über den Zahlungserfolg

Manche Zahlungen geben bei einer versuchten Transaktion (z. B. Kartenzahlungen) sofort den Zahlungsstatus zurück. Bei anderen Methoden, wie ACH-Lastschriften, tritt hingegen eine Verzögerung auf. Für diejenigen, die den Zahlungsstatus sofort zurückgeben, ändert sich der PaymentIntent-Status entweder in succeeded oder requires_payment_method. Der Status succeeded garantiert, dass Sie das Geld von Ihren Kund/innen erhalten.

Zahlungsmethoden mit verzögerten Benachrichtigungen können die Zahlung während der Verzögerung nicht garantieren. Das PaymentIntent-Objekt befindet sich so lange im Status processing, bis der Zahlungsstatus entweder erfolgreich ist oder fehlschlägt. Es ist üblich, dass Unternehmen eine Bestellung während dieser Zeit im Status pending halten und diese erst dann ausführen, wenn die Zahlung erfolgreich ist.

Einmalig oder wiederverwendbar

Sie können bestimmte Zahlungsmethoden (zum Beispiel Karten oder Banklastschriften) für zusätzliche Zahlungen wiederverwenden, ohne die Zahlungsdaten erneut autorisieren und erfassen zu müssen.

Sie sollten immer wiederverwendbare Zahlungsmethoden für die zukünftige Verwendung einrichten, um die Wahrscheinlichkeit von zukünftigen Zahlungsablehnungen und Zahlungsproblemen zu verringern (z. B. Authentifizierung erforderlich). Wiederverwendbare Zahlungsmethoden können für die zukünftige Verwendung beim Annehmen einer Zahlung eingerichtet werden oder für die zukünftige Verwendung ohne Zahlungsannahme eingerichtet werden.

Zahlungsmethoden für einmalige Nutzung (beispielsweise einige Banküberweisungen) können nicht an Kund/innen angehängt werden, da sie nach einem Zahlungsversuch verbraucht sind.

Verwenden Sie Ereignisziele, um den Zahlungsstatus nachzuverfolgen

Konfigurieren Sie Ereignisziele für Zahlungsmethoden, die entweder Kundenaktionen erfordern oder für die die Zahlungsbenachrichtigung verzögert ist. Stripe sendet die folgenden Ereignisse, wenn der Status PaymentIntent aktualisiert wird:

Sie können auch die folgenden Optionen verwenden, statt ein Ereignisziel zum Abhören von Ereignissen einzurichten:

• Verfolgen Sie den Status von Zahlungen manuell im Dashboard, wenn Ihr Unternehmen ein geringes Auftragsvolumen von Zahlungsmethoden mit verzögerten Benachrichtigungen akzeptiert. Im Dashboard können Sie alle Ihre Stripe-Zahlungen anzeigen, E-Mail-Belege senden, Auszahlungen bearbeiten oder fehlgeschlagene Zahlungen wiederholen.
• Verwenden Abfragen (z. B. wiederholtes Abrufen eines PaymentIntent, damit Sie dessen Status überprüfen können). Beachten Sie, dass Abfragen wesentlich weniger verlässlich sind und möglicherweise nicht in großem Umfang funktionieren. Stripe setzt Ratenbegrenzungen für API-Anfragen um, verwenden Sie Abfragen daher mit Bedacht.
• Verwenden Sie eine Partneranwendung, um häufige Geschäftsereignisse, wie Automatisierung oder Marketing und Vertrieb durch Integration einer Partneranwendung zu handhaben.

Das PaymentMethod-Objekt

Eine PaymentMethod enthält Details zu wiederverwendbaren Zahlungsmethoden zum Erstellen von Zahlungen (z. B. Ablaufdatum der Karte oder Rechnungsadresse). Sie enthält keine transaktionsspezifischen Informationen (wie Betrag oder Währung). Eine PaymentMethod wird an einen PaymentIntent angehängt, um die Status eines Lebenszyklus von Zahlungen darzustellen. Jede PaymentMethod hat ein Typ-Attribut (z. B. "type": "sepa_debit") und einen zusätzlichen Hash, dessen Name dem Typ entspricht und der für den PaymentMethod-Typ spezifische Informationen enthält (z. B. "sepa_debit":{}). Beispiel für ein PaymentMethod-Objekt des Typs sepa_debit:

{
  "id": "pm_123456789",
  "object": "payment_method",
  "billing_details": {
    "address": {...},
    "email": "jenny@example.com",
    "name": "Jenny Rosen",
    "phone": "+335555555555"
  },
  "sepa_debit": {
    "bank_code": "37040044",
    "branch_code": "94832",
    "country": "FR",
    "fingerprint": "ygEJfUjzWMGyWnZg",
    "last4": "3000"
  },
  "type": "sepa_debit",
  (...)
}