Die Sources-APIVeraltet

Lernen Sie die verschiedenen Zahlungsmethoden und -mechanismen kennen, die über die Sources-API verfügbar sind.

Achtung

We deprecated the Sources API and plan to remove support for local payment methods. If you currently handle any local payment methods using the Sources API, you must migrate them to the Payment Methods API.

Obwohl wir nicht beabsichtigen, die Unterstützung für Kartenzahlungen zu entfernen, empfehlen wir, die Sources API durch die PaymentMethods API zu ersetzen, die Zugriff auf unsere neuesten Funktionen und Zahlungsmethoden bietet.

Mit Quellobjekten können Sie eine Vielzahl von Zahlungsmethoden mit einer einzigen API akzeptieren. Bei einer Quelle handelt es sich um das Zahlungsinstrument eines Kunden/einer Kundin, das mit der Stripe-API verwendet werden kann, um Zahlungen zu erstellen. Quellen können direkt belastet werden oder Kundinnen/Kunden zur späteren Wiederverwendung hinzugefügt werden.

Jede von der Sources-API unterstützte Zahlungsmethode ist durch vier wesentliche Merkmale definiert. Die Kombination dieser Merkmale bestimmt, wie eine Quelle abrechenbar gemacht wird und wie sie in einer Zahlungsanfrage verwendet wird, um eine Zahlung durchzuführen.

Pull oder Push: Die Art und Weise, wie die Gelder für die Zahlungsmethode von Ihrem Kunden/Ihrer Kundin übertragen werden
Ablauf: Die Art der Aktion, die Ihr Kunde/Ihre Kundin durchführen muss, um die Zahlung zu authentifizieren
Nutzung: Ob die Source wiederverwendbar ist oder nicht
Synchron oder asynchron: Ob die resultierende Abbuchung sofort oder erst nach einer Verzögerung bestätigt werden kann

Ein vollständiges Beispiel, in dem dargestellt ist, wie jede Zahlungsmethode mit der Sources-API akzeptiert werden kann, finden Sie in diesem Beispiel-E-Commerce-Shop. Zudem können Sie den Quellcode auf GitHub durchsuchen.

Unterstützte Zahlungsmethoden

Sie können jede Ihnen zur Verfügung stehende Zahlungsmethode im Dashboard aktivieren. Die Aktivierung erfolgt normalerweise sofort. Es sind weder zusätzliche Verträge erforderlich, noch muss ein langwieriger Prozess durchlaufen werden. Hier finden Sie eine detaillierte Auflistung der verfügbaren Zahlungsmethoden und ihrer unterstützten geografischen Regionen.

In der folgenden Tabelle werden die oben genannten Hauptmerkmale den unterstützten Zahlungsmethoden zugeordnet:

Übertragung	Bestätigung	Keine	Weiterleitung	Code-Verifizierung	Empfänger
Pull	Synchron	Karten	–	–	–
Pull	Asynchron	SEPA-Lastschriftverfahren (veraltet)	ACH-Lastschriften mit Authentifizierung	ACH-Lastschriften mit Mikroeinzahlungen	–
Push	Synchron	Alipay (veraltet) Bancontact (veraltet) giropay (veraltet) iDEAL (veraltet) Przelewy24 (veraltet) WeChat Pay (veraltet)	–	–	Multibanco (veraltet)
Push	Asynchron	–	Sofort mit Sources (eingestellt)	–	–

Pull- oder Push-Übertragung von Geldern

Jede Zahlungsmethode wird entweder als Pull- oder Push-Methode kategorisiert, je nachdem, wie Gelder durch die Zahlungsmethode der Kund/innen übertragen werden.

Bei einer pull method werden die Gelder vom Konto der Kundin/des Kunden abgebucht, nachdem diese/r seine/ihre Zustimmung erteilt hat. Kartenzahlungen sind ein Beispiel für eine Pull-Methode: die Karte Ihrer Kundin/Ihres Kunden wird bei einer Zahlung belastet, und für nachfolgende Abbuchungen ist keine Kundeninteraktion erforderlich.
Bei einer push method sendet die Kundin/der Kunde die Gelder an Sie. ACH-Überweisungen sind ein Beispiel für eine Push-Methode: Ihre Kundin/Ihr Kunde erhält eine Routingnummer und eine Kontonummer, an die der korrekte Betrag gesendet werden (Push) soll. Sobald bestätigt ist, dass die Kundin/der Kunde die Gelder an Sie gesendet hat, kann die Quelle belastet und in einer Zahlungsanfrage verwendet werden. Andere Push-Zahlungsmethoden wie z. B. iDEAL oder Sofort beruhen auf einer Weiterleitung, über das Geld kundenseitig direkt mittels Push-Verfahren von einem Online-Bankkonto an Sie gesendet wird. Im Allgemeinen erfordern Push-Methoden für jede Zahlung eine Kundeninteraktion.

Ablauf für Kundenaktion

Bei bestimmten Zahlungsmethoden muss Ihr Kunde/Ihre Kundin eine bestimmte Aktion (Ablauf) durchführen, bevor die Quelle belastet werden kann. Der Typ des Ablaufs, der für eine Zahlungsmethode gilt, ist im Parameter flow des Source-Objekts angegeben. Jede Methode wird als einer der folgenden Ablauftypen eingestuft.

Es ist keine Aktion von Ihren Kund/innen erforderlich. Einige Zahlungsmethoden (in der Regel pull methods), wie z. B. Karten (ausgenommen 3D Secure) erfordern keine zusätzliche Authentifizierung über die Erfassung von Zahlungsinformationen von Kund/innen hinaus. Quellen, die diese Zahlungsmethode repräsentieren, können bei Zahlungsanfragen sofort verwendet werden.

Sobald der erforderliche Ablauf abgeschlossen ist und eine Quelle abrechenbar wird, muss die Quelle verwendet werden, um eine Zahlungsanfrage zu stellen, damit die Zahlung abgeschlossen werden kann. Andernfalls wird die Quelle storniert, und die authentifizierte Zahlung des Kunden/der Kundin wird automatisch rückerstattet – es wird kein Geld auf Ihr Konto überwiesen.

Einmalig oder wiederverwendbar

Bei bestimmten Zahlungsmethoden können Quellen erstellt werden, die für weitere Zahlungen wiederverwendet werden können, ohne dass Ihr Kunde/Ihre Kundin den Zahlungsvorgang erneut durchführen muss. Bei Quellen, die wiederverwendet werden können, ist der Parameter usage auf reusable gesetzt.

Wenn eine Quelle nur einmal verwendet werden kann, wird dieser Parameter hingegen auf single_use gesetzt, und es muss jedes Mal eine Quelle erstellt werden, wenn ein Kunde/eine Kundin eine Zahlung vornimmt. Solche Quellen sollten Kunden nicht hinzugefügt werden, sondern sie sollten stattdessen direkt belastet werden. Sie können nur einmal belastet werden, und ihr Status ändert sich nach der Belastung in consumed.

Wiederverwendbare Quellen müssen Kundinnen/Kunden hinzugefügt werden, damit sie wiederverwendet werden können. (Wenn sie direkt belastet werden, ändert sich ihr Status in consumed.) Informationen dazu, wie Sie Quellen zu Kundinnen/Kunden hinzufügen und wie Sie die Liste der Quellen einer Kundin/eines Kunden verwalten, finden Sie im Leitfaden zu Quellen und Kundinnen/Kunden.

Synchrone oder asynchrone Bestätigung

Sobald Sie eine Zahlungsmethode verwenden, um ein Objekt vom Typ Zahlung zu erstellen, kann der Status dieser Zahlung entweder sofort (synchron) oder nach einem bestimmten Zeitraum (asynchron) bestätigt werden.

Bei einer synchronen Zahlungsmethode kann der Status der Zahlungsanfrage sofort als succeeded oder failed bestätigt werden. Wenn die Zahlungsanfrage erfolgreich ist, ist die Zahlung abgeschlossen – es gilt als garantiert, dass der Kunde/die Kundin belastet wurde und dass Sie die Gelder erhalten. Kartenzahlungen sind ein Beispiel für eine synchrone Zahlungsmethode: Erfolg oder Misserfolg der Zahlung wird in Echtzeit bestätigt.
Bei asynchronen Zahlungsmethoden kann es mehrere Tage dauern, bis bestätigt wird, ob die Zahlung erfolgreich war. Während dieses Zeitraums kann die Zahlung nicht garantiert werden. Der Status des Charge-Objekts der Zahlung wird anfangs auf pending gesetzt, bis die Zahlung als erfolgreich oder fehlgeschlagen bestätigt wurde. ACH-Lastschriften sind ein Beispiel für eine asynchrone Methode. Bei diesen Lastschriften dauert es einige Tage, bis bestätigt wird, dass die Zahlung erfolgreich war.

Stripe sendet ein Webhook-Ereignis, sobald sich der Status einer Abbuchung geändert hat. Wenn Sie eine asynchrone Zahlungsmethode akzeptieren, muss Ihre Integration Webhooks empfangen können, damit diese Benachrichtigung empfangen wird und bestätigt werden kann, ob die Zahlung des Kunden/der Kundin erfolgreich war oder fehlgeschlagen ist.