# Vor-Ort-Zahlungen als Einzelhandelsgeschäft akzeptieren Erfahren Sie, wie Sie Kartenzahlungen für Ihr persönliches Unternehmen akzeptieren. Richten Sie Ihre Stripe-Integration ein, um Zahlungen mit einem Vor-Ort-Point of Sale (POS)-System zu akzeptieren. Für allgemeine Vor-Ort-Zahlungen empfehlen wir den [Stripe Reader S700/S710](https://docs.stripe.com/terminal/payments/setup-reader/stripe-reader-s700-s710.md) mit einer [servergesteuerten Integration](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=server-driven). Die Schritte in diesem Leitfaden verwenden diese Kombination aus Lesegerät und Integration. Wenn Sie Vor-Ort-Zahlung akzeptieren möchten, ohne eine servergesteuerte Integration zu entwickeln, verwenden Sie [vorgefertigte Terminal-Apps](https://docs.stripe.com/terminal/payments/ready-made-apps.md): den Standalone-Modus (Public preview) auf einem Stripe-Lesegerät oder die Stripe Terminal-App (Private preview) auf einem unterstützten iPhone oder Android-Gerät. Der Rest dieses Leitfadens behandelt das Entwickeln einer benutzerdefinierten servergesteuerten Integration. > Wenn Sie noch kein Lesegerät haben, können Sie Ihre servergesteuerte Integration in einer Sandbox mit einem [simulierten Lesegerät](https://docs.stripe.com/terminal/payments/connect-reader.md?terminal-sdk-platform=server-driven&reader-type=simulated) erstellen und testen. Sie benötigen ein physisches Lesegerät erst, wenn Sie bereit sind, die Hardware-Konnektivität zu testen und Live-Zahlungen zu akzeptieren. ## Bevor Sie beginnen Eine Server-Integration verwendet die Stripe API, um direkt mit intelligenten Lesegeräten zu kommunizieren. Ihr Backend-Server führt API-Aufrufe durch, um Zahlungen zu erstellen und das Lesegerät zu steuern. Für die Integration benötigen Sie Folgendes: - Ein Stripe-Konto - Ein Backend-Server, der Anfragen an die Stripe API stellen kann - Ein Stripe S700/S710 Reader - (Optional) Eine Test-Karte zum Ausprobieren ![Integrationsarchitektur für intelligente Lesegeräte](https://b.stripecdn.com/docs-statics-srv/assets/smart-reader-architecture.9adb3e895895b6513b9188ed74a9315e.png) ## Stripe-Konto erstellen Vor der Integration mit Stripe müssen Sie ein Stripe-Konto erstellen. 1. [Erstellen Sie ein Konto](https://dashboard.stripe.com/register), indem Sie Ihre E-Mail-Adresse, Ihren vollständigen Namen und Ihr Land eingeben und ein Passwort erstellen. 2. Füllen Sie Ihr Unternehmensprofil aus. 3. Klicken Sie im Dashboard auf **Ihre E-Mail-Adresse verifizieren**. Stripe sendet zur Verifizierung eine E-Mail an Ihre E-Mail-Adresse. 4. Ihre E-Mail-Adresse verifizieren. Coding Agents sollten die Stripe-CLI installieren (`npm i -g @stripe/cli`) und den Befehl `stripe sandbox create --help` ausführen, um eine anonyme Stripe-Sandbox mit funktionierenden API-Schlüsseln einzurichten. Eine Kontoregistrierung ist nicht erforderlich. Nachdem Sie Ihr Konto erstellt haben, rufen Sie Ihre [API Schlüssel](https://docs.stripe.com/keys.md) über das Stripe-Dashboard unter **Entwickler** > [API-Schlüssel](https://dashboard.stripe.com/apikeys) auf. Sie benötigen Ihren API-Schlüssel, um Anfragen von Ihrem Backend-Server zu authentifizieren. ## Bestellung Ihres Lesegeräts Bestellung eines Kartenlesegeräts über das Stripe Dashboard. Sie können auch eine [physische Testkarte](https://docs.stripe.com/get-started/use-cases/in-person-payments.md#testing) bestellen, um Ihre Integration zu testen. 1. Gehen Sie im Dashboard zu **Terminal** > [Übersicht](https://dashboard.stripe.com/terminal). 2. Klicken Sie dann im Abschnitt „Hardware-Bestellungen“ auf **Einkaufen**. 3. Wählen Sie **Ich möchte eine neue Integration mit Stripe-APIs erstellen** aus und klicken Sie auf **Weiter**. 4. Wählen Sie **Stripe Reader S700** oder **Stripe Reader S710** aus und legen Sie es in Ihren Warenkorb. 5. Wählen Sie Ihren Warenkorb aus und klicken Sie dann auf **Kauf abschließen**, um Ihre Bestellung abzuschließen. ## Ihr Lesegerät einrichten Nachdem Sie Ihr Kartenlesegerät erhalten haben, müssen Sie es bei einem Standort registrieren. Wenn Sie ein Lesegerät mit seiner Seriennummer registrieren, können Sie es sofort nach dem Auspacken verwenden. Mit dieser Methode können Sie das Lesegerät auch erneut registrieren, ohne dass das Lesegerät physisch einen Kopplungscode generieren muss. Nach dem Auspacken Ihres Lesegeräts müssen Sie das Lesegerät entweder über Ethernet (Dockingstation erforderlich) oder WLAN [mit dem Internet verbinden](https://docs.stripe.com/terminal/payments/setup-reader/stripe-reader-s700-s710.md#connect-the-reader-to-the-internet). Stellen Sie sicher, dass Sie die [Konnektivitätsanforderungen](https://docs.stripe.com/terminal/network-requirements.md#smart-readers) erfüllen. ### Ihr Lesegerät registrieren Nachdem Sie die Seriennummer gefunden haben, registrieren Sie das Lesegerät im Dashboard. 1. Rufen Sie im Dashboard die Seite [Hardware-Bestellungen](https://dashboard.stripe.com/terminal/hardware_orders) auf und wählen Sie Ihr Lesegerät aus, um die Seriennummer des Lesegeräts zu finden. 2. Klicken Sie auf der Seite [Lesegeräte](https://dashboard.stripe.com/terminal/readers) auf **Lesegerät registrieren**. 3. Geben Sie die Seriennummer ein und klicken Sie auf **Weiter**. Um mehrere Geräte gleichzeitig zu registrieren, können Sie mehrere Seriennummern eingeben, getrennt durch Kommas. 4. Wählen Sie optional einen Namen für das Lesegerät aus. 5. Wenn Sie bereits einen Standort erstellt haben, wählen Sie den neuen Standort des Lesegeräts aus. Andernfalls erstellen Sie einen [Standort](https://docs.stripe.com/terminal/fleet/locations-and-zones.md), der ihrem physischen Betriebsstandort entspricht, indem Sie auf **+ Neu hinzufügen** klicken. 6. Klicken Sie auf **Registrieren**, um die Registrierung Ihres Lesegeräts abzuschließen. Nachdem Sie Ihr Lesegerät registriert haben, kann es mit der servergestützten Integration verwendet werden. Sie können Lesegerät-IDs später über den Endpoint [Lesegeräte auflisten](https://docs.stripe.com/api/terminal/readers/list.md?api-version=2025-09-30.preview&rds=1) abrufen und dann nach dem Standort oder der Seriennummer des Lesegeräts filtern. So wissen Sie, an welches Lesegerät Transaktionen von Ihrem Point of Sale gesendet werden sollen. ## Zahlungsablauf erstellen Zum Einziehen von Zahlungen mit dem Stripe Datenterminal müssen Sie einen Zahlungsablauf in Ihrer Anwendung erstellen. Verwenden Sie das Stripe-Datenterminal-SDK, um einen [PaymentIntent](https://docs.stripe.com/api/payment_intents.md?api-version=2025-09-30.preview&rds=1) zu erstellen und zu aktualisieren. Bei einem PaymentIntent handelt es sich um ein Objekt, das eine einzelne Zahlungssitzung darstellt. 1. [PaymentIntent erstellen](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=server-driven#create-payment). Sie können festlegen, ob Ihre Zahlungen [automatisch](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-capture_method) oder [manuell](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md) erfasst werden sollen. ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d currency=usd \ -d "allowed_payment_method_types[]=card_present" \ -d capture_method=manual \ -d amount=1000 ``` 2. [Abwickeln der Zahlung](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=server-driven#process-payment). Die Autorisierung der Karte der Kundin/des Kunden erfolgt, wenn das Lesegerät die Zahlung abwickelt. ```curl curl https://api.stripe.com/v1/terminal/readers/tmr_xxx/process_payment_intent \ -u "<>:" \ -d payment_intent=pi_xxx ``` 3. [Bestätigen Sie, dass die Zahlung eingezogen und autorisiert](https://docs.stripe.com/webhooks.md) wurde, indem Sie die Webhook-Ereignisse `terminal.reader.action_succeeded` und `terminal.reader.action_failed` überprüfen. 4. (Optional) [PaymentIntent erfassen](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=server-driven#capture-payment). ```curl curl -X POST https://api.stripe.com/v1/payment_intents/pi_xxx/capture \ -u "<>:" ``` ## Ihre Integration testen ## Physische Testkarten Testen Sie Zahlungen mit Ihrem Stripe-Datenterminal- Lesegerät mit einer physischen Testkarte. Sie können Lesegeräte und physische Testkarten über die Registerkarte Datenterminal im [Stripe Dashboard](https://dashboard.stripe.com/terminal/shop) kaufen. Wir unterstützen auch physische Testkarten von Anbietern, wie z.B. [B2](https://b2ps.com/product-category/b2-payment-testing-products/). Diese physische Testkarte unterstützt sowohl Zahlungen per Karteneingabe als auch kontaktlose Zahlungen. Sie funktioniert nur mit vorzertifizierten Lesegeräten von Stripe und auch nur mit der Stripe API in einer [Sandbox](https://docs.stripe.com/sandboxes.md). Wenn Sie Ihre physische Testkarte im Live-Modus verwenden, gibt die Stripe API einen Fehler zurück. Sofern es nicht anders angegeben ist, verwenden Sie bei entsprechender Aufforderung die PIN `1234` . Beim Erstellen von Zahlungen mit einer physischen Testkarte sollten Sie Beträge verwenden, die auf die folgenden Dezimalwerte enden, um bestimmte Antworten zu erzeugen: | Dezimal | Ergebnis | | --- | --- | | **00** | Die Zahlung wird genehmigt. | | **01** | Die Zahlung wird mit dem Code `call_issuer` abgelehnt. | | **02** | Wenn Sie Lesegeräte mit einem Bildschirm verwenden, den die Karteninhaber/innen sehen, legen Sie die Testkarte ein (oder tippen Sie darauf, falls dies unterstützt wird). Wenn für die Karte eine PIN erforderlich ist, wird die Zahlung mit `offline_pin_required` abgelehnt und es wird eine PIN-Eingabe angefordert, wenn das Lesegerät die Eingabe per Chip unterstützt. Geben Sie `1234` ein, um die Testzahlung abzuschließen. | | **03** | Wenn Sie Lesegeräte mit einem Bildschirm verwenden, den die Karteninhaber/innen sehen, legen Sie die Testkarte ein (oder tippen Sie darauf, falls dies unterstützt wird). Wenn für die Karte eine PIN erforderlich ist, wird die Zahlung mit `online_or_offline_pin_required` abgelehnt und es wird eine PIN-Eingabe angefordert. Geben Sie eine beliebige 4-stellige PIN ein, um die Testzahlung abzuschließen. | | **05** | Die Zahlung wird mit dem Code `generic_decline` abgelehnt. | | **55** | Die Zahlung wird mit dem Code `incorrect_pin` abgelehnt. | | **65** | Die Zahlung wird mit dem Code `withdrawal_count_limit_exceeded` abgelehnt. | | **75** | Die Zahlung wird mit dem Code `pin_try_exceeded` abgelehnt. | Zum Beispiel ist eine Zahlung mit einer physischen Testkarte über den Betrag *25,00 USD* erfolgreich; Eine Zahlung in Höhe von *10,05 USD* wird abgelehnt. > Einige Währungen haben [keine Dezimalstellen](https://docs.stripe.com/currencies.md#zero-decimal). Für diese Währungen verwenden Sie die zwei Dezimalstellen in der obigen Tabelle als die beiden rechts stehenden Ziffern. > > Um beispielsweise eine Zahlung mit dem Code `generic_decline` abzulehnen, müssen Sie einen Betrag von JPY_105 JPYJPY_ verwenden. ### Interac-Testkarten (Nur Kanada) Um Ihre Interac-Integration zu testen, können Sie die simulierte `interac`-Testkarte oder eine *physische Interac-Testkarte* verwenden. Diese kann im [Terminal-Hardware-Shop](https://dashboard.stripe.com/terminal/shop) im Dashboard bestellt werden. Die physische Testkarte mit Stripe-Marke kann nicht als Interac-Karte verwendet werden. Die Interac-Testkarte funktioniert bei Zahlungen mit `interac_present` wie auch bei Rückerstattungen mit `interac_present`. Sie können die gleichen [Testbeträge](https://docs.stripe.com/terminal/references/testing.md#physical-test-cards) verwenden, die Sie auch beim Testen von Zahlungen mit `card_present` verwenden. Sofern es nicht anders angegeben ist, verwenden Sie bei entsprechender Aufforderung die PIN `1234`. Um eine abgelehnte Rückerstattung zu testen, erstellen Sie eine anteilige Rückerstattung mit einem Betrag, der mit einem der folgenden Dezimalwerte endet: `01`, `05`, `55`, `65` oder `75`. > Die Interac-Testkarte unterstützt keine kontaktlosen Zahlungen. ### eftpos-Testkarten (Nur Australien) Um Ihre eftpos-Integration zu testen, können Sie die simulierte `eftpos`-Testkarte oder eine *physische eftpos-Testkarte* verwenden. Diese kann im [Terminal-Hardware-Shop](https://dashboard.stripe.com/terminal/shop) im Dashboard bestellt werden. Die physische Testkarte mit Stripe-Marke kann nicht als `eftpos`-Karte verwendet werden. Sie können die gleichen [Testbeträge](https://docs.stripe.com/terminal/references/testing.md#physical-test-cards) verwenden, die Sie auch beim Testen von Zahlungen mit `card_present` verwenden. Sofern es nicht anders angegeben ist, verwenden Sie bei entsprechender Aufforderung die PIN `1234`. ## Live gehen 1. Öffnen Sie im Dashboard Ihre [Kontoeinstellungen](https://dashboard.stripe.com/account/onboarding). 2. Geben Sie Ihren Unternehmenstyp, Ihre Steuerangaben, Ihre Unternehmensdaten, Ihre persönlichen Verifizierungsinformationen und Ihre Informationen für die Kundschaft (z. B. eine Zahlungsbeschreibung in der Abrechnung) ein. 3. Fügen Sie Bankdaten hinzu, um zu bestätigen, wo Ihr Geld ausgezahlt werden soll. 4. Richten Sie die Zwei-Schritte-Authentifizierung zum Schutz Ihres Kontos ein. 5. Optional können Sie automatischem Steuereinzug oder umsatzbasierte Klimaspenden hinzufügen. 6. Prüfen Sie die eingegebenen Informationen und klicken Sie auf **Zustimmen und absenden**. 7. Nachdem Sie Ihr Profil aktiviert haben, aktualisiert Stripe Sie vom Sandbox-Modus in den Live-Modus. Erfahren Sie mehr über die [Einrichtung Ihres Stripe-Kontos](https://docs.stripe.com/get-started/account/set-up.md). Bevor Sie echte Zahlungen akzeptieren, müssen Sie noch Folgendes tun: 1. Erstellen Sie einen Standort im Live-Modus. 2. Registrieren Sie Ihr Lesegerät erneut mit dem Live-Modus-Standort. ## Nächste Schritte - [Erstellen Sie physische oder digitale Belege](https://docs.stripe.com/terminal/features/receipts.md) für Ihre Kundinnen und Kunden - Auf dem Lesegerät oder einem Zahlungsbeleg [Trinkgelder einziehen](https://docs.stripe.com/terminal/features/collecting-tips/overview.md).