This document is the specification of the API dedicated to the integration of the Calypso Card Extension in a Keyple Application.

Overview

Use CalypsoExtensionService.getInstance() to retrieve the service instance and all the entry points provided by the extension:

• Creation of a selection case targeting a specific card to be provided to the Keyple Selection Service.
  CalypsoExtensionService.createCardSelection()
  A selection case targets a specific card defined by various parameters and possibly supplemented with commands to be executed after the selection (see methods of CalypsoCardSelection).
• Card transaction manager to perform non-secure operations with a card.
  CalypsoExtensionService.createCardTransactionWithoutSecurity(CardReader reader, CalypsoCard calypsoCard)
• Card transaction manager to perform secure operations with a card (Calypso Secure Session).
  CalypsoExtensionService.createCardTransaction(CardReader reader, CalypsoCard calypsoCard, CardSecuritySetting cardSecuritySetting)
  The CardSecuritySetting POJO is used to define the security elements of the transaction.

The card data collected at each step (selection, transaction) are stored in dedicated POJOs whose interfaces are available in the org.calypsonet.terminal.calypso.card package.

Packages

Package	Description
org.eclipse.keyple.card.calypso	Contains the factories and builders to create the public elements of the extension.