Connect-Plattformen, die die Payment Methods API nutzen
Inhaber/innen von Connect-Plattformen können zusätzliche Zahlungsmethoden nutzen, die in Verbindung mit der Payment Methods API unterstützt werden. Weitere Informationen zum Erstellen von Zahlungen für verbundene Nutzer/innen und welches Verfahren für Sie am besten geeignet ist, finden Sie in unserer Dokumentation zu Zahlungen und Gebühren für Connect.
Es gibt verschiedene Möglichkeiten, die Payment Methods API mit Connect zu verwenden, wenn Sie Direct Charges aktivieren.
Payment Method API mit Direct Charges verwenden
Für Direct Charges müssen PaymentMethods auf verbundenen Konten erstellt werden. Dazu müssen Sie zunächst die Zahlungsmethode aktivieren, die auf dem verbundenen Konto verwendet werden soll.
Eine PaymentMethod beim Bestätigen eines PaymentIntent erstellen und zuordnen
Für die Verwendung der Payment Method API mit Connect wird empfohlen, die Angaben zur Zahlungsmethode während der Bestätigung des Payment Intent zu speichern. Mehr Informationen zu diesem Verfahren finden Sie unter Karten im Zahlungsverlauf speichern.
Initialisieren Sie mit Stripe.js das Stripe-Objekt, legen Sie stripeAccount
auf die ID des verbundenen Kontos fest und verwenden Sie beim Bestätigen des PaymentIntent die Option setup_future_usage
. So werden die Zahlungsinformationen automatisch für die Kund/innen gespeichert und können bei künftigen Zahlungen mit dem verbundenen Konto wiederverwendet werden.
Mehr Informationen zum Bestätigen der einzelnen Zahlungsmethoden finden Sie unter PaymentIntents mit Stripe.js.
var stripe = Stripe(
, { stripeAccount:'pk_test_TYooMQauvdEDq54NiTphI7jx', }); (async () => { const {paymentIntent, error} = await stripe.confirmCardPayment( '{{PAYMENT_INTENT_CLIENT_SECRET}}', { payment_method: { card: card, billing_details: { name: 'Jenny Rosen' } }, setup_future_usage: 'off_session', } ); })();'{{CONNECTED_ACCOUNT_ID}}'
Wenn Sie PaymentIntents vom Server aus bestätigen, können Sie die Authentifizierung mit dem Header „Stripe-Account“ mit einer unserer unterstützten Bibliotheken durchführen. Mehr Informationen finden Sie unter PaymentIntent bestätigen.
PaymentMethods direkt für das verbundene Konto erstellen
Mit createPaymentMethod
können Sie eine PaymentMethod auch direkt für ein verbundenes Konto erstellen. Initialisieren Sie dazu mit Stripe.js das Stripe-Objekt und legen Sie stripeAccount
auf die ID des verbundenen Kontos fest.
// Set the connected Stripe Account on which the PaymentMethod should be created const stripe = Stripe(
, { stripeAccount:'pk_test_TYooMQauvdEDq54NiTphI7jx', }); (async () => { const {paymentMethod, error} = await stripe.createPaymentMethod({ type: 'card', card: cardElement, billing_details: { name: 'Jenny Rosen', }, }); // Handle error or paymentMethod })();'{{CONNECTED_ACCOUNT_ID}}'
Wenn Sie PaymentMethods vom Server aus erstellen, können Sie die Authentifizierung mit dem Header „Stripe-Account“ mit einer unserer unterstützten Bibliotheken durchführen.
PaymentMethods kopieren
Sie können auch PaymentMethods auf Ihrer Plattform erstellen und sie auf ein verbundenes Konto klonen, um Direct Charges zu erstellen. Das Klonen wird zurzeit für PaymentMethods unterstützt, deren type
entweder auf card
oder auf us_bank_account
festgelegt ist.
Nachdem Sie eine PaymentMethod erstellt und einer/einem Kund/in zugeordnet haben, können Sie dieses PaymentMethod auf einem verbundenen Konto mit der ID des verbundenen Kontos als Header Stripe-Account
kopieren. Erfahren Sie mehr über die Payment Methods API.
Wenn Sie PaymentMethods für ein verbundenes Konto wiederverwenden möchten, ordnen Sie diese den Kund/innen zu, bevor Sie sie mit PaymentIntents zum Erstellen von Zahlungen verwenden. Aus Sicherheitsgründen müssen Sie beim Kopieren von Kund/innen zugeordneten PaymentMethods die Kunden-ID in der Anfrage angeben.
Es besteht die Möglichkeit, PaymentMethods für verbundene Konten zu kopieren, ohne sie vorher Kund/innen zuzuordnen. Allerdings sollte beachtet werden, dass die ursprüngliche PaymentMethod anschließend nicht mehr verwendet werden kann, da nicht einer Kundin/einem Kunden zugeordnete PaymentMethods nur einmal verwendet werden können.