Connettere un lettore

Gli SDK di Stripe Terminal e l’integrazione basata su server sono dotati di un lettore di carte simulato integrato, quindi puoi sviluppare e testare l’app senza connetterti all’hardware fisico. Se l’integrazione è completa o la stai ancora sviluppando, utilizza il lettore simulato per emulare tutti i flussi di Terminal nell’app.

Il lettore simulato non fornisce una interfaccia utente. Dopo aver effettuato la connessione nella tua app, la conferma del corretto funzionamento avviene quando le chiamate all’SDK o all’API di Stripe vanno a buon fine.

I lettori simulati per gli SDK simulano automaticamente la presentazione delle carte in base alle esigenze. Per l’integrazione basata su server, aggiorna l’integrazione per simulare la presentazione della carta.

Per utilizzare il lettore simulato, chiama discoverReaders per cercare i lettori, con l’opzione simulated impostata su true. Quando discoverReaders restituisce un risultato, chiama connectReader per connetterti al lettore simulato.

// 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);
    }
  }
}

Configurazione lettore simulato

Puoi configurare il lettore simulato per testare vari flussi nella tua applicazione POS, ad esempio circuiti carta diversi o scenari di errore come un addebito rifiutato. Per attivare questo comportamento, utilizza il codice seguente prima di acquisire il metodo di pagamento:

terminal.setSimulatorConfiguration({testCardNumber: '4242424242424242'});