Share payment methods across multiple accounts for direct charges

Wenn Sie Direct Charges für mehrere verbundene Konten mit denselben gespeicherten Zahlungsinformationen erstellen müssen, verwenden Sie diesen Ansatz. Verwenden Sie andernfalls unseren Leitfaden zum Erstellen von Direct Charges.

Save payment details on your platform

Wenn Sie Zahlungsdetails von Ihrer Kundin/Ihrem Kunden erfassen, richten Sie diese für die zukünftige Verwendung ein und speichern Sie diese in Ihrem Plattformkonto. Sie müssen jede Zahlungsmethode nur einmal einrichten.

Create a customer on your platform

Verwenden Sie in Ihrem Plattformkonto die Customers API, um ein Kundenobjekt zu erstellen, das Ihre Kundin/Ihren Kunden repräsentiert.

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d name="Jenny Rosen"

Create a SetupIntent on your platform

Wenn Sie die kundenseitigen Angaben zur Zahlungsmethode erfassen, verwenden Sie die Setup Intents API zum Erstellen eines SetupIntent auf Ihrer Plattform und ordnen Sie diesen der Kundin/dem Kunden zu.

curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}}

Wenn sich Ihre Plattform in einem anderen Land befindet als Ihre verbundenen Konten, reicht die auf Ihrer Plattform durchgeführte Einrichtung möglicherweise nicht aus. Wenn sich Ihre Plattform beispielsweise in den USA befindet, löst der Einrichtungsvorgang möglicherweise in Ländern, die der Durchsetzung der starken Kundenauthentifizierung (SCA) unterliegen, keine Authentifizierung aus, die für Direct Charges erforderlich ist. Um sicherzustellen, dass Ihre Einrichtung die Anforderungen des Landes des verbundenen Kontos erfüllt, müssen Sie möglicherweise on_behalf_of verwenden, um ein verbundenes Konto in diesem Land anzugeben.

Confirm the SetupIntent

Senden Sie das client_secret des SetupIntent an Ihr Frontend und verwenden Sie unsere clientseitigen SDKs oder Nutzeroberflächenkomponenten, um Zahlungsdetails zu erfassen und den SetupIntent zu bestätigen. Sie können beispielsweise das Payment Element verwenden, um Zahlungsinformationen zu erfassen und den SetupIntent zu bestätigen.

Durch die Bestätigung auf dem Client kann die Kundin/der Kunde alle erforderlichen Abläufe durchlaufen, um ihre/seine Zahlungsdaten für die zukünftige Verwendung einzurichten, zum Beispiel die Authentifizierung mit 3D Secure.

A successful confirmation creates a PaymentMethod and attaches it to the customer for future use.

PaymentMethod klonen und Direct Charges auf verbundenen Konten erstellen

After you have a PaymentMethod set up for future use on your platform, clone it to a connected account and create a direct charge.

PaymentMethod auf die verbundenen Konten klonen

Verwenden Sie die Payment Methods API, um die auf Ihrem Plattformkonto gespeicherte PaymentMethod auf das gewünschte verbundene Konto zu klonen. Im Folgenden zeigen wir Ihnen dazu ein Beispiel. Geben Sie die ID des verbundenen Kontos als Stripe-Konto an und übergeben Sie die auf Ihrer Plattform gespeicherten IDs der Kundin/des Kunden und der Zahlungsmethode.

curl https://api.stripe.com/v1/payment_methods \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d customer=
{{PLATFORM_CUSTOMER_ID}} \
  -d payment_method=
{{PAYMENT_METHOD_ID}}

Die geklonte PaymentMethod ist ein unabhängiges Objekt mit einer einzigartigen ID. Sie wird nicht mit der PaymentMethod auf Ihrer Plattform verknüpft und wird nicht mit dieser synchronisiert. Die geklonte PaymentMethod übernimmt jedoch die auf Ihrem Plattformkonto durchgeführte Einrichtung. Sie müssen sie daher nicht erneut mit dem verbundenen Konto einrichten.

PaymentIntent für ein verbundene Konto erstellen und bestätigen

Verwenden Sie die Payment Intents API, um einen PaymentIntent für ein verbundenes Konto mit der geklonten PaymentMethod zu erstellen und zu bestätigen:

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d payment_method=
{{PAYMENT_METHOD_ID}} \
  -d currency=USD \
  -d amount=1099 \
  -d off_session=true \
  -d confirm=true

Wenn Sie eine Zahlung mit einer geklonten PaymentMethod erstellen, wird diese verbraucht, da sie nicht mit einer Kundin/einem Kunden verknüpft ist. Dieses Verbrauchen hat jedoch keine Auswirkungen auf die auf Ihrer Plattform gespeicherte ursprüngliche Zahlungsmethode. Sie können den verbrauchten Klon nicht wiederverwenden, Sie können allerdings die PaymentMethod der Plattform erneut klonen und den neuen Klon für eine andere Zahlung verwenden.

Wiederkehrende Zahlungen in einem verbundenen Konto einrichten

Um eine geklonte PaymentMethod für wiederkehrende Direct Charges in einem verbundenen Konto zu verwenden, müssen Sie ein Kundenobjekt im verbundenen Konto erstellen und die geklonte Zahlungsmethode daran anhängen. Anstatt dann PaymentIntents zu erstellen, erstellen Sie ein Abonnement mit der geklonten PaymentMethod und dem angehängten Kundenobjekt.

Handle customer and payment updates

Wenn Sie keine wiederkehrenden Zahlungen einziehen, müssen Sie nur die Kundin/den Kunden und die PaymentMethod in Ihrem Plattformkonto aktualisieren. Sie klonen die PaymentMethod für jede Direct Charge. Dadurch wird sichergestellt, dass Sie immer die neueste Version verwenden. Die Kundin/der Kunde existiert nur auf Ihrem Plattformkonto, Sie müssen daher keine Kundendaten über mehrere Konten hinweg synchronisieren.

Wenn Sie wiederkehrende Zahlungen einziehen und die Kundin/den Kunden oder die Zahlungsmethode auf Ihrem Plattformkonto aktualisieren, müssen Sie auch die entsprechenden Objekte aktualisieren, die bei den verbundenen Konten gespeichert sind. Wenn Sie die ursprüngliche PaymentMethod auf Ihrer Plattform aktualisieren, klonen Sie diese erneut und verknüpfen den neuen Klon mit der Kundin/dem Kunden und dem Abonnement für das verbundene Konto. Diesen Vorgang wiederholen Sie für jedes verbundene Konto, für das ein Klon für wiederkehrende Zahlungen hinterlegt ist.