Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case finden
Zahlungsmethoden
Payment interfaces
Payment scenarios
Persönliche Zahlungen
Terminal
Other Stripe products

Terminal mit Connect verwenden

Vernetzen Sie Stripe Terminal mit Ihrer Connect-Plattform.

Stripe Terminal ist vollständig kompatibel mit Stripe Connect und ermöglicht es Ihrer Plattform oder Ihrem Marktplatz, persönliche Zahlungen anzunehmen.

Die Art und Weise, wie Terminal-API-Objekte erstellt, richtet sich danach, ob Sie Direct Charges oder Destination Charges verwenden. Wenn Sie Direct Charges verwenden, gehören alle Terminal-API-Objekte im Zusammenhang mit einer Zahlung zu verbundenen Konten, während Lesegerät möglicherweise entweder zum verbundenen Konto oder zu der Plattform gehören. Wenn Sie Destination Charges verwenden, werden alle Terminal-API-Objekte in Ihrem Plattformkonto erstellt. Verwenden Sie in beiden Fällen Standorte, um Lesegeräte nach Belieben zu gruppieren.

Notiz

Terminal Connect-Konten müssen die Funktion card_payments aufweisen, um Transaktionen durchführen zu können.

Direct Charges

Verbundene Konten besitzen Lesegeräte

Bei Verwendung dieser Integration gehören alle API-Objekte zum verbundenen Konto und nicht zur Plattform. Das verbundene Konto ist für die Kosten von Stripe-Gebühren, -Rückerstattungen und -Rückbuchungen verantwortlich.

Im Dashboard können Sie Ihre Terminal-Daten anzeigen, indem Sie sich als verbundenes Konto anmelden.

Standorte und Lesegeräte erstellen Serverseitig

Erstellen Sie Terminal API-Objekte wie Standorte und Lesegeräte, die zu demselben verbundenen Konto gehören, dem die Zahlung gehört.

Zum Erstellen eines Standorts, der zu einem verbundenen Konto gehört, verwenden Sie den Stripe-Account-Header.

Command Line
curl https://api.stripe.com/v1/terminal/locations \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d display_name=HQ \
  -d "address[line1]"="1272 Valencia Street" \
  -d "address[city]"="San Francisco" \
  -d "address[state]"=CA \
  -d "address[country]"=US \
  -d "address[postal_code]"=94110

Bevor Sie Ihre Anwendung mit einem intelligenten Lesegerät verbinden können, müssen Sie das Lesegerät bei einem Stripe-Konto registrieren. Um ein Lesegerät bei einem verbundenen Konto zu registrieren, verwenden Sie den Header Stripe-Account.

Command Line
curl https://api.stripe.com/v1/terminal/readers \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d registration_code={{READER_REGISTRATION_CODE}} \
  --data-urlencode label="Alice's reader" \
  -d location=
{{LOCATION_ID}}

Verbindungstoken erstellen Serverseitig

Notiz

Bei Verwendung der Connect OAuth-Authentifizierung muss das verbundene Konto separat für den Live-Modus und den Testmodus autorisiert werden, wobei die jeweilige Client-ID der Anwendung für jeden Modus verwendet wird.

Bei der Erstellung eines ConnectionToken für das Terminal SDK setzen Sie den Stripe-Account-Header auf das verbundene Konto, das Zahlungen annimmt. Sie können auch einen location-Parameter angeben, um den Zugriff auf Lesegeräte einzuschränken. Wenn Sie einen Standort angeben, kann der ConnectionToken nur mit Lesegeräten verwendet werden, die diesem Standort zugeordnet sind. Wenn Sie keinen Standort angeben, kann das ConnectionToken mit allen Lesegeräten verwendet werden.

Command Line
curl https://api.stripe.com/v1/terminal/connection_tokens \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d location=
{{LOCATION_ID}}

PaymentIntents erstellen Client-side Server-side

Mit dem iOS, Android und React Native SDK können Sie einen PaymentIntent auf dem Client oder auf dem Server erstellen. Das JavaScript SDK unterstützt nur die Erstellung auf dem Server.

Clientseitig

Wenn Sie einen PaymentIntent für Direct Charges clientseitig erstellen, müssen Sie keine zusätzlichen Parameter für den PaymentIntent angeben. Setzen Sie stattdessen beim Erstellen eines ConnectionToken den Stripe-Account-Header auf das verbundene Konto, das Zahlungen annimmt. Die Client-SDKs erstellen den PaymentIntent für dasselbe verbundene Konto, zu dem das ConnectionToken gehört. Weitere Informationen finden Sie unter Payment Intents clientseitig erstellen.

Serverseitig

Für das JavaScript SDK müssen Sie den PaymentIntent auf Ihrem Server erstellen. Für die anderen Client-SDKs können Sie den PaymentIntent auf Ihrem Server erstellen, wenn die zum Starten einer Zahlung erforderlichen Informationen in Ihrer App nicht ohne weiteres verfügbar sind. Weitere Informationen finden Sie unter Payment Intents serverseitig erstellen.

Wenn Sie einen PaymentIntent auf der Server-Seite für Direct Charges erstellen, setzen Sie den Stripe-Account-Header auf das verbundene Konto.

Command Line
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card_present \
  -d capture_method=manual

Plattform besitzt Lesegeräte

Notiz

Contact us if you’re interested in letting the platform own and manage readers with direct charges. This private preview feature is currently available for smart readers leveraging a server-driven integration. This integration works only with connected accounts that you control through a single platform.

Mit dieser Integration gehören Geräteverwaltungsressourcen wie Standorte und Lesegeräte zum Plattformkonto, während Zahlungsressourcen wie PaymentIntents zum verbundenen Konto gehören. Dies ermöglicht es einem einzelnen Lesegerät, das von der Plattform verwaltet wird, Zahlungen für mehrere verschiedene verbundene Konten zu verarbeiten. Das verbundene Konto ist für die Kosten der Stripe-Gebühren, Rückerstattungen und Rückbuchungen verantwortlich.

Im Dashboard können Sie Ihre Terminal-Geräteverwaltungsdaten direkt anzeigen, wenn Sie bei Ihrem Plattformkonto angemeldet sind. Sie können Zahlungsdaten anzeigen, indem Sie sich als verbundenes Konto anmelden.

Standorte und Lesegeräte erstellen

Reader-Objekte lassen sich am besten nach verbundenem Konto gruppieren, indem sie Locations zugewiesen werden. Erstellen Sie in Ihrem Plattformkonto einen Ort für ein verbundenes Konto mit einem Anzeigenamen, der das Konto kennzeichnet.

Command Line
curl https://api.stripe.com/v1/terminal/locations \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d display_name=HQ \
  -d "address[line1]"="1272 Valencia Street" \
  -d "address[city]"="San Francisco" \
  -d "address[state]"=CA \
  -d "address[country]"=US \
  -d "address[postal_code]"=94110

Bevor Sie Ihre Anwendung mit einem intelligenten Lesegerät verbinden können, müssen Sie das Lesegerät bei Ihrem Plattformkonto registrieren.

Command Line
curl https://api.stripe.com/v1/terminal/readers \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d registration_code={{READER_REGISTRATION_CODE}} \
  --data-urlencode label="Alice's reader" \
  -d location=
{{LOCATION_ID}}

PaymentIntents erstellen

Wenn Sie einen PaymentIntent für Direct Charges erstellen, setzen Sie den Stripe-Account-Header auf das verbundene Konto.

Notiz

The platform can only process PaymentIntents later if you create them for connected accounts that you control through a single platform.

Command Line
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card_present \
  -d capture_method=manual

PaymentIntents verarbeiten

Die Plattform kann den PaymentIntent des verbundenen Kontos mit einem Lesegerät verarbeiten, das der Plattform gehört.

Notiz

The PaymentIntent can only be processed if you create it using the Stripe-Account header.

Command Line
curl https://api.stripe.com/v1/terminal/readers/
{{READER_ID}}
/process_payment_intent \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d payment_intent=
{{PAYMENT_INTENT_ID}}

Destination Charges

Wenn Sie Destination Charges verwenden, gehören API-Ressourcen wie PaymentIntents und Standorte zu Ihrem Plattformkonto. Jede Zahlung erstellt automatisch einen Transfer zu einem verbundenen Konto.

Im Dashboard können Sie Ihre Terminal-Daten direkt anzeigen, wenn Sie bei Ihrem Plattformkonto angemeldet sind.

Standorte und Lesegeräte erstellen Serverseitig

Reader-Objekte lassen sich am besten nach verbundenem Konto gruppieren, indem sie Locations zugewiesen werden. Erstellen Sie in Ihrem Plattformkonto einen Ort für ein verbundenes Konto mit einem Anzeigenamen, der das Konto kennzeichnet.

Command Line
curl https://api.stripe.com/v1/terminal/locations \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d display_name=HQ \
  -d "address[line1]"="1272 Valencia Street" \
  -d "address[city]"="San Francisco" \
  -d "address[state]"=CA \
  -d "address[country]"=US \
  -d "address[postal_code]"=94110

Bevor Sie Ihre Anwendung mit einem intelligenten Lesegerät verbinden können, müssen Sie das Lesegerät bei Ihrem Plattformkonto registrieren.

Command Line
curl https://api.stripe.com/v1/terminal/readers \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d registration_code={{READER_REGISTRATION_CODE}} \
  --data-urlencode label="Alice's reader" \
  -d location=
{{LOCATION_ID}}

Verbindungstoken erstellen Serverseitig

Verwenden Sie den geheimen Schlüssel Ihres Plattformkontos, wenn Sie einen ConnectionToken für das Terminal SDK erstellen. Legen Sie den Stripe-Account-Header nicht fest. Geben Sie einen location-Parameter an, um den Zugriff auf Lesegeräte zu steuern. Wenn Sie einen Ort angeben, kann der ConnectionToken nur mit Lesegeräten verwendet werden, die diesem Ort zugewiesen sind. Wenn Sie keinen Ort angeben, kann der ConnectionToken mit allen Lesegeräten verwendet werden.

Command Line
curl https://api.stripe.com/v1/terminal/connection_tokens \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d location=
{{LOCATION_ID}}

PaymentIntents erstellen Client-side Server-side

Wenn Sie einen PaymentIntent mit Destination Charges erstellen, geben Sie die Parameter on_behalf_of und transfer_data[destination] und application_fee_amount an.

Der Parameter on_behalf_of ist die ID des verbundenen Kontos, das zum Abwicklungshändler für die Zahlung wird. Bei Terminal-Transaktionen muss dieser Parameter in Fällen festgelegt werden, bei denen das Land der Plattform nicht mit dem Land des Connect-Kontos übereinstimmt. Wenn on_behalf_of festgelegt ist, führt Stripe automatisch Folgendes durch:

  • Begleicht die Zahlungen im Land des angegebenen Kontos. Dadurch werden Ablehnungen minimiert und Währungsumrechnungen vermieden.
  • Verwendet die Gebührenstruktur für das Land des verbundenen Kontos.
  • Listet die Adresse und die Telefonnummer des verbundenen Kontos auf der Kreditkartenabrechnung des/der Kund/in auf, und nicht die Adresse und die Telefonnummer der Plattform (nur, wenn sich das Konto und die Plattform in verschiedenen Ländern befinden).

Legen Sie für transfer_data[destination] die ID des verbundenen Kontos fest, an das der Betrag gesendet wird.

Abschließend können Sie eine Plattformgebühr für Ihre Plattform einbehalten, indem Sie den Parameter application_fee_amount angeben.

Clientseitig

Mit den SDKs für iOS, Android und React Native können Sie einen PaymentIntent auf dem Client erstellen und die Parameter onBehalfOf, transferDataDestination und applicationFeeAmount angeben.

Notiz

Client-side PaymentIntent creation is possible with the other SDKs. If you’re using the JavaScript SDK for Stripe Terminal, create a PaymentIntent server-side.

Serverseitig

Für das JavaScript SDK müssen Sie den PaymentIntent auf Ihrem Server erstellen. Für die anderen Client-SDKs können Sie den PaymentIntent auf Ihrem Server erstellen, wenn die zum Starten einer Zahlung erforderlichen Informationen in Ihrer App nicht ohne weiteres verfügbar sind. Weitere Informationen finden Sie unter Payment Intents serverseitig erstellen.

Command Line
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card_present \
  -d capture_method=manual \
  -d application_fee_amount=200 \
  -d on_behalf_of=
{{CONNECTED_ACCOUNT_ID}}
 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Siehe auch

War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unseren Produkt-Changelog an.
Fragen? Sales-Team kontaktieren.
Unterstützt von Markdoc
Auf dieser Seite
Direct Charges
Verbundene Konten besitzen Lesegeräte
Plattform besitzt Lesegeräte
Destination Charges
Standorte und Lesegeräte erstellen
Verbindungstoken erstellen
PaymentIntents erstellen
Siehe auch
Verwendete Produkte
Terminal
Connect