Quellen und Kund/innenVeraltet
Achtung
Wir haben die Sources API eingestellt und beabsichtigen, die Unterstützung für lokale Zahlungsmethoden zu entfernen. Wenn Sie derzeit lokale Zahlungsmethoden über die Sources API abwickeln, müssen Sie diese auf die Payment Methods API umstellen. Wir werden Ihnen weitere Informationen zu diesem Thema per E-Mail mitteilen.
Wir werden die Unterstützung für Kartenzahlungen zwar nicht einstellen, wir empfehlen Ihnen aber dennoch, die Sources API durch die PaymentMethods API zu ersetzen. So haben Sie stets Zugang zu unseren neuesten Funktionen und Zahlungsmethoden.
Ein Objekt vom Typ Quelle kann entweder einmalig oder wiederverwendbar sein, wie durch seinen usage
-Parameter angegeben. Während Quellen direkt belastet werden können, sollten reusable sources zur späteren Wiederverwendung immer einem Objekt vom Typ Kunde/Kundin hinzugefügt werden. Durch das Hinzufügen von wiederverwendbaren Quellen zu Customer
-Objekten können Sie Ihren Kund/innen eine Liste wiederverwendbarer Zahlungsmethoden zur Verfügung stellen, die sie zuvor in Verbindung mit Ihrer App oder Website verwendet haben.
Wiederverwendbare Quellen
Bestimmte Zahlungsmethoden (beispielsweise SEPA-Lastschrift) unterstützen wiederverwendbare Quellen, sodass Sie weitere Zahlungen erstellen können, ohne dass Ihre Kund/innen den Zahlungsvorgang erneut durchführen müssen. Der Parameter usage
einer Quelle, die Sie wiederverwenden können, ist auf reusable
gesetzt.
Sie müssen einem Customer
-Objekt eine wiederverwendbare Quelle hinzufügen, bevor Sie eine Zahlungsanfrage stellen. Wenn Sie eine wiederverwendbare Quelle belasten, ohne sie zuvor hinzuzufügen, wird die Quelle verbraucht (ihr Status wechselt von chargeable
zu consumed
). Verbrauchte Quellen können nicht für zukünftige Zahlungen verwendet werden.
Hinzufügen einer Quelle zu einem neuen Kundenobjekt
Sie können in einem API-Aufruf ein Customer
-Objekt erstellen und eine Quelle hinzufügen. Dies ist nützlich, wenn Sie das erste Mal mit diesem Kunden/dieser Kundin zu tun haben.
Die Quelle wird zur Standardquelle des Customer
-Objekts, da dies die erste und einzige Zahlungsmethode des Kunden ist. Die Standardquelle wird automatisch ausgewählt, wenn Sie eine Zahlungsanfrage mit dem customer
-Parameter durchführen, ohne eine source
anzugeben.
Hinzufügen einer Quelle zu einem vorhandenen Kundenobjekt
Wenn Sie ein Customer
-Objekt aktualisieren, das über eine Standardquelle verfügt, wird die vorhandene Quelle automatisch getrennt, und die bereitgestellte Quelle wird als neue Standardquelle hinzugefügt. Um eine neue Quelle hinzuzufügen, ohne die vorhandene Standardquelle zu ersetzen, verwenden Sie die attach-Methode, wie unten dargestellt.
Da hier möglicherweise bereits eine Standardquelle für das Customer
-Objekt vorhanden ist, wird die neu hinzugefügte Quelle nicht zur Standardquelle. Sie können die Standardquelle jedoch ändern, indem Sie das Customer
-Objekt aktualisieren und die Quelle als Wert für default_source
angeben.
Belasten einer hinzugefügten Quelle
Wenn Sie eine Zahlungsanfrage durchführen, müssen Sie das Customer
-Objekt und die Quelle angeben.
Wenn Sie versuchen, ein Customer
-Objekt zu belasten, ohne eine Quelle anzugeben, verwendet Stripe stattdessen die Standardquelle des Kunden/der Kundin.
Trennen einer Quelle
Wenn Sie eine Quelle von einem bestimmten Customer
-Objekt entfernen müssen, können Sie die Quelle trennen. Dadurch wird der Status in consumed
geändert, und die Quelle kann nicht mehr verwendet werden, nachdem sie getrennt wurde.
Einmalige Quellen
Einmalige Quellen müssen jedes Mal erstellt werden, wenn ein Kunde/eine Kundin eine Zahlung vornimmt, und können nicht wiederverwendet werden. Daher empfehlen wir nicht, sie dauerhaft Kunden hinzuzufügen.
Wenn Sie eine Zahung einem bestimmten Customer
-Objekt zuordnen möchten, können Sie einen customer
-Parameter einschließen, wenn Sie eine Zahlungsanfrage mit einer Quelle durchführen, selbst wenn die Quelle nicht hinzugefügt wurde.
Das resultierende Charge
-Objekt verweist auf das Customer
- und das Source
-Objekt, auch wenn sie nicht direkt miteinander verbunden sind.