Fonctionnalités PinPad (documentation du SDK POS pour .NET v1.14)

Un pavé PIN effectue les fonctions de chiffrement sous le contrôle d’un système de gestion du pavé PIN. Certains objets de service PinPad prennent en charge plusieurs systèmes de gestion des pavés PIN et certains systèmes de gestion des pavés PIN prennent en charge plusieurs ensembles de clés pour différents hôtes de transaction de transfert de fonds électroniques (EFT). Par conséquent, pour chaque transaction EFT, l’application doit sélectionner le système de gestion du pavé PIN et l’hôte de transaction EFT à utiliser.

Modèle de programmation

En fonction du système de gestion du pavé PIN, un ou plusieurs paramètres de transaction EFT doivent être fournis au pavé PIN pour une utilisation dans les fonctions de chiffrement. L’application doit définir la valeur des propriétés du paramètre ALL EFT Transaction pour faciliter la migration vers les hôtes de transaction EFT qui nécessitent un autre système de gestion de pavé PIN.

• Après avoir ouvert, revendiqué et activé le contrôle du pavé PIN, une application doit utiliser le scénario général suivant pour chaque transaction EFT.
• Définir les paramètres de transaction EFT (propriétés AccountNumber, Amount, MerchantID, TerminalID, Track1Data, Track2Data, Track3Data, Track4Data et TransactionType), puis appeler la méthode BeginEftTransaction(PinPadSystem, Int32). Cela initialise l’appareil pour effectuer les fonctions de chiffrement pour la transaction EFT.

Si l’entrée de PIN est OnFailure, appelez la méthode EnablePinEntry(). Ensuite, définissez la propriété DataEventEnabled et attendez l’événement DataEvent.

• Si les codes d’authentification des messages sont requis, utilisez les méthodes ComputeMac(String) et VerifyMac(String) si nécessaire.
• Appelez la méthode EndEftTransaction(EftTransactionCompletion) pour informer l’appareil que toutes les opérations de la transaction EFT ont été effectuées. Cette spécification prend en charge deux modèles d’utilisation de l’affichage. La propriété CapDisplay indique l’un des modèles suivants : - Une application a le contrôle total du texte à afficher. Pour ce modèle, il existe un contrôle LineDisplay associé qui est utilisé par l’application pour interagir avec l’affichage. - Une application ne peut pas fournir le texte à afficher. Au lieu de cela, elle peut uniquement sélectionner parmi une liste de messages prédéfinis à afficher. Pour ce modèle, il existe un ensemble de propriétés de pavé PIN qui sont utilisées pour contrôler l’affichage.

Partage d’appareil

Le pavé PIN est un appareil à usage exclusif, par conséquent :

• L’application doit revendiquer l’appareil avant de l’activer.
• L’application doit revendiquer et activer l’appareil avant que l’appareil ne commence à lire l’entrée, ou avant d’appeler des méthodes qui manipulent l’appareil.

Méthodes ~Impl de Microsoft Point of Service pour .NET (POS pour .NET)

Les méthodes abstraites protégées qui se terminent par le suffixe « Impl » sont appelées à partir de leurs équivalents POS pour .NET. Cela permet à l’implémentation de la classe Base d’effectuer une vérification appropriée de l’état et des erreurs avant et après l’appel de la méthode ~Impl. Ces méthodes doivent être implémentées dans le code d’objet de service, mais les équivalents publics et non abstraits ne doivent être remplacés que dans des cas spéciaux, par exemple lorsque le code objet de service doit supprimer ou modifier les tests de validation standard.

Événements POS pour .NET

Un objet de service PinPad peut envoyer les événements suivants à l’application :

• DataEvent
• DirectIOEvent
• StatusUpdateEvent
• ErrorEvent

Voir aussi

Autres ressources

• Implémentation de PinPad