Weiter zum Inhalt
Konto erstellen
oder
anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellen
Anmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwicklerressourcen
Übersicht
Informationen zu Stripe Payments
Aktualisieren Sie Ihre Integration
Zahlungsanalysefunktionen
Online-Zahlungen
ÜbersichtIhren Use case findenZahlungen verwalten
Payment Links verwenden
Bezahlseite erstellen
Erweiterte Integration erstellen
In-App-Integration erstellen
Zahlungsmethoden
Zahlungsmethoden hinzufügen
Zahlungsmethoden verwalten
Schnellerer Bezahlvorgang mit Link
Zahlungsschnittstellen
Payment Links
Checkout
Web Elements
In-App-Elements
Zahlungsszenarien
Umgang mit mehreren Währungen
Nutzerdefinierte Zahlungsabläufe
Flexibles Acquiring
Orchestrierung
Präsenzzahlungen
Terminal
    Übersicht
    Persönliche Zahlungen akzeptieren
    Integrationsdesign
    Wählen Sie Ihr Lesegerät aus
    Konzipieren einer Integration
    Quickstart
    Beispielanwendungen
    Tests
    Terminal einrichten
    Integration einrichten
    Mit einem Lesegerät verbinden
    Zahlung annehmen
    Kartenzahlungen einziehen
    Weitere Zahlungsmethoden
    Offline-Zahlungen annehmen
    Versand-/Telefonbezahlung
    Regionale Aspekte
    Während des Bezahlvorgangs
    Trinkgelder einziehen
    Zahlungsdetails erfassen und für die zukünftige Verwendung speichern
    Flexible Autorisierungen
    Nach dem Bezahlen
    Transaktionen zurückerstatten
    Belege zur Verfügung stellen
    Checkout anpassen
    Anzeige des Warenkorbs
    Eingaben auf dem Bildschirm erfassen
    Ausgelesene Daten erfassen
    Erfassen von Daten durch Tippen für NFC-Geräte
    Apps auf Geräten
    Lesegeräte verwalten
    Lesegeräte anfordern, zurückgeben, ersetzen
    Lesegerät registrieren
    Standorte und Zonen verwalten
    Lesegeräte konfigurieren
    Lesegeräte überwachen
    Verschlüsselung
    Quellen
    API-Referenzen
    Mobile Lesegeräte
    Intelligente Lesegeräte
    SDK-Migrationsleitfaden
    Bereitstellungscheckliste
    Produktdatenblätter für Lesegeräte von Stripe Terminal
Mehr als Zahlungen
Unternehmensgründung
Krypto
Financial Connections
Climate
StartseiteZahlungenTerminal

Test Stripe Terminal

Erfahren Sie, wie Sie Ihre Terminal-Integration testen können.

Notiz

Ein Großteil des Verfahrens zum Testen von Stripe Terminal entspricht dem Verfahren für das Testen von Online-Zahlungen per Stripe. Außerdem können Sie Stripe Terminal im Testmodus nicht mit mobilen Wallets (z. B. Apple Pay oder Google Pay) verwenden. Weitere Informationen finden Sie im allgemeinen Stripe-Testleitfaden.

Der beste Weg für eine erfolgreiche Terminal-Bereitstellung besteht darin, jeden Teil Ihrer Integration zu testen. Wir stellen Test-Tools für jede Phase zur Verfügung:

  1. Testen Sie Ihre Integration mit dem Lesegerät-Simulator, bevor Sie ein Lesegerät bestellen.
  2. Testen Sie die komplette Integration Ihrer Hardware mit einer physischen Testkarte.

Simuliertes Lesegerät

Referenz

  • discoverReaders (JavaScript)
  • DiscoveryConfiguration (iOS)
  • DiscoveryConfiguration (Android)
  • Lesegeräte erkennen

Stripe Terminal SDKs und die servergestützte Integration verfügen über ein integriertes simuliertes Kartenlesegerät, sodass Sie Ihre App entwickeln und testen können, ohne eine Verbindung zu physischer Hardware herstellen zu müssen. Mit dem simulierten Lesegerät können Sie alle Terminal-Abläufe in Ihrer App nachbilden, unabhängig davon, ob Ihre Integration abgeschlossen ist oder sich noch im Aufbau befindet.

Das simulierte Lesegerät bietet keine Nutzeroberfläche. Nachdem Sie in Ihrer App eine Verbindung damit hergestellt haben, können Sie sehen, dass es funktioniert, wenn Aufrufe des Stripe SDK oder der API erfolgreich sind.

Simulierte Lesegeräte für SDKs simulieren bei Bedarf automatisch die Kartenpräsentation. Aktualisieren Sie für die serverseitige Integration Ihre Integration auf Kartenwährung simulieren.

Simulierte Testkarten

Das simulierte Lesegerät kann so konfiguriert werden, dass es eine simulierte Testkarte verwendet, mit der verschiedene Abläufe innerhalb Ihrer Point-of-Sale-Anwendung getestet werden können.

Bevor Sie eine Zahlungsmethode erfassen, konfigurieren Sie das simulierte Lesegerät so, dass es mithilfe einer der folgenden Testkartennummern oder Testzahlungsmethoden bestimmte Antworten erzeugt.

Standard-Testkarten

TestkartennummerTestzahlungsmethodeMarke
visaVisa
visa_debitVisa (Debit)
mastercardMastercard
mastercard_debitMastercard (Debit)
mastercard_prepaidMastercard (Prepaid)
amexAmerican Express
amex2American Express
discoverDiscover
discover2Discover
dinersDiners Club
diners_14digitsDiners Club (14-stellige Karte)
jcbJCB
unionpayUnionPay
interacInterac
eftpos_au_debiteftpos Australia
eftpos_au_visa_debitEFTPOS Australien/Visa
eftpos_au_mastercard_debitEFTPOS Australien/Mastercard

Testkarten für bestimmte Erfolgsfälle

TestkartennummerTestzahlungsmethodeErgebnis
offline_pin_cvmSimuliert eine Aufforderung an Karteninhaber/innen, eine Offline-PIN einzugeben. Für die resultierende Zahlung ist die cardholder_verification_method auf offline_pin festgelegt.
offline_pin_sca_retryKundenauthentifizierung](/strong-customer-authentication) ausgelösten Wiederholungsvorgang, bei dem die anfängliche kontaktlose Zahlung einer Karteninhaberin/eines Karteninhabers fehlschlägt und das Lesegerät diese/diesen dann auffordert, die Karte einzuführen und die zugehörige offline PIN. einzugeben. Für die resultierende Abbuchung ist cardholder_verification_method auf offline_pin gesetzt.
online_pin_cvmSimuliert eine Aufforderung an Karteninhaber/innen, eine Online-PIN einzugeben. Für die resultierende Zahlung ist die cardholder_verification_method auf online_pin festgelegt.
online_pin_sca_retrySimuliert einen durch die starke Kundenauthentifizierung ausgelösten Wiederholungsvorgang, bei dem die anfängliche kontaktlose Zahlung einer Karteninhaberin/eines Karteninhabers fehlschlägt und das Lesegerät diese/diesen dann auffordert, die zugehörige Online-PIN einzugeben. Für die endgültige Zahlung ist cardholder_verification_method auf online_pin gesetzt.

Testkarten für bestimmte Fehlerfälle

Notiz

Die Verwendung dieser Karten für das direkte Speichern ohne Belastung und SetupIntents gibt eine setup_intent_authentication_failure-Antwort zurück.

TestkartennummerTestzahlungsmethodeErgebnis
charge_declinedDie Abbuchung wird mit dem Code card_declined abgelehnt.
charge_declined_insufficient_fundsDie Abbuchung wird mit dem Code card_declined abgelehnt. Das decline_code-Attribut ist insufficient_funds.
charge_declined_lost_cardDie Abbuchung wird mit dem Code card_declined abgelehnt. Das decline_code-Attribut ist lost_card.
charge_declined_stolen_cardDie Abbuchung wird mit dem Code card_declined abgelehnt. Das decline_code-Attribut ist stolen_card.
charge_declined_expired_cardDie Abbuchung wird mit dem Code expired_card abgelehnt.
charge_declined_processing_errorDie Abbuchung wird mit dem Code processing_error abgelehnt.
refund_failDie Abbuchung ist erfolgreich, aber die Rückerstattung einer erfassten Zahlung schlägt asynchron mit dem failure_reason expired_or_canceled_card fehl. Da eine Rückerstattung asynchron fehlschlägt, scheint sie zunächst erfolgreich zu sein und weist den Status failed nur für nachfolgende Abrufe auf. Wir benachrichtigen Sie auch über fehlgeschlagene Rückerstattungen mit dem Webhook-Ereignis refund.failed. Dieser simulierte Fehler wird nur im JavaScript-SDK unterstützt.

Simulierte Kartenpräsentation

Nutzen Sie bei Verwenden der servergestützten Integration den Endpoint present_payment_method, um zu simulieren, dass Karteninhaber/innen ihre Karte auf das Lesegerät auflegen oder in dieses einführen.

Command Line
cURL
curl -X POST https://api.stripe.com/v1/test_helpers/terminal/readers/tmr_xxx/present_payment_method \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
{ "id": "tmr_xxx", "object": "terminal.reader", "action": { "failure_code": null, "failure_message": null, "process_payment_intent": { "payment_intent": "pi_xxx" }, "status": "succeeded", "type": "process_payment_intent" }, … }

Wenn Sie keine Parameter angeben, wird für die simulierte Zahlung standardmäßig eine gültige Testkarte verwendet, die auf der Art der Zahlungsmethode des PaymentIntent basiert. Nachfolgend finden Sie die Standard-Testkarten für die Arten von Terminal-Zahlungsmethoden:

Art der ZahlungsmethodeTestkartennummerTestzahlungsmethode
card_presentvisa
card_present und interac_presentvisa
interac_presentinterac

Mit den Standard-Testkarten können Sie zur Simulation von Fehlerszenarien auch Testbeträge verwenden.

Aktualisierungen für simulierte Lesegeräte

Während der Verbindung zu einem simulierten Bluetooth-Lesegerät können Sie eine Aktualisierung für ein simuliertes Lesegerät konfigurieren.

Legen Sie die Terminal.getInstance().simulatorConfiguration auf eine neue Instanz der SimulatorConfigurationfest, wobei das Feld update auf eine der folgenden Konfigurationen festgelegt ist. Das Aufrufen von connectReader löst eine Aktualisierung des simulierten Lesegeräts aus.

Aktualisierung der KonfigurationErgebnis
NONEKeine Aktualisierung. Den Nutzer/innen muss nichts weiter mitgeteilt werden.
REQUIREDEine erforderliche Aktualisierung ist verfügbar, sie dauert 1 Minute. Ihr MobileReaderListener empfängt den Rückruf onStartInstallingUpdate.
REQUIRED_FOR_OFFLINEEine erforderliche Aktualisierung ist überfällig und dauert 1 Minute. Im Offline-Betrieb ist die Verbindung zum Lesegerät nicht verfügbar. Ihr MobileReaderListener empfängt den Rückruf onStartInstallingUpdate.
UPDATE_AVAILABLEEine optionale Aktualisierung ist verfügbar. Teilen Sie den Nutzer/innen mit, dass eine Aktualisierung verfügbar ist, und verweisen Sie auf das Datum requiredAt.
LOW_BATTERYEin erforderliches Update beginnt mit der Installation, schlägt jedoch fehl, weil der Akku des Lesegeräts fast leer ist. Die Verbindung zum Lesegerät schlägt ebenfalls fehl. Dadurch wird simuliert, dass das Lesegerät eine ältere Version der Software nutzt.
LOW_BATTERY_SUCCEED_CONNECTEin erforderliches Update beginnt mit der Installation, schlägt jedoch fehl, weil der Akku des Lesegeräts fast leer ist. Verbindung zum Lesegerät erfolgreich hergestellt. Dadurch wird simuliert, dass das Lesegerät eine aktuelle Version einer Software nutzt, die noch akzeptabel ist. Die Installation des Updates wird erneut versucht, wenn wieder eine Verbindung zum Lesegerät hergestellt wird.
RANDOMEine zufällige Auswahl der oben genannten Szenarien.

Physische Testkarten

Testen Sie Zahlungen mit Ihrem Lesegerät von Stripe Terminal mithilfe einer physischen Testkarte. Sie können Lesegeräte und physische Karten im Stripe-Dashboard unter der Registerkarte „Terminal“ kaufen.

Diese physische Testkarte unterstützt sowohl Zahlungen per Karteneingabe als auch kontaktlose Zahlungen. Es funktioniert nur mit von Stripe vorzertifizierten Lesegeräten und nur mit der Stripe API in einer Sandbox. Wenn Sie versuchen, Ihre physische Testkarte im Live-Modus zu 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 Werte 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. Sie können diese im Dashboard im Terminal-Hardware-Shop bestellen. Sie können den physischen Test der Marke Stripe nicht als Interac-Karte verwenden.

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.

Notiz

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 eftops-Testkarte verwenden. Sie können diese im Dashboard im Terminal-Hardware-Shop bestellen. Sie können eine physische Testkarte unter Stripe-Marke nicht als eftpos-Karte verwenden.

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.

Siehe auch

  • Bestellungen aufgeben
  • Integrations-Checkliste
War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unser Änderungsprotokoll an.
Fragen? Sales-Team kontaktieren.
LLM? Lesen Sie llms.txt.
Unterstützt von Markdoc