Mit einem Lesegerät verbinden
Notiz
Wenn Sie sich noch nicht für ein Lesegerät entschieden haben, vergleichen Sie die verfügbaren Terminal-Lesegeräte und wählen Sie eines aus, das Ihren Bedürfnissen am besten entspricht.
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.
Beachten Sie, dass das simulierte Lesegerät keine Nutzeroberfläche bietet. Nachdem Sie sich in Ihrer App damit verbunden haben, können Sie sehen, dass sie 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 Kartenpräsentation simulieren.
Um das simulierte Lesegerät zu verwenden, rufen Sie discoverReaders
auf, um nach Lesegeräten zu suchen, und legen Sie die Option simulated
auf true
fest. Wenn discoverReaders
ein Ergebnis zurückgibt, rufen Sie connectReader
auf, um sich mit dem simulierten Lesegerät zu verbinden.
// Handler for a "Connect Reader" button async function connectReaderHandler() { const config = {simulated: true}; const discoverResult = await terminal.discoverReaders(config); if (discoverResult.error) { console.log('Failed to discover: ', discoverResult.error); } else if (discoverResult.discoveredReaders.length === 0) { console.log('No available readers.'); } else { // Just select the first reader here. const selectedReader = discoverResult.discoveredReaders[0]; const connectResult = await terminal.connectReader(selectedReader); if (connectResult.error) { console.log('Failed to connect: ', connectResult.error); } else { console.log('Connected to reader: ', connectResult.reader.label); } } }
Konfiguration von simulierten Lesegeräten
Das simulierte Lesegerät kann in geringem Maße konfiguriert werden, sodass Sie verschiedene Abläufe innerhalb Ihrer Point-of-Sale-Anwendung testen können, z. B. verschiedene Karten oder aber Fehlerszenarien, wie eine abgelehnte Zahlung.
Die Simulatorkonfiguration akzeptiert entweder die Optionen testCardNumber
oder testPaymentMethod
. Um dieses Verhalten zu aktivieren, fügen Sie diese Codezeile ein, bevor Sie collectPaymentMethod
aufrufen:
terminal.setSimulatorConfiguration({testCardNumber: '4242424242424242'});
Mehr Informationen über die API für Konfigurationsoptionen finden Sie in der JavaScript-API-Referenz von Stripe Terminal.
Nächste Schritte
Sie haben Ihre Anwendung mit dem Lesegerät verbunden. Ziehen Sie als Nächstes Ihre Stripe Terminal-Zahlung ein.
Der Name und das Logo von BBPOS und Chipper™ sind Marken oder eingetragene Marken von BBPOS Limited in den Vereinigten Staaten und/oder anderen Ländern. Der Name und das Logo von Verifone® sind entweder Marken oder eingetragene Marken von Verifone in den Vereinigten Staaten und/oder anderen Ländern. Die Verwendung der Marken stellt keine Billigung durch BBPOS oder Verifone dar.