Condividi tramite

Funzionalità PinPad (documentazione POS per .NET v1.14 SDK)

Un PIN Pad esegue funzioni di crittografia sotto il controllo di un sistema di gestione correlato. Alcuni oggetti servizio PinPad supportano più sistemi di gestione PIN Pad e alcuni di questi sistemi di gestione supportano più set di chiavi per diversi host transazioni EFT (Electronic Funds Transfer). Pertanto, per ogni transazione EFT, l'applicazione deve selezionare il sistema di gestione di PIN Pad e l'host delle transazioni EFT da usare.

Modello di programmazione

A seconda del sistema di gestione di PIN Pad, è necessario specificare uno o più parametri delle transazioni EFT a PIN Pad per l'uso nelle funzioni di crittografia. L'applicazione deve impostare il valore delle proprietà del parametro ALL EFT Transaction per consentire una migrazione più semplice agli host transazioni EFT che richiedono un sistema di gestione PIN Pad diverso.

  • Dopo l'apertura, la richiesta e l'abilitazione del controllo di PIN Pad, un'applicazione deve usare lo scenario generale seguente per ogni transazione EFT.
  • Impostare i parametri delle transazioni EFT (proprietà AccountNumber, Amount, MerchantID, TerminalID, Track1Data, Track2Data, Track3Data, Track4Data e TransactionType) e quindi chiamare il metodo BeginEftTransaction(PinPadSystem, Int32). Verrà inizializzato il dispositivo per eseguire le funzioni di crittografia per la transazione EFT.

Se la voce del PIN è OnFailure, chiamare il metodo EnablePinEntry(). Impostare quindi la proprietà DataEventEnabled e attendere l'evento DataEvent.

  • Se sono necessari codici di autenticazione dei messaggi, usare i metodi ComputeMac(String) e VerifyMac(String) in base alle esigenze.
  • Chiamare il metodo EndEftTransaction(EftTransactionCompletion) per notificare al dispositivo che tutte le operazioni per la transazione EFT sono state completate. Questa specifica supporta due modelli di utilizzo dello schermo. La proprietà CapDisplay indica uno dei modelli seguenti: - Un'applicazione ha il controllo completo del testo da visualizzare. Per questo modello, è presente un controllo LineDisplay associato utilizzato dall'applicazione per interagire con la visualizzazione. - Un'applicazione non può fornire il testo da visualizzare. Può invece selezionare solo da un elenco di messaggi predefiniti da visualizzare. Per questo modello è disponibile un set di proprietà di PIN Pad che vengono usate per controllare la visualizzazione.

Condivisione dei dispositivi

PIN Pad è un dispositivo esclusivo, pertanto:

  • L'applicazione deve richiedere il dispositivo prima di abilitarlo.
  • L'applicazione deve richiedere e abilitare il dispositivo prima che quest'ultimo inizi a leggere l'input o prima di chiamare i metodi che modificano il dispositivo.

Metodi ~Impl di Microsoft Point of Service per .NET (POS per .NET)

I metodi astratti protetti che terminano con il suffisso "Impl" vengono chiamati dalle rispettive controparti pubbliche POS per .NET. Ciò consente all'implementazione della classe Base di eseguire il controllo degli errori e dello stato appropriati prima e dopo la chiamata del metodo ~Impl. Questi metodi devono essere implementati nel codice dell'oggetto servizio, ma le controparti pubbliche non astratte devono essere sottoposte a override solo in casi speciali, ad esempio quando il codice dell'oggetto servizio deve rimuovere o modificare i test di convalida standard.

POS per eventi .NET

Un oggetto servizio PinPad può inviare gli eventi seguenti all'applicazione:

  • DataEvent
  • DirectIOEvent
  • StatusUpdateEvent
  • ErrorEvent

Vedi anche

Risorse aggiuntive