Se connecter à un lecteur
Note
Si vous n’avez pas encore choisi de lecteur, comparez les lecteurs Terminal et sélectionnez celui qui répond au mieux à vos exigences.
Les SDK et l’intégration pilotée par serveur de Stripe Terminal sont livrés avec un lecteur de carte simulé intégré, ce qui vous permet de développer et de tester votre application sans avoir à vous connecter à du matériel physique. Que votre intégration soit terminée ou que vous soyez en train de la développer, utilisez le lecteur simulé pour émuler tous les flux Terminal dans votre application.
Notez que la simulation de lecteur ne fournit pas d’interface utilisateur. Après vous y être connecté(e) dans votre application, vous pouvez la voir fonctionner lorsque les appels au SDK ou à l’API Stripe aboutissent.
Les lecteurs simulés pour SDK simulent automatiquement la présentation des cartes si nécessaire. Concernant l’intégration pilotée par serveur, mettez à jour votre intégration pour simuler la présentation d’une carte.
Pour utiliser le lecteur de simulation, appelez discoverReaders
afin de rechercher des lecteurs, avec l’option simulated
définie sur true
. Lorsque discoverReaders
renvoie un résultat, appelez connectReader
pour vous connecter au lecteur de simulation.
// 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); } } }
Configuration du lecteur de simulation
Le lecteur de simulation prend en charge une petite partie de la configuration, ce qui vous permet de tester différents flux au sein de votre application de point de vente, par exemple différentes marques de cartes ou des scénarios d’erreur comme un paiement refusé.
La configuration du simulateur accepte une option testCardNumber
ou testPaymentMethod
. Afin d’activer ce comportement, insérez cette ligne de code avant d’appeler collectPaymentMethod
:
terminal.setSimulatorConfiguration({testCardNumber: '4242424242424242'});
Pour en savoir plus sur l’API des options de configuration, consultez la documentation sur l’API JavaScript de Stripe Terminal.
Prochaines étapes
Vous avez connecté votre application au lecteur. Vous pouvez maintenant encaisser votre premier paiement avec Stripe Terminal.
Les nom et logo BBPOS et Chipper™ sont des marques ou marques déposées de BBPOS Limited aux États-Unis et/ou dans d’autres pays. Les nom et logo Verifone® sont des marques ou marques déposées de Verifone aux États-Unis et/ou dans d’autres pays. L’utilisation de ces marques n’implique aucune approbation de la part de BBPOS ou Verifone.