# Akzeptieren Sie Vor-Ort-Zahlungen als Einzelhandelsgeschäft Erfahren Sie, wie Sie Kartenzahlungen für Ihr persönliches Unternehmen akzeptieren. In diesem Leitfaden wird beschrieben, wie Sie Ihre Stripe-Integration so einrichten, dass Zahlungen akzeptiert werden, wenn Sie ein persönliches Point of Sale (POS)-System nutzen. Für allgemeine Vor-Ort-Zahlungen empfehlen wir den [Stripe Reader S700](https://docs.stripe.com/terminal/payments/setup-reader/stripe-reader-s700-s710.md) mit einer [servergestützten 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. ## 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. 1. Füllen Sie Ihr Unternehmensprofil aus. 1. Klicken Sie im Dashboard auf **Ihre E-Mail-Adresse verifizieren**. Stripe sendet zur Verifizierung eine E-Mail an Ihre E-Mail-Adresse. 1. Ihre E-Mail-Adresse verifizieren. 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). 1. Klicken Sie dann im Abschnitt „Hardware-Bestellungen“ auf **Einkaufen**. 1. Wählen Sie **Ich möchte eine neue Integration mit Stripe-APIs erstellen** aus und klicken Sie auf **Weiter**. 1. Wählen Sie **Stripe Reader S700** oder **Stripe Reader S710** aus und legen Sie es in Ihren Warenkorb. 1. 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. 1. Klicken Sie auf der Seite [Lesegeräte](https://dashboard.stripe.com/terminal/readers) auf **Lesegerät registrieren**. 1. 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. 1. Wählen Sie optional einen Namen für das Lesegerät aus. 1. 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. 1. 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 "payment_method_types[]=card_present" \ -d capture_method=manual \ -d amount=1000 ``` 1. [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 ``` 1. [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. 1. (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). 1. 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. 1. Fügen Sie Bankdaten hinzu, um zu bestätigen, wo Ihr Geld ausgezahlt werden soll. 1. Richten Sie die Zwei-Schritte-Authentifizierung zum Schutz Ihres Kontos ein. 1. Optional können Sie automatischem Steuereinzug oder umsatzbasierte Klimaspenden hinzufügen. 1. Prüfen Sie die eingegebenen Informationen und klicken Sie auf **Zustimmen und absenden**. 1. Nachdem Sie Ihr Profil aktiviert haben, aktualisiert Stripe Sie vom Sandbox-Modus in den Live-Modus. Learn more about [setting up your Stripe account](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. 1. Registrieren Sie Ihr Lesegerät erneut mit dem Live-Modus-Standort. ## Nächste Schritte Nach der Einrichtung Ihrer Integration empfehlen wir Ihnen, die folgenden Funktionen zu implementieren: - [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).