Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden

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 persönliche Zahlungen empfehlen wir das Stripe-Lesegerät S700 mit einer Server-gestützten Integration. 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-Lesegerät
  • (Optional) Eine Test-Karte zum Ausprobieren
Integrationsarchitektur für intelligente Lesegeräte

Stripe-Konto erstellen

Vor der Integration mit Stripe müssen Sie ein Stripe-Konto erstellen.

  1. Erstellen Sie ein Konto, 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. Eine E-Mail zur Verifizierung wird an Ihre E-Mail-Adresse gesendet.
  4. Ihre E-Mail-Adresse verifizieren.

Nachdem Sie Ihr Konto erstellt haben, rufen Sie Ihre API Schlüssel über das Stripe-Dashboard unter Entwickler > API-Schlüssel 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 bestellen, um Ihre Integration zu testen.

  1. Gehen Sie im Dashboard zu Terminal > Übersicht.
  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 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. Stellen Sie sicher, dass Sie die Konnektivitätsanforderungen 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 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 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, 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 Listenlesegeräte-Endpoint abrufen und nach dem Standort oder der Serien-ID des Lesegeräts filtern, damit Sie wissen, welches Lesegerät Transaktionen von Ihrem Point of Sale senden soll.

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 zu erstellen und zu aktualisieren. Bei einem PaymentIntent handelt es sich um ein Objekt, das eine einzelne Zahlungssitzung darstellt.

  1. PaymentIntent erstellen. Sie können festlegen, ob Ihre Zahlungen automatisch oder manuell erfasst werden sollen.
  2. Abwickeln der Zahlung. Die Autorisierung der Karte der Kundin/des Kunden erfolgt, wenn das Lesegerät die Zahlung abwickelt.
  3. Bestätigen Sie, dass die Zahlung eingezogen und autorisiert wurde, indem Sie die Webhook-Ereignisse terminal.reader.action_succeeded und terminal.reader.action_failed überprüfen.
  4. (Optional) PaymentIntent erfassen.

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 kaufen. Wir unterstützen auch physische Testkarten von Anbietern, wie z.B. B2.

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. 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:

DezimalErgebnis
00Die Zahlung wird genehmigt.
01Die Zahlung wird mit dem Code call_issuer abgelehnt.
02Wenn 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.
03Wenn 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.
05Die Zahlung wird mit dem Code generic_decline abgelehnt.
55Die Zahlung wird mit dem Code incorrect_pin abgelehnt.
65Die Zahlung wird mit dem Code withdrawal_count_limit_exceeded abgelehnt.
75Die 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.

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 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 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.

Hinweis

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 im Dashboard bestellt werden. Die physische Testkarte mit Stripe-Marke kann nicht als eftpos-Karte verwendet werden.

Sie können die gleichen Testbeträge 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.
  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 wird.
  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 Aktivierung Ihres Stripe-Kontos.

Nächste Schritte

Nach der Einrichtung Ihrer Integration empfehlen wir Ihnen, die folgenden Funktionen zu implementieren: