Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenVerwenden Sie Managed Payments
Präsenzzahlungen
Terminal
Zahlungsmethoden
Zahlungsszenarien
Mehr als Zahlungen

Terminal mit Connect verwenden

Vernetzen Sie Stripe Terminal mit Ihrer Connect-Plattform.

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

integrieren Sie Terminal mit Connect, je nachdem, wie Ihre Plattform Zahlungen für Ihre verbundenen Konten verarbeitet.

  • Wenn Sie Direct Charges verwenden, übermitteln Sie Terminal-API-Anfragen, um Lesegeräte zu konfigurieren und Zahlungen mit dem API Schlüssel des verbundenen Kontos zu akzeptieren. Ihre Plattform kann den Header Stripe-Account verwenden, um das verbundene Konto zu identifizieren und seinen API-Schlüssel zu verwenden.
  • Wenn Sie Destination Charges verwenden, übermitteln Sie Terminal-API-Anfragen, um Lesegeräte zu konfigurieren und mit dem API-Schlüssel Ihrer Plattform Zahlungen zu akzeptieren. Außerdem identifizieren Sie das verbundene Konto anhand von Metadaten.

Verwenden Sie in beiden Fällen Standorte, um Lesegeräte zutreffend zu gruppieren.

Hinweis

Verbundene Terminal-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-Ressourcen zum verbundenen Konto und nicht zu Ihrer 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 Standorte und Lesegeräte für verbundene Konten, indem Sie den Header Stripe-Account in die API-Anfragen aufnehmen.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/terminal/locations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/terminal/readers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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

Hinweis

Wenn Sie die Connect OAuth-Authentifizierung verwenden, müssen Sie das verbundene Konto separat für Live-Modus und Sandboxes mit der jeweiligen Anwendungs-Client-ID jedes Modus autorisieren.

Bei der Erstellung eines ConnectionToken für das Terminal-SDK setzen Sie den Stripe-Account-Header auf das verbundene Konto, dass die Zahlungen akzeptiert. Sie können auch einen location-Parameter angeben, um den Zugriff auf Lesegeräte einzuschränken. Wenn Sie einen Standort angeben, kann das 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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/terminal/connection_tokens \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 auf der Client-Seite einen PaymentIntent für Direct Charges erstellen, geben Sie keine zusätzlichen Parameter für den PaymentIntent an. Erstellen Sie stattdessen ein ConnectionToken mit dem Stripe-Account-Header für das verbundene Konto, das Zahlungen akzeptiert. Die Client-SDKs erstellen den PaymentIntent auf demselben verbundenen Konto, zu dem das ConnectionToken gehört. Weitere Informationen finden Sie unter PaymentIntents 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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card_present \
  -d capture_method=manual

Befolgen Sie dann die Schritte, um eine Zahlung einzuziehen, um den PaymentIntent abzuwickeln.

Plattformeigene Lesegeräte Private Vorschau

Private Vorschau

Kontaktieren Sie uns, wenn Sie daran interessiert sind, dass die Plattform Lesegeräte mit Direct Charges besitzt und verwaltet. Diese private Vorschaufunktion ist derzeit für intelligente Lesegeräte verfügbar, die eine servergestützte Integration nutzen. Diese Integration funktioniert nur mit verbundenen Konten, die Sie über eine einzelne Plattform steuern.

Bei dieser Integration besitzt Ihre Plattform Geräteressourcen wie Standorte und Lesegeräte und Ihre verbundenen Konten besitzen Zahlungsressourcen wie PaymentIntents. Auf diese Weise kann Ihre Plattform ein einziges Lesegerät verwalten, das Zahlungen für mehrere verbundene Konten verarbeitet. Die verbundenen Konten sind für die Zahlungsbeträge 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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/terminal/locations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/terminal/readers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.

Hinweis

Die Plattform kann PaymentIntents später nur verarbeiten, wenn Sie diese für verbundene Konten erstellen, die Sie über eine einzelne Plattform steuern.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.

Hinweis

Der PaymentIntent kann nur verarbeitet werden, wenn Sie ihn mit dem Stripe-Account-Header erstellen.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/terminal/readers/
{{READER_ID}}
/process_payment_intent \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent=
"{{PAYMENT_INTENT_ID}}"

Destination Charges

Wenn Sie Destination Charges verwenden, besitzt Ihre Plattform API-Ressourcen wie PaymentIntents und Standorte. Bei jeder Zahlung wird automatisch eine Übertragung auf ein verbundenes Konto erstellt.

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

Standorte und Lesegeräte erstellen Serverseitig

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

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/terminal/locations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/terminal/readers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/terminal/connection_tokens \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 müssen Sie diesen Parameter in Fällen festlegen, bei denen das Land der Plattform nicht mit dem Land des verbundenen Kontos übereinstimmt. Wenn on_behalf_of festgelegt ist, führt Stripe automatisch Folgendes durch:

  • Stripe wickelt die Zahlungen im Land des angegebenen Kontos ab. 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 Kunden/der Kundin auf, und nicht die Adresse und die Telefonnummer Ihrer 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.

Hinweis

Die clientseitige Erstellung des PaymentIntent ist mit den anderen SDKs möglich. Wenn Sie das JavaScript SDK für Stripe Terminal verwenden, erstellen Sie einen PaymentIntent auf dem Server.

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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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}}"

Befolgen Sie dann die Schritte, um eine Zahlung einzuziehen, um den PaymentIntent abzuwickeln.

Siehe auch

War diese Seite hilfreich?
JaNein