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.
  • If you use separate charges and transfers, you submit Terminal API requests using your platform API key to create charges on your platform account, then create separate transfers to move funds to your connected accounts.

In all cases, use locations to group readers applicably.

Hinweis

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

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}}"

Wenn Sie eine servergesteuerte Integration verwenden, müssen Sie kein Verbindungstoken erstellen.

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}}"

Siehe auch