Quellen und Kund/innenVeraltet

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 Kundin/Kunde hinzugefügt werden. Durch das Hinzufügen von wiederverwendbaren Quellen zu Customer-Objekten können Sie Ihren Kundinnen/Kunden 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 Kundinnen/Kunden 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.

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  --data-urlencode email="paying.user@example.com" \
  -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

Die Quelle wird zur Standardquelle des Customer-Objekts, da dies die erste und einzige Zahlungsmethode der Kundin/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.

curl https://api.stripe.com/v1/customers/cus_AFGbOSiITuJVDs/sources \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "source"="src_18eYalAHEMiOZZp1l9ZTjSU0"

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.

curl https://api.stripe.com/v1/customers/cus_AFGbOSiITuJVDs \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d default_source=src_18eYalAHEMiOZZp1l9ZTjSU0

Belasten einer hinzugefügten Quelle

Wenn Sie eine Zahlungsanfrage durchführen, müssen Sie das Customer-Objekt und die Quelle angeben.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d amount="1099" \
  -d currency="eur" \
  -d customer=cus_AFGbOSiITuJVDs \
  -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

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.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d amount="1099" \
  -d currency="eur" \
  -d customer=cus_AFGbOSiITuJVDs \
  -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

Das resultierende Charge-Objekt verweist auf das Customer- und das Source-Objekt, auch wenn sie nicht direkt miteinander verbunden sind.